Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Conversation → Create Direct Conversation

AI-generated

Summary

Create a new direct (one-on-one) conversation between the bot and a specified Teams user by providing the Bot ID, the target member's Teams user ID, and the Bot Framework service URL.

Inputs

  • Service URL (required) — The Bot Framework service URL, typically obtained from a trigger node's output.
  • Bot ID (required) — The identity ID of the bot participating in the direct conversation.
  • Target Member ID (required) — The Teams user ID of the member with whom the direct conversation will be created.
  • Tenant ID — Optional Microsoft Teams tenant ID for channel data, relevant in multi-tenant scenarios.
  • Execution Options — Optional execution settings such as debug output, output shaping mode, retry count, and retry delay between attempts for API requests.

Output shape

a JSON object representing the newly created direct conversation, including the API response and metadata about the request method and path.

By default, the node appends the conversation details to the incoming item JSON under 'teamsBotResponse' and includes metadata under 'teamsBotMeta'. The output mode can be adjusted to pass through, merge, or return response only. Retries for failed API calls are configurable via execution options.

Links

Discussion