M365 Agent icon

M365 Agent

Send messages, cards, thread replies, and invoke responses through Microsoft 365 Agents (Teams / Copilot / WebChat).

Actions28

Thumbnail Card → Send

AI-generated

Summary

Sends a Microsoft Teams adaptive card (Thumbnail Card) to a conversation.

Inputs

  • authKind (required) — Authentication method: 'classicBot' for Azure Bot Service or 'agent365' for Entra Agent Identity.
  • conversationSource (required) — Source of conversation routing: 'envelope' uses the current item's reference, 'manual' requires Service URL, Conversation ID, and Channel ID.
  • serviceUrl — Bot Connector service URL (required only when conversationSource is manual).
  • conversationId — The Teams conversation ID (required only when conversationSource is manual).
  • channelId — Target channel (required only when conversationSource is manual). Defaults to 'msteams'.
  • activityId — Required only for Reply/Update/Delete; leave empty for proactive sends.
  • title (required) — Title text for the card.
  • subtitle — Subtitle text for the card.
  • text — Main body text for the card.
  • images — Collection of image objects (URL and alt text) with optional tap actions.
  • buttons — Collection of button objects (type, title, value) with optional tap actions.
  • options — Card-level options including fallback text, raw Activity override, and tap action.
  • identityMode — When using 'agent365', determines if the agent acts as its Blueprint identity ('autonomous') or as a specific M365 user ('agentUser').
  • agentUsername — UPN of the agent user (required when identityMode is 'agentUser' and userSelectorMode is 'byUpn').
  • agentUserId — Object ID of the agent user (required when identityMode is 'agentUser' and userSelectorMode is 'byObjectId').

Output shape

A single item containing the sent Adaptive Card in the 'data' field.

The node outputs the result of the Microsoft Bot Framework API call.

Examples

Example 1: Reply to a Teams message using the current item's conversation context.

Set Conversation Source to 'From Envelope', fill Title and Text.

Example 2: Proactively send a card to a specific Teams channel.

Set Conversation Source to 'Specify Manually', provide Service URL, Conversation ID, and Channel ID.

Example 3: Send a card on behalf of an agent user using Entra Agent Identity.

Set Auth Kind to 'Agent 365', Identity Mode to 'Agent User Account', and provide Agent Username or Object ID.

Links

Discussion