M365 AgentInstall

Summary

Update an Adaptive Card message in a conversation

Inputs

• authKind (required) — Authentication method for the Bot Framework. Choose Classic Bot (Azure Bot Service) or Agent 365 (Entra Agent Identity).
• conversationSource (required) — Where to get the conversation reference: From Envelope (use data from the incoming item) or Specify Manually (fill in Service URL, Conversation ID, Channel ID, and optionally Activity ID).
• serviceUrl — Bot Connector service URL for the target channel (required when Conversation Source is Specify Manually).
• conversationId — The conversation ID (required when Conversation Source is Specify Manually).
• channelId — Azure Bot Service channel the conversation belongs to (required when Conversation Source is Specify Manually). Options: Direct Line, Emulator, Microsoft 365 Copilot, Microsoft Teams, Web Chat.
• activityId — Activity ID of the message to update (required only when updating an existing activity; leave empty for proactive sends).
• cardTemplate (required) — Adaptive Card JSON template with ${field} placeholders. The template is merged with Binding Data to produce the final card.
• bindingData — Object used to expand ${field} placeholders in the card template. Defaults to the whole incoming item ($json).
• options — Additional options for the update operation.
• options.fallbackText — Text shown by clients that cannot render Adaptive Cards.
• options.rawActivityOverride — Optional raw JSON to replace the constructed Activity body. Must parse to a JSON object; empty means use the constructed activity.
• identityMode — When using Agent 365 authentication, whether the agent acts as its Blueprint app identity (Autonomous) or as its own M365 user (Agent User Account).
• userSelectorMode — For Agent User Account mode, how to specify the agentic user: by UPN or by Object ID.
• agentUsername — UPN of the agentic user (used when Identity Mode is Agent User Account and User Selector Mode is By UPN). Defaults to the credential's Default Agent Username.
• agentUserId — Object ID of the agentic user (used when Identity Mode is Agent User Account and User Selector Mode is By Object ID).
• agentUserNotice — Notice that Agent User Account mode requires a separate license (E5 + Teams Enterprise + Agent 365) on the agentic user account.

Output shape

object

The operation returns the input item enriched with the result of the update request, typically containing the activity ID and any response from the Bot Framework.

Examples

Example 1: Update an Adaptive Card posted earlier in a Teams chat

Set Authentication Kind to Classic Bot, Conversation Source to From Envelope (assuming the incoming item contains conversationReference), provide a Card Template with placeholders like ${title} and ${body}, keep Binding Data as {{$json}} to use the item's fields, leave Options empty.

Links

• n8n community nodes installation guide