Microsoft Teams Bot Trigger icon

Microsoft Teams Bot Trigger

Receive incoming Bot Framework activities from Microsoft Teams

Microsoft Teams Bot Trigger

AI-generated

Summary

Trigger a workflow on specified Microsoft Teams Bot Framework activity events, processing incoming activities with optional deduplication, command parsing, and conversation reference storing, while controlling when and how to respond to Teams.

Inputs

  • Events (required) — Select one or more Microsoft Teams activity types (e.g., message, invoke, conversationUpdate) that will trigger the workflow.
  • Respond — Choose when to send an HTTP response to Teams after the trigger executes: immediately, using a Respond to Webhook node, or after the workflow finishes.
  • Response Data — When responding after workflow completion, specify which data to return: all entries, first entry's binary or JSON data, or no response body.
  • Options — Configure trigger behavior with options such as allowing unsigned requests (not for production), command definitions and prefix for parsing commands in messages, debug output inclusion, deduplication window and enabling deduplication, ignoring bot messages, including raw activity data in output, storing proactive conversation references with configurable key source and maximum stored references, validating key endorsements, and verifying request signatures.

Output shape

A single JSON output per trigger event

The output includes standardized activity details such as activity type, id, timestamp, text, channel/session details, and optionally raw Bot Framework activity. When command routing is enabled and a message matches a command pattern or prefix, structured command data is included. Proactive conversation references are available in output if storing is enabled. Duplicate and bot-originated activities are ignored. The HTTP response behavior depends on the Respond parameter selection.

Examples

Example 1: Trigger workflow on incoming Teams message activities, ignore bot messages, deduplicate events for 5 minutes, and respond immediately to Teams.

Events = [message]; Options = { ignoreBotMessages: true, deduplicateActivities: true, dedupeWindowSeconds: 300 }; Respond = Immediately; Response Data = default.

Links

Discussion