Skip to main content

Microsoft Teams

Messaging and sheets

The Microsoft Teams connector posts messages to a Teams channel through an incoming webhook. Each message is sent as an Adaptive Card.

When to use it​

  • A run posts into a Microsoft Teams channel.
  • Your organisation uses Teams and wants run alerts in one place.
  • The Human Approval node asks for its decision in Teams.

This connector sends messages only.

What you need​

  • An incoming webhook URL for the target channel. In Microsoft Teams, add an incoming webhook to the channel and copy its URL. See Microsoft's incoming webhook guide.

Connect​

The connection form lists its steps on the left. Open any step from that list. The Environments step holds the values that differ per environment.

Test connection is in the form footer. Beside it, Test against picks Base, the connection as saved, or an environment, whose values are applied first.

FieldStepWhat to enter
Incoming Webhook URLAuthenticationThe webhook URL. Required. Stored encrypted.
Default Card Title (Optional)OptionsA bold header on every card, such as DataLug alert.

Supported operations​

Post Message on a Notification node. The action sets the Notification type, the Card title and the Message. A blank card title uses the connection default.

The message is a template. It takes the same placeholders as an email, such as {{sys.execution.id}}, {{vars.exec.myKey}} and {{sample.firstRow.field}}. The rendered text is placed in an Adaptive Card text block, under the title when one is set.

Limits​

  • Messages through one connection to one channel are sent at most one per second. Extra messages wait their turn.
  • A webhook posts only to the channel it was created for. Use one connection per channel.
  • Bot identities and card actions with response callbacks are not supported.

Troubleshooting​

  • Test connection passes but nothing arrives. The webhook belongs to a different channel, or was removed from the channel. Create a webhook on the target channel and replace the URL.
  • The webhook URL stops working. The webhook was deleted or disabled in Teams. Create a new one and replace the URL on the connection.
  • The message is sent but looks wrong. Build it with a Message node first and preview it there. The connector sends what it is given.