ChatClient | @azure/communication-chat

The client to do chat operations

Hierarchy

ChatClient

Index

Constructors

constructor

Methods

Constructors

constructor

new ChatClient(url: string, credential: CommunicationUserCredential, options?: ChatClientOptions): ChatClient

- Defined in chatClient.ts:58
Creates an instance of the ChatClient for a given resource and user.

Parameters
- url: string
  
  The url of the Communication Services resouce.
- credential: CommunicationUserCredential
  
  The user credential. Use AzureCommunicationUserCredential from @azure/communication-common to create a credential.
- Default value options: ChatClientOptions = {}
  
  Additional client options.
Returns ChatClient

Methods

createChatThread

createChatThread(request: CreateChatThreadRequest, options?: CreateChatThreadOptions): Promise<ChatThreadClient>

- Defined in chatClient.ts:119
Creates a chat thread. Returns thread client with the id of the created thread.

Parameters
- request: CreateChatThreadRequest
  
  Request for creating a chat thread.
- Default value options: CreateChatThreadOptions = {}
  
  Operation options.
Returns Promise<ChatThreadClient>

deleteChatThread

deleteChatThread(threadId: string, options?: DeleteChatThreadOptions): Promise<OperationResponse>

- Defined in chatClient.ts:255
Deletes a chat thread.

Parameters
- threadId: string
  
  The ID of the thread to delete.
- Default value options: DeleteChatThreadOptions = {}
  
  Operation options.
Returns Promise<OperationResponse>

getChatThread

getChatThread(threadId: string, options?: GetChatThreadOptions): Promise<GetChatThreadResponse>

- Defined in chatClient.ts:159
Gets a chat thread. Returns the chat thread.

Parameters
- threadId: string
  
  The ID of the thread to get.
- Default value options: GetChatThreadOptions = {}
  
  Operation options.
Returns Promise<GetChatThreadResponse>

getChatThreadClient

getChatThreadClient(threadId: string): Promise<ChatThreadClient>

- Defined in chatClient.ts:109
Returns ChatThreadClient with the specific thread id.

Parameters
- threadId: string
  
  Thread ID for the ChatThreadClient
Returns Promise<ChatThreadClient>

listChatThreads

listChatThreads(options?: ListChatThreadsOptions): PagedAsyncIterableIterator<ChatThreadInfo>

- Defined in chatClient.ts:222
Gets the list of chat threads of a user.

Parameters
- Default value options: ListChatThreadsOptions = {}
  
  List chat threads options.
Returns PagedAsyncIterableIterator<ChatThreadInfo>

off

off(event: "chatMessageReceived", listener: (e: ChatMessageReceivedEvent) => void): void
off(event: "chatMessageEdited", listener: (e: ChatMessageEditedEvent) => void): void
off(event: "chatMessageDeleted", listener: (e: ChatMessageDeletedEvent) => void): void
off(event: "typingIndicatorReceived", listener: (e: TypingIndicatorReceivedEvent) => void): void
off(event: "readReceiptReceived", listener: (e: ReadReceiptReceivedEvent) => void): void

- Defined in chatClient.ts:371
Unsubscribe from chatMessageReceived.

Parameters
- event: "chatMessageReceived"
  
  The ChatMessageReceivedEvent.
- listener: (e: ChatMessageReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageReceivedEvent): void
    - Parameters
      - e: ChatMessageReceivedEvent
      Returns void
Returns void
- Defined in chatClient.ts:378
Unsubscribe from chatMessageEdited.

Parameters
- event: "chatMessageEdited"
  
  The ChatMessageEditedEvent.
- listener: (e: ChatMessageEditedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageEditedEvent): void
    - Parameters
      - e: ChatMessageEditedEvent
      Returns void
Returns void
- Defined in chatClient.ts:385
Unsubscribe from chatMessageDeleted.

Parameters
- event: "chatMessageDeleted"
  
  The ChatMessageDeletedEvent.
- listener: (e: ChatMessageDeletedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageDeletedEvent): void
    - Parameters
      - e: ChatMessageDeletedEvent
      Returns void
Returns void
- Defined in chatClient.ts:392
Unsubscribe from typingIndicatorReceived.

Parameters
- event: "typingIndicatorReceived"
  
  The TypingIndicatorReceivedEvent.
- listener: (e: TypingIndicatorReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: TypingIndicatorReceivedEvent): void
    - Parameters
      - e: TypingIndicatorReceivedEvent
      Returns void
Returns void
- Defined in chatClient.ts:402
Unsubscribe from readReceiptReceived.

Parameters
- event: "readReceiptReceived"
  
  The ReadReceiptReceivedEvent.
- listener: (e: ReadReceiptReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: ReadReceiptReceivedEvent): void
    - Parameters
      - e: ReadReceiptReceivedEvent
      Returns void
Returns void

on

