Microsoft Teams Integration

Use the msteams integration to send messages with a message step or to prompt for user input in an input step.

integration "msteams" "general_channel" {
webhook_url = "https://example-corp.webhook.office.com/webhook2b/..."
}

Arguments

ArgumentTypeOptional?Description
webhook_url StringRequiredA webhook url to post to a Microsoft Teams channel. Note that a webhook is tied to a specific channel; if you specify a channel in the step options it will be ignored.
titleStringOptionalDisplay title for the integration.

Examples

Example: Microsoft Teams integration with webhook URL

Note: webhook URL is tied to a specific channel; if you specify a channel in the step options it will be ignored.

integration "msteams" "general_channel" {
webhook_url = "https://example.webhook.office.com/webhook2b/aa24647a-xxxx-xxxx-xxxx-89b9xxxx29a0@a475991c-xxxx-xxxx-xxxx-38bbxxxxeb78/IncomingWebhook/92xxxx7ae8xxxx71a0xxxxa9axxxx31e/221809dc-xxxx-xxxx-xxxx-d629xxxx738c"
}

Obtaining a Webhook URL

Note: Webhook URLs allow unauthenticated messages to be sent to the attached channel and should be treated as secrets.

  1. Navigate within Microsoft Teams to the channel you wish to obtain a webhook URL for.
  2. Click ... next to the channel name in the side menu.
  3. Select Manage Channel from the drop-down menu.
  4. Under Connectors click on the Edit button.
  5. Locate Incoming Webhook in the list and click the Add button.
  6. Provide a name for the webhook (Optional provide an avatar image for the webhook) & click the Create button.
  7. Copy the generated URL as this will be the webhook_url