Flowly
Log inDownload
Docs/Channels/Microsoft Teams
Channels

Microsoft Teams

Send agent output to a Microsoft Teams channel via an Incoming Webhook connector. This channel is outbound only β€” the agent can post to Teams, but Teams messages do not flow back into the agent.

Outbound-only

The current Teams integration (Faz 1) is one-way: the bot posts to a Teams channel through an Incoming Webhook URL. There is no inbound path β€” you cannot message the agent from Teams. It is suited to notifications, cron output, alerts, and daily summaries. Bidirectional support (Bot Framework + Graph API) is deferred to a future phase.

Requirements

  • An Incoming Webhook connector created in the target Teams channel; the resulting HTTPS URL is the credential.

Configuration

Set under channels.teams in ~/.flowly/config.json:

{
  "channels": {
    "teams": {
      "enabled": true,
      "webhookUrl": "https://outlook.office.com/webhook/...",
      "defaultChatLabel": "",
      "allowFrom": []
    }
  }
}
KeyTypeDefaultDescription
enabledboolfalseStart the Teams adapter at gateway boot.
webhookUrlstring""Teams Incoming Webhook URL. Must start with https://. The URL itself is the secret.
defaultChatLabelstring""Human-friendly label for the target channel.
allowFromstring[][]Reserved for future inbound support; unused now.

Connect method

The adapter posts {"text": "..."} to webhookUrl. Plain text / Teams-rendered markdown is supported; HTTP(S) media URLs are appended under an Attachments list. It retries once on 5xx/network errors and skips empty bodies (a Teams webhook rejects empty payloads). webhookUrl must start with https://, or the channel disables itself with a warning. One webhook targets exactly one channel.

Setup steps

  1. In the target Teams channel, add an Incoming Webhook connector and copy the generated HTTPS URL.
  2. Set channels.teams.enabled to true and paste the URL into webhookUrl.
  3. Optionally set defaultChatLabel.
  4. Start the gateway: flowly gateway.

Pair this with Cron to push scheduled summaries to Teams.