Skip to content

Latest commit

 

History

History
70 lines (48 loc) · 3.14 KB

README.md

File metadata and controls

70 lines (48 loc) · 3.14 KB
Raw
page_type description products languages extensions
sample
Samples to create "Custom Bots" to be used in Microsoft Teams.
office-teams
office
office-365
javascript
contentType createdDate
samples
12/5/2017 6:03:13 PM

Outgoing webhook

This project is an implementation of a very simple Outgoing Webhook for Microsoft Teams. All it does is verify that what's sending messages matches the Outgoing Webhook that was created in Teams, and it echoes back whatever is sent to it.

Steps to run locally

Prerequisites

  • Install Git for windows: https://git-for-windows.github.io/

  • Clone this repo:

    git clone https://github.com/OfficeDev/msteams-samples-outgoing-webhook-nodejs.git

  • Install Node: https://nodejs.org/en/download/

  • Install a tunnelling service. These instructions assume you are using ngrok: https://ngrok.com/

  • Start the tunneling service, e.g. ngrok http 8080 and copy the https:// URL it generates to the clipboard, e.g. https://2fb7b5e8.ngrok.io

  • Create the Outgoing Webhook in Teams using the instructions here. Paste the tunneling service URL from the previous step into the "Callback URL" box. After you press the Create button, copy/paste the security token that Teams generates to the clipboard.

  • Paste the security token generated by Teams as the value of sharedSecret in app.js. When you're done, it should look something like this:

    const sharedSecret = "+ZaRRMC8+mpnfGaGsBOmkIFt98bttL5YQRq3p2tXgcE=";

  • In the directory in which you installed this project, type node app.js

  • In Microsoft Teams, in any channel in the team in which you created the Outgoing Webhook, you can type @<botname> <card-type> then it will respond back a card with specified card type.

    Supported : "adaptive-card", "hero-card", "list-card", "o365-card", "thumbnail-card"

Example screenshot to show Hero card: Hero card

  • If you type anything else apart from above mentioned type, it will echo back what you typed.

Example screenshot to show Echo message: Echo message

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.