Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Activity → Update Activity

AI-generated

Summary

Update an existing activity in a Microsoft Teams conversation by providing its Service URL, Conversation ID, and Activity ID, along with optional updated content or raw activity JSON.

Inputs

  • Service URL (required) — The Bot Framework service URL for the Teams conversation, typically obtained from trigger output.
  • Conversation ID (required) — The ID of the conversation where the activity exists, generally from trigger output.
  • Activity ID (required) — The ID of the specific activity to update.
  • Activity Type — The type of activity being updated, with options like Message, Event, Typing, or End Of Conversation; defaults to Message.
  • Message Text — The textual content to update the activity with; ignored if Activity JSON is provided.
  • Activity JSON — Raw JSON string representing the entire activity payload; if provided, overrides other content fields.
  • Mention Options — Optional settings to mention a user in the message, including auto mention of sender, mention ID, mention name, and whether to prepend mention text.
  • Activity Additional Fields — Additional optional JSON-formatted fields such as attachments, channel data, entities (e.g., mentions), suggested actions, and text format (Markdown, Plain, XML/HTML).
  • Execution Options — Options controlling debug output inclusion, output formatting mode (pass through, merge, or response only), and retry behavior on failed API requests.

Output shape

a single JSON object containing details of the update request and its response from the Microsoft Bot Framework API

The output JSON includes the original input item JSON augmented with fields like 'teamsBotResponse' holding the API response, metadata about the request, and optionally debug information if enabled via execution options. Error handling supports continuation on failure.

Examples

Example 1: Updating a message in a conversation to change its text content

Provide Service URL, Conversation ID, Activity ID of the message to update; set Activity Type to 'message'; enter new Message Text; optionally configure mention options or additional fields; execute node with retry settings as needed.

Links

Discussion