Partilhar via


Azure Communication Chat

Connector to utilize Azure Communication Services Chat features.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Connector Metadata
Publisher Microsoft
Website https://azure.microsoft.com/services/communication-services
Privacy policy https://privacy.microsoft.com
Categories Communication

Azure Communication Services Chat helps add real-time text communication to cross-platform applications.

Prerequisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan with custom connector feature
  • An Azure subscription
  • An Azure Communication Services resource

How to get credentials

1 Set up an Azure Communication Services resource

2 Connection String Authentication

Get started with your connector

After setting up an Azure Communication Services resource, generate a user access token. Use this token for the connector actions.

Known issues and limitations

No known issues or limitations at this point.

FAQ

  1. How do I generate an access token?

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Endpoint URL securestring Azure Communication Services endpoint URL. True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add chat thread participants

Add participants to chat thread.

Create chat thread

Create a chat thread.

Delete chat thread

Delete a chat thread.

Get chat thread properties

Get the properties of the chat thread.

List chat thread messages

List messages From chat thread.

List chat thread participants

List participants in chat thread.

List chat threads

List chat threads.

Remove chat thread participant

Remove participant from chat thread.

Send message to chat thread

Send message to chat thread.

Update chat thread properties

Update the properties of the chat thread.

Add chat thread participants

Add participants to chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

User ID
id string
Display Name
displayName string

Display name for the chat participant.

Time
shareHistoryTime string

Time in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) from which the chat history is shared.

Returns

Name Path Type Description
invalidParticipants
invalidParticipants array of object

Invalid participants list.

Target
invalidParticipants.target string

Target ID.

Code
invalidParticipants.code string

Error code.

Message
invalidParticipants.message string

Error message.

Create chat thread

Create a chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Chat Thread Topic
topic True string

Chat thread topic.

User ID
id string
Name
displayName string

Display name for the chat participant.

Returns

Name Path Type Description
ID
chatThread.id string

Chat Thread ID

Topic
chatThread.topic string

Chat Thread Topic

Created On
chatThread.createdOn date-time

Chat Creation Time

createdByCommunicationIdentifier
chatThread.createdByCommunicationIdentifier CommunicationIdentifier

Communication identifier.

Delete chat thread

Delete a chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Get chat thread properties

Get the properties of the chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Returns

Name Path Type Description
ID
id string

Chat thread ID.

Topic
topic string

Chat thread topic.

Created On
createdOn string

Time when the thread was created.

Deleted On
deletedOn string

Time when the thread was deleted.

Raw ID
createdByCommunicationIdentifier.rawId string

Raw ID of the identifier.

ID
createdByCommunicationIdentifier.communicationUser.id string

ID of the communication user.

List chat thread messages

List messages From chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Start Time
startTime string

Starting time in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) to get messages.

Max Page Size
maxPageSize string

Maximum number of messages to be returned per page.

Returns

Name Path Type Description
Message List
value array of object

Collection of chat messages.

ID
value.id string

ID of the chat message. This id is server generated.

Type
value.type string

Chat message type.

Version
value.version string

Version of the chat message.

Sequence ID
value.sequenceId string

Sequence of the chat message in the conversation.

message
value.content.message string

Chat message content.

initiatorCommunicationIdentifier
value.content.initiatorCommunicationIdentifier CommunicationIdentifier

Communication identifier.

Topic
value.content.topic string

Chat message content for messages of type topicUpdated.

participants
value.content.participants array of object

Chat message content for messages of types participantAdded or participantRemoved.

communicationIdentifier
value.content.participants.communicationIdentifier CommunicationIdentifier

Communication identifier.

Sender Display Name
value.senderDisplayName string

Display name of the chat message sender. This property is used to populate sender name for push notifications.

Created On
value.createdOn string

Timestamp in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) when the chat message arrived at the server.

senderCommunicationIdentifier
value.senderCommunicationIdentifier CommunicationIdentifier

Communication identifier.

Next Link
nextLink string

If there are more chat messages that can be retrieved, the next link will be populated.

List chat thread participants

List participants in chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Number Of Participants To Skip
skip string

Skips participants up to a specified position in response.

Max Participants Per Page
maxPageSize string

Maximum number of participants to be returned per page.

Returns

Name Path Type Description
value
value array of object

Chat participants.

communicationIdentifier
value.communicationIdentifier CommunicationIdentifier

Communication identifier.

Name
value.displayName string

Display name for the chat participant.

Time
value.shareHistoryTime string

Time in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) from which the chat history is shared.

Next Link
nextLink string

If there are more chat participants that can be retrieved, the next link will be populated.

List chat threads

List chat threads.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Start Time
startTime string

Starting time in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) to get chat threads.

Max Page Size
maxPageSize integer

Maximum number of chat threads returned per page.

Returns

Name Path Type Description
Chat Threads
value array of object

Collection of chat threads.

ID
value.id string

Chat thread ID.

Topic
value.topic string

Chat thread topic.

last Message Received On
value.lastMessageReceivedOn string

Timestamp in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) when the last message arrived at the server.

Deleted On
value.deletedOn string

Timestamp in RFC3339 format (yyyy-MM-ddTHH:mm:ssZ) when the chat thread was deleted.

Next Link
nextLink string

If there are more chat threads that can be retrieved, the next link will be populated.

Remove chat thread participant

Remove participant from chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

User ID
id string

Send message to chat thread

Send message to chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Content
content True string

Message content.

Name
senderDisplayName True string

Display name for the message sender.

Returns

Name Path Type Description
id
id string

id

Update chat thread properties

Update the properties of the chat thread.

Parameters

Name Key Required Type Description
Access Token
Access-Token True string

User access token.

Thread ID
chatThreadId True string

Chat Thread ID.

Chat Thread Topic
topic string

Chat thread topic.

Definitions

CommunicationIdentifier

Communication identifier.

Name Path Type Description
User ID
communicationUser.id string