ConversationClient class

Package:

@microsoft/teams.api

Constructors

ConversationClient(string, Client | ClientOptions, Partial<ApiClientSettings>)

Properties

http
serviceUrl

Methods

activities(string)
addReaction(string, string, MessageReactionType)	Add a reaction to an activity in a conversation.
create(CreateConversationParams)
createActivity(string, ActivityParams)
createActivity(string, DeprecatedInputActivity)
createTargetedActivity(string, ActivityParams)
createTargetedActivity(string, DeprecatedInputActivity)
deleteActivity(string, string)	Delete an activity in a conversation.
deleteReaction(string, string, MessageReactionType)	Delete a reaction from an activity in a conversation.
deleteTargetedActivity(string, string)	Delete a targeted activity in a conversation.
get(GetConversationsParams)
getActivityMembers(string, string)	Get the members of an activity in a conversation.
getMemberById(string, string)	Get a member of a conversation by id.
getMembers(string)	Get the members of a conversation.
getPagedMembers(string, number, string)	Get paged members of a conversation.
members(string)
replyToActivity(string, string, ActivityParams)
replyToActivity(string, string, DeprecatedInputActivity)
updateActivity(string, string, ActivityParams)
updateActivity(string, string, DeprecatedInputActivity)
updateTargetedActivity(string, string, ActivityParams)
updateTargetedActivity(string, string, DeprecatedInputActivity)

Constructor Details

ConversationClient(string, Client | ClientOptions, Partial<ApiClientSettings>)

new ConversationClient(serviceUrl: string, options?: Client | ClientOptions, apiClientSettings?: Partial<ApiClientSettings>)

Parameters

serviceUrl

string

options

Client | ClientOptions

apiClientSettings

Partial<ApiClientSettings>

Property Details

http

Client http

Property Value

Client

serviceUrl

serviceUrl: string

Property Value

string

Method Details

activities(string)

Warning

This API is now deprecated.

Use the flattened activity methods on ConversationClient instead (e.g. conversations.createActivity(conversationId, ...)). This grouped accessor will be removed in a future release.

function activities(conversationId: string): IConversationActivityOperations

Parameters

conversationId

string

Returns

IConversationActivityOperations

addReaction(string, string, MessageReactionType)

Add a reaction to an activity in a conversation.

function addReaction(conversationId: string, activityId: string, reactionType: MessageReactionType): Promise<void>

Parameters

conversationId

string

activityId

string

reactionType

MessageReactionType

Returns

Promise<void>

create(CreateConversationParams)

function create(params: CreateConversationParams): Promise<ConversationResource>

Parameters

params

CreateConversationParams

Returns

Promise<ConversationResource>

createActivity(string, ActivityParams)

function createActivity(conversationId: string, params: ActivityParams): Promise<Resource>

Parameters

conversationId

string

params

ActivityParams

Returns

Promise<Resource>

createActivity(string, DeprecatedInputActivity)

Warning

This API is now deprecated.

Use MessageActivityInput or TypingActivityInput instead.

function createActivity(conversationId: string, params: DeprecatedInputActivity): Promise<Resource>

Parameters

conversationId

string

params

DeprecatedInputActivity

Returns

Promise<Resource>

createTargetedActivity(string, ActivityParams)

function createTargetedActivity(conversationId: string, params: ActivityParams): Promise<Resource>

Parameters

conversationId

string

params

ActivityParams

Returns

Promise<Resource>

createTargetedActivity(string, DeprecatedInputActivity)

Warning

This API is now deprecated.

Use MessageActivityInput or TypingActivityInput instead.

function createTargetedActivity(conversationId: string, params: DeprecatedInputActivity): Promise<Resource>

Parameters

conversationId

string

params

DeprecatedInputActivity

Returns

Promise<Resource>

deleteActivity(string, string)

Delete an activity in a conversation.

function deleteActivity(conversationId: string, id: string): Promise<void>

Parameters

conversationId

string

id

string

Returns

Promise<void>

deleteReaction(string, string, MessageReactionType)

Delete a reaction from an activity in a conversation.

function deleteReaction(conversationId: string, activityId: string, reactionType: MessageReactionType): Promise<void>

Parameters

conversationId

string

activityId

string

reactionType

