Post to Microsoft Teams

On the Team plan and above, an admin adds a Teams channel and chooses what wrkflow posts as a card: when a survey is first published (later Publish changes aren’t announced), a daily digest of live surveys after 09:00 in your organization’s time zone, and, if you choose, each new response. Editors can also post a survey’s link from its Share page.

Before you start

• Permission to add a workflow to the Teams channel.
• wrkflow doesn’t use OAuth and can’t read anything in Teams. It only needs the URL of a Workflows webhook for one channel.

Set up

1. 1In the Teams channel, open Workflows and choose Send webhook alerts to a channel. Finish the template and copy the URL it gives you.
2. 2Open Integrations, then Microsoft Teams, and choose Add channel. Name it, paste the URL and choose what to post.
3. 3Choose Send test and check that the card arrives in the channel.

What leaves wrkflow

• Counts and rates only: the survey’s title, how many responses it has, how many are new, and how many invited people have responded as “n of N”, with a link to the results. Never answers.
• A post about one new response to a named survey’s personal link may name that respondent. Anonymous surveys are never named.
• Posting a survey’s link from its Share page sends the public link, the note the member typed (up to 500 characters) and the member’s name or email.
• The webhook URL is a secret. The page shows only its host and last characters. Replace URL swaps it for a new one.

If something goes wrong

• Teams responded 400: the workflow expects a different message. Recreate it from the Send webhook alerts to a channel template and choose Replace URL.
• Teams responded 404: the workflow was turned off or deleted. Turn it on again, or create a new one and choose Replace URL.
• The channel didn’t answer within 10 seconds: Teams was slow, and the post is retried automatically.

Recent posts on the Teams page show each post and its outcome. See Integrations for the statuses and how to ask support.