M365 AgentInstall

Summary

Reply in Thread sends a message as a reply within an existing conversation thread.

Inputs

• authKind — Authentication method (Classic Bot or Agent 365).
• conversationSource — Source of conversation routing (From Envelope or Specify Manually).
• serviceUrl (required) — Bot Connector service URL (e.g., https://smba.trafficmanager.net/emea/).
• conversationId (required) — Conversation identifier; for Teams looks like 19:…@thread.tacv2.
• channelId — Channel type (e.g., msteams, directline).
• activityId — Identifier of the specific activity (used for Reply/Update/Delete).
• text (required) — Message content; can include placeholders and @mentions.
• parentActivityId (required) — ID of the parent activity that started the thread.
• options — Additional message options such as footer, mentions, suggested actions, and recipient override.
• identityMode — Identity resolution mode (autonomous or agentUser).
• userSelectorMode — Method to select the agent user (by UPN or by Object ID).
• agentUsername — UPN of the agentic user (default from credentials).
• agentUserId — Object ID of the agentic user.
• options.workflowFooter — Append a footer marker to the message.
• options.mentions — Add @mentions; each mention includes type and user ID/name.
• options.suggestedActions — Add suggested action chips with title, value, and display text.
• options.to — Override recipient list for proactive messages.

Output shape

The operation returns a JSON object representing the sent activity (e.g., containing the activity ID and status).

May include optional fields; on error an error envelope is returned.

Examples

Example 1: Send a reply to a Teams thread using default authentication.

authKind=classicBot; conversationSource=envelope; conversationId=19:xxx@thread.tacv2; text=Hello {{ $json.userName }}; options={mentions=[{type:user,id=...,name='Alice'}]}

Example 2: Proactive message to a specific user in a thread using Agent 365 identity.

authKind=agent365; identityMode=agentUser; userSelectorMode=byUpn; agentUsername=agent@contoso.com; conversationSource=manual; conversationId=19:yyy@thread.tacv2; text=Proactive update; options={to=[userId], mentions=[{type:user,id=...,name='Bob'}]}

Example 3: Update an existing message in a thread and add a suggested action chip.

authKind=classicBot; conversationSource=manual; serviceUrl=https://smba.trafficmanager.net/emea/; conversationId=19:zzz@thread.tacv2; activityId=1673348720590; text=Updated message; options={suggestedActions=[{type:messageBack,title:'Approve',value:'approve'}]}, identityMode=autonomous

Links

• n8n community nodes installation guide