Microsoft Teams

Capture messages from a Microsoft Teams channel.

What you will need

  • Security token

Steps

In FeedbackFlow, open your project, go to Integrations, and select Microsoft Teams. Then:

  1. 1

    In Teams, open the channel menu → Connectors → Outgoing Webhook, and create one.

  2. 2

    Set the callback URL to:

    https://www.usefeedbackflow.com/api/ingest/teams/YOUR_PROJECT_ID
  3. 3

    Copy the security token Teams shows you into FeedbackFlow. Mention the webhook in a message to send it: the @mention is stripped before triage.

Replace YOUR_PROJECT_ID with the ID of your project, shown on the integration setup screen.

What gets captured from Microsoft Teams

Messages sent to the outgoing webhook, which in Teams means messages that @mention it. The bot’s own mention is stripped from the front of the text before triage, so items do not all cluster on the bot’s name.

Check that it worked

  1. Teams shows the HMAC secret once, when you create the outgoing webhook. Paste it into FeedbackFlow before sending anything.
  2. @mention the webhook in a channel message.
  3. The message arrives with the mention stripped and the sender’s name attached.

If it is not working

Deliveries return 401
Teams signs with the base64 secret it issued for that webhook, sent in the authorization header prefixed HMAC. A secret copied with surrounding whitespace, or regenerated in Teams, will not verify.
Ordinary channel messages never arrive
Teams only calls an outgoing webhook when it is @mentioned. There is no way to subscribe to all channel traffic through this mechanism.
Every item starts with the bot name
That is what the mention stripping prevents, so seeing it means the mention was formatted in a way the strip did not match. Put the mention at the start of the message.

Still stuck? Widget and integration troubleshooting covers the problems that are not specific to Microsoft Teams.

Open the Microsoft Teams docs