Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Conversation → Get Conversation Details

AI-generated

Summary

Retrieve detailed information about a specific conversation in Microsoft Teams using its conversation ID and the Bot Framework service URL.

Inputs

  • Service URL (required) — The Bot Framework service URL, typically obtained from a trigger node's output, used to direct the API request.
  • Conversation ID (required) — The unique identifier of the conversation to retrieve details for, typically from trigger output.
  • Execution Options — Optional parameters including debug output toggle, output mode to shape the result data, and retry settings for API request failures.

Output shape

A single JSON object containing the details of the specified conversation, including the HTTP method and request path used.

The node performs a GET request to /v3/conversations/{conversationId} at the specified service URL. Output structure can be modified by Execution Options: 'passThrough' appends Teams Bot response fields to the input JSON, 'merge' merges input and output JSON, and 'responseOnly' returns only Teams Bot response fields. The operation retries API calls based on configured retry count and delay.

Examples

Example 1: Use this operation to fetch metadata or configuration details about an existing Microsoft Teams conversation by providing its ID and service URL, useful for workflows needing context about the conversation state or properties prior to further interactions.

Fill in the 'Service URL' with the current Bot Framework URL from trigger data, set the 'Conversation ID' of the target conversation, and optionally adjust execution options for output formatting and retry handling.

Links

Discussion