| page_type | description | products | languages | extensions | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
sample |
Samples to create "Custom Bots" to be used in Microsoft Teams. |
|
|
|
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.
-
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 8080and 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
sharedSecretinapp.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:
- If you type anything else apart from above mentioned type, it will echo back what you typed.
Example screenshot to show Echo message:
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.