Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Adaptive Card → Send Adaptive Card

AI-generated

Summary

Send an Adaptive Card message to a specified Microsoft Teams conversation using the Bot Framework API.

Inputs

  • Service URL (required) — Bot Framework service URL, usually obtained from a trigger node output.
  • Conversation ID (required) — ID of the Teams conversation to send the adaptive card to, typically from a trigger output.
  • Adaptive Card JSON (required) — JSON string representing the Adaptive Card content object to send.
  • Message Text — Optional text message to accompany the adaptive card.
  • Mention Options — Options to mention a user in the message, including auto-mention sender, mention ID, mention name, and whether to prepend mention text.
  • Execution Options — Options controlling execution behavior such as debug output inclusion, output mode shaping (pass through, merge, or response only), and retry parameters for API requests (retry count and delay in milliseconds).

Output shape

a modified item JSON containing details of the Teams Bot API request and response

The output shape depends on the chosen Output Mode in Execution Options: 'Pass Through' appends Teams Bot fields to the original item JSON; 'Merge' merges the original JSON with Teams Bot output fields; 'Response Only' returns only the Teams Bot output fields. If Debug Output is enabled, additional metadata about retry attempts and internal state is included. Errors during execution will appear as node errors unless 'Continue On Fail' is enabled, in which case error details are appended to output items.

Examples

Example 1: Send a prepared Adaptive Card to a conversation identified by its conversation ID and service URL from a preceding trigger.

Required parameters 'Service URL', 'Conversation ID', and 'Adaptive Card JSON' set to send the adaptive card. Optional 'Message Text' can be included to add accompanying text. Enable 'Mention Options' to mention a specific user in the card message if needed. Execution options can customize retries and output handling.

Links

Discussion