v1

latestSwagger 2.0The MIT License (MIT)2026-07-17126899.0 KB
Conversations

CreateConversation

Create a new Conversation.

POST to this method with a

  • Bot being the bot creating the conversation
  • IsGroup set to true if this is not a direct message (default is false)
  • Members array contining the members you want to have be in the conversation.

The return value is a ResourceResponse which contains a conversation id which is suitable for use in the message payload and REST API uris.

Most channels only support the semantics of bots initiating a direct message conversation. An example of how to do that would be:

var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } );
await connect.Conversations.SendToConversationAsync(resource.Id, new Activity() ... ) ;

post/v3/conversations

Request body

isGroupboolean

IsGroup

topicNamestring

(Optional) Topic of the conversation (if supported by the channel)

channelDataobject

Channel specific payload for creating the conversation

Response

An object will be returned containing

  • the ID for the conversation
  • ActivityId for the activity if provided. If ActivityId is null then the channel doesn't support returning resource id's for activity.
activityIdstring

ID of the Activity (if sent)

serviceUrlstring

Service endpoint where operations concerning the conversation may be performed

idstring

Id of the resource