MessageReactionType

Returns

Promise<void>

deleteTargetedActivity(string, string)

Delete a targeted activity in a conversation.

function deleteTargetedActivity(conversationId: string, id: string): Promise<void>

Parameters

conversationId

string

id

string

Returns

Promise<void>

get(GetConversationsParams)

Warning

This API is now deprecated.

This will be removed by end of summer 2026.

function get(params: GetConversationsParams): Promise<GetConversationsResponse>

Parameters

params

GetConversationsParams

Returns

Promise<GetConversationsResponse>

getActivityMembers(string, string)

Get the members of an activity in a conversation.

function getActivityMembers(conversationId: string, id: string): Promise<TeamsChannelAccount<any>[]>

Parameters

conversationId

string

id

string

Returns

Promise<TeamsChannelAccount<any>[]>

getMemberById(string, string)

Get a member of a conversation by id.

function getMemberById(conversationId: string, id: string): Promise<TeamsChannelAccount<any>>

Parameters

conversationId

string

id

string

Returns

Promise<TeamsChannelAccount<any>>

getMembers(string)

Get the members of a conversation.

function getMembers(conversationId: string): Promise<TeamsChannelAccount<any>[]>

Parameters

conversationId

string

Returns

Promise<TeamsChannelAccount<any>[]>

getPagedMembers(string, number, string)

Get paged members of a conversation.

function getPagedMembers(conversationId: string, pageSize?: number, continuationToken?: string): Promise<PagedMembersResult>

Parameters

conversationId

string

pageSize

number

continuationToken

string

Returns

Promise<PagedMembersResult>

members(string)

Warning

This API is now deprecated.

Use the flattened member methods on ConversationClient instead (e.g. conversations.getMembers(conversationId)). This grouped accessor will be removed in a future release.

function members(conversationId: string): { delete: (id: string) => Promise<void>, get: () => Promise<TeamsChannelAccount<any>[]>, getById: (id: string) => Promise<TeamsChannelAccount<any>>, getPaged: (pageSize?: number, continuationToken?: string) => Promise<PagedMembersResult> }

Parameters

conversationId

string

Returns

{ delete: (id: string) => Promise<void>, get: () => Promise<TeamsChannelAccount<any>[]>, getById: (id: string) => Promise<TeamsChannelAccount<any>>, getPaged: (pageSize?: number, continuationToken?: string) => Promise<PagedMembersResult> }

replyToActivity(string, string, ActivityParams)

function replyToActivity(conversationId: string, id: string, params: ActivityParams): Promise<Resource>

Parameters

conversationId

string

id

string

params

ActivityParams

Returns

Promise<Resource>

replyToActivity(string, string, DeprecatedInputActivity)

Warning

This API is now deprecated.

Use MessageActivityInput or TypingActivityInput instead.

function replyToActivity(conversationId: string, id: string, params: DeprecatedInputActivity): Promise<Resource>

Parameters

conversationId

string

id

string

params

DeprecatedInputActivity

Returns

Promise<Resource>

updateActivity(string, string, ActivityParams)

function updateActivity(conversationId: string, id: string, params: ActivityParams): Promise<Resource>

Parameters

conversationId

string

id

string

params

ActivityParams

Returns

Promise<Resource>

updateActivity(string, string, DeprecatedInputActivity)

Warning

This API is now deprecated.

Use MessageActivityInput or TypingActivityInput instead.

function updateActivity(conversationId: string, id: string, params: DeprecatedInputActivity): Promise<Resource>

Parameters

conversationId

string

id

string

params

DeprecatedInputActivity

Returns

Promise<Resource>

updateTargetedActivity(string, string, ActivityParams)

function updateTargetedActivity(conversationId: string, id: string, params: ActivityParams): Promise<Resource>

Parameters

conversationId

string

id

string

params

ActivityParams

Returns

Promise<Resource>

updateTargetedActivity(string, string, DeprecatedInputActivity)

Warning

This API is now deprecated.

Use MessageActivityInput or TypingActivityInput instead.

function updateTargetedActivity(conversationId: string, id: string, params: DeprecatedInputActivity): Promise<Resource>

Parameters

conversationId

string

id

string

params

DeprecatedInputActivity

Returns

Promise<Resource>