on(event: "chatMessageReceived", listener: (e: ChatMessageReceivedEvent) => void): void
on(event: "chatMessageEdited", listener: (e: ChatMessageEditedEvent) => void): void
on(event: "chatMessageDeleted", listener: (e: ChatMessageDeletedEvent) => void): void
on(event: "typingIndicatorReceived", listener: (e: TypingIndicatorReceivedEvent) => void): void
on(event: "readReceiptReceived", listener: (e: ReadReceiptReceivedEvent) => void): void

- Defined in chatClient.ts:316
Subscribe function for chatMessageReceived. The initial sender will also receive this event. You need to call startRealtimeNotifications before subscribing to any event.

Parameters
- event: "chatMessageReceived"
  
  The ChatMessageReceivedEvent.
- listener: (e: ChatMessageReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageReceivedEvent): void
    - Parameters
      - e: ChatMessageReceivedEvent
      Returns void
Returns void
- Defined in chatClient.ts:324
Subscribe function for chatMessageEdited. The initial sender will also receive this event.

Parameters
- event: "chatMessageEdited"
  
  The ChatMessageEditedEvent.
- listener: (e: ChatMessageEditedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageEditedEvent): void
    - Parameters
      - e: ChatMessageEditedEvent
      Returns void
Returns void
- Defined in chatClient.ts:332
Subscribe function for chatMessageDeleted. The initial sender will also receive this event.

Parameters
- event: "chatMessageDeleted"
  
  The ChatMessageDeletedEvent.
- listener: (e: ChatMessageDeletedEvent) => void
  
  The listener to handle the event.
  - - (e: ChatMessageDeletedEvent): void
    - Parameters
      - e: ChatMessageDeletedEvent
      Returns void
Returns void
- Defined in chatClient.ts:340
Subscribe function for typingIndicatorReceived. The initial sender will also receive this event.

Parameters
- event: "typingIndicatorReceived"
  
  The TypingIndicatorReceivedEvent.
- listener: (e: TypingIndicatorReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: TypingIndicatorReceivedEvent): void
    - Parameters
      - e: TypingIndicatorReceivedEvent
      Returns void
Returns void
- Defined in chatClient.ts:350
Subscribe function for readReceiptReceived.

Parameters
- event: "readReceiptReceived"
  
  The ReadReceiptReceivedEvent.
- listener: (e: ReadReceiptReceivedEvent) => void
  
  The listener to handle the event.
  - - (e: ReadReceiptReceivedEvent): void
    - Parameters
      - e: ReadReceiptReceivedEvent
      Returns void
Returns void

startRealtimeNotifications

startRealtimeNotifications(): Promise<void>

- Defined in chatClient.ts:281
Start receiving realtime notifications. Call this function before subscribing to any event.

Returns Promise<void>

stopRealtimeNotifications

stopRealtimeNotifications(): Promise<void>

- Defined in chatClient.ts:299
Stop receiving realtime notifications. This function would unsubscribe to all events.

Returns Promise<void>

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Parameters

url: string

credential: CommunicationUserCredential

Default value options: ChatClientOptions = {}

Returns ChatClient

Methods

createChatThread

Parameters

request: CreateChatThreadRequest

Default value options: CreateChatThreadOptions = {}

Returns Promise<ChatThreadClient>

deleteChatThread

Parameters

threadId: string

Default value options: DeleteChatThreadOptions = {}

Returns Promise<OperationResponse>

getChatThread

Parameters

threadId: string

Default value options: GetChatThreadOptions = {}

Returns Promise<GetChatThreadResponse>

getChatThreadClient

Parameters

threadId: string

Returns Promise<ChatThreadClient>

listChatThreads

Parameters

Default value options: ListChatThreadsOptions = {}

Returns PagedAsyncIterableIterator<ChatThreadInfo>

off

Parameters

event: "chatMessageReceived"

listener: (e: ChatMessageReceivedEvent) => void

Parameters

e: ChatMessageReceivedEvent

Returns void

Returns void

Parameters

event: "chatMessageEdited"

listener: (e: ChatMessageEditedEvent) => void

Parameters

e: ChatMessageEditedEvent

Returns void

Returns void

Parameters

event: "chatMessageDeleted"

listener: (e: ChatMessageDeletedEvent) => void

Parameters

e: ChatMessageDeletedEvent

Returns void

Returns void

Parameters

event: "typingIndicatorReceived"

listener: (e: TypingIndicatorReceivedEvent) => void

Parameters

e: TypingIndicatorReceivedEvent

Returns void

Returns void

Parameters

event: "readReceiptReceived"

listener: (e: ReadReceiptReceivedEvent) => void

Parameters

e: ReadReceiptReceivedEvent

Returns void

Returns void

on

Parameters

event: "chatMessageReceived"

listener: (e: ChatMessageReceivedEvent) => void

Parameters

e: ChatMessageReceivedEvent

Returns void

Returns void

Parameters