How to Create Chat Threads and Send Messages to Microsoft Teams Users with Azure Communication Services

Question

How to Create Chat Threads and Send Messages to Microsoft Teams Users with Azure Communication Services

devuser61 0

I have Microsoft Teams users and obtain access tokens for Azure Communication Services to make calls using Azure SDKs. I want to send messages using the @azure/communication-chat SDK but encounter an error while creating a chat thread. It works with ACS users directly, but not for Teams users.

Error:

"CommunicationError": {
    "Code": "Forbidden",
    "Details": []
}

Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-03T06:43:08.29+00:00
Hi @devuser61 ,
Thanks for the question and using MS Q&A platform.

To create chat threads and send messages to Microsoft Teams users using the Azure Communication Services (ACS) with the @azure/communication-chat SDK, ensure that you are correctly using the CommunicationUserIdentifier for ACS users and the MicrosoftTeamsUserIdentifier for Teams users.

When creating a chat thread that includes Teams users, you need to initialize the ChatParticipant with the appropriate identifier type. If you are encountering a "CommunicationError," it is likely due to an incorrect identifier type or an issue with the access token scope. Make sure that the access token you are using has the correct permissions for chat operations involving Teams users.

sample:

var teamsParticipant = new MicrosoftTeamsUserIdentifier(teamsUserId: "8:orgid:<AAD_OBJECT_ID>"); var chatParticipant = new ChatParticipant(identifier: teamsParticipant) { DisplayName = "Teams User Display Name" }; // Create chat thread CreateChatThreadResult createChatThreadResult = await chatClient.CreateChatThreadAsync( topic: "Hello Teams!", participants: new[] { chatParticipant } );

Ensure that you replace <TEAMS_USER_ID> with the actual Teams user ID. Additionally, verify that the access token is issued with the appropriate scope for chat.
ref:

Migrate from Twilio Conversations Chat to Azure Communication Services (programming-language-javascript)

Quickstart: Add Chat to your App (programming-language-javascript)
Let me know if you have any assistances.
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-04T17:39:17.1833333+00:00

Hi @devuser61 ,
Following up to see if you have chance to check my previous response and help us with requested information to check and assist you further on this.
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-05T17:44:08.4833333+00:00

Hi @devuser61 ,
Following up to see if you have chance to check my previous response and help us with requested information to check and assist you further on this.

devuser61 0

hi @Shree Hima Bindu Maganti i tried creating chat thread using below code. i am seeing error "forbidden request". my token does have acs scope for chats

const teamsParticipant:MicrosoftTeamsUserIdentifier = { microsoftTeamsUserId : "6272876c-3b81-48a2-86d0-5b1d03fc1600"};
        const chatParticipant:ChatParticipant = {
            id : teamsParticipant,
            displayName: "Dev 66"
        };
        let participants: ChatParticipant[] = [];
        participants.push(chatParticipant);
        const createChatThreadOptions:CreateChatThreadOptions = {
            participants : participants,
        };
        const createChatThreadRequest:CreateChatThreadRequest ={
            topic : "Hello teams"
        };
        const createChatThreadResult:CreateChatThreadResult =  await chatClient.createChatThread(createChatThreadRequest,createChatThreadOptions);

Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-10T13:17:20.8233333+00:00
Hi @devuser61 ,
Thankyou for your Response.
The "Forbidden request" error indicates an issue with authentication, permissions, or incorrect user identification.
Ensure the Teams user ID is in the correct format: microsoftTeamsUserId: "8:orgid:<AAD_OBJECT_ID>"

const teamsParticipant: MicrosoftTeamsUserIdentifier = { microsoftTeamsUserId: "8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600" };

Ensure the ACS access token includes the required chat scope. Run this check,

import { AzureCommunicationTokenCredential } from "@azure/communication-common"; const credential = new AzureCommunicationTokenCredential("YOUR_ACS_ACCESS_TOKEN"); console.log(await credential.getToken());

The token must contain the "chat" permission.

Verify that your Azure Communication Services (ACS) resource has Teams interoperability enabled Azure Portal → ACS Resource → Teams Interop → Enable it.

Ensure the ACS resource has the correct permissions: Azure Portal → ACS Resource → Access Control (IAM) Assign the role: "Azure Communication Services Chat User"

The API request should include participants within the createChatThreadRequest,

const createChatThreadRequest: CreateChatThreadRequest = { topic: "Hello Teams", participants: [ { id: { microsoftTeamsUserId: "8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600" }, displayName: "Dev 66" } ] }; const createChatThreadResult: CreateChatThreadResult = await chatClient.createChatThread(createChatThreadRequest);

If the issue persists, enable logging for more details,

import { setLogLevel } from "@azure/logger"; setLogLevel("info");

Let me know if you have further any assistances.
devuser61 0 Reputation points

2025-02-11T06:58:05.6266667+00:00
hi @Shree Hima Bindu Maganti i am seeing chat in scopes when i decode my acs access token.

"skypeid": "orgid:821c597b-fa46-40cc-b30e-4f9b98f2718a",

"scp": 1024, "csi": "1739251188", "exp": 1739256777, "rgn": "amer", "tid": "e3a46007-31cb-4529-b8cc-1e59b97ebdbd", "acsScope": "voip,chat", "resourceId": "ed5278ee-cdae-4788-9126-5160f964b6a6", "aad_iat": "1739251188", "aad_uti": "uVPfmSvAIk-m5c0RaoCUAA", "aad_appid": "1fd5118e-2576-4263-8130-9503064c837a", "iat": 1739251488,

when i tried to check interoperability like you mentioned i went through documentation for it at https://learn.microsoft.com/en-us/azure/communication-services/concepts/teams-interop . i am seeing that for teams user chat is not available via communication services sdk. it is available via graph api.

2 answers

Your answer

Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-03T06:43:08.29+00:00

Hi @devuser61 ,
Thanks for the question and using MS Q&A platform.

To create chat threads and send messages to Microsoft Teams users using the Azure Communication Services (ACS) with the @azure/communication-chat SDK, ensure that you are correctly using the CommunicationUserIdentifier for ACS users and the MicrosoftTeamsUserIdentifier for Teams users.

When creating a chat thread that includes Teams users, you need to initialize the ChatParticipant with the appropriate identifier type. If you are encountering a "CommunicationError," it is likely due to an incorrect identifier type or an issue with the access token scope. Make sure that the access token you are using has the correct permissions for chat operations involving Teams users.

sample:

var teamsParticipant = new MicrosoftTeamsUserIdentifier(teamsUserId: "8:orgid:<AAD_OBJECT_ID>"); var chatParticipant = new ChatParticipant(identifier: teamsParticipant) { DisplayName = "Teams User Display Name" }; // Create chat thread CreateChatThreadResult createChatThreadResult = await chatClient.CreateChatThreadAsync( topic: "Hello Teams!", participants: new[] { chatParticipant } );

Ensure that you replace <TEAMS_USER_ID> with the actual Teams user ID. Additionally, verify that the access token is issued with the appropriate scope for chat.
ref:

Migrate from Twilio Conversations Chat to Azure Communication Services (programming-language-javascript)

Quickstart: Add Chat to your App (programming-language-javascript)
Let me know if you have any assistances.
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-04T17:39:17.1833333+00:00

Hi @devuser61 ,
Following up to see if you have chance to check my previous response and help us with requested information to check and assist you further on this.
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-05T17:44:08.4833333+00:00

Hi @devuser61 ,
Following up to see if you have chance to check my previous response and help us with requested information to check and assist you further on this.
devuser61 0 Reputation points

2025-02-10T05:48:25.43+00:00

hi @Shree Hima Bindu Maganti i tried creating chat thread using below code. i am seeing error "forbidden request". my token does have acs scope for chats

const teamsParticipant:MicrosoftTeamsUserIdentifier = { microsoftTeamsUserId : "6272876c-3b81-48a2-86d0-5b1d03fc1600"}; const chatParticipant:ChatParticipant = { id : teamsParticipant, displayName: "Dev 66" }; let participants: ChatParticipant[] = []; participants.push(chatParticipant); const createChatThreadOptions:CreateChatThreadOptions = { participants : participants, }; const createChatThreadRequest:CreateChatThreadRequest ={ topic : "Hello teams" }; const createChatThreadResult:CreateChatThreadResult = await chatClient.createChatThread(createChatThreadRequest,createChatThreadOptions);
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-10T13:17:20.8233333+00:00

Hi @devuser61 ,
Thankyou for your Response.
The "Forbidden request" error indicates an issue with authentication, permissions, or incorrect user identification.
Ensure the Teams user ID is in the correct format: microsoftTeamsUserId: "8:orgid:<AAD_OBJECT_ID>"

const teamsParticipant: MicrosoftTeamsUserIdentifier = { microsoftTeamsUserId: "8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600" };

Ensure the ACS access token includes the required chat scope. Run this check,

import { AzureCommunicationTokenCredential } from "@azure/communication-common"; const credential = new AzureCommunicationTokenCredential("YOUR_ACS_ACCESS_TOKEN"); console.log(await credential.getToken());

The token must contain the "chat" permission.

Verify that your Azure Communication Services (ACS) resource has Teams interoperability enabled Azure Portal → ACS Resource → Teams Interop → Enable it.

Ensure the ACS resource has the correct permissions: Azure Portal → ACS Resource → Access Control (IAM) Assign the role: "Azure Communication Services Chat User"

The API request should include participants within the createChatThreadRequest,

const createChatThreadRequest: CreateChatThreadRequest = { topic: "Hello Teams", participants: [ { id: { microsoftTeamsUserId: "8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600" }, displayName: "Dev 66" } ] }; const createChatThreadResult: CreateChatThreadResult = await chatClient.createChatThread(createChatThreadRequest);

If the issue persists, enable logging for more details,

import { setLogLevel } from "@azure/logger"; setLogLevel("info");

Let me know if you have further any assistances.
devuser61 0 Reputation points

2025-02-11T06:58:05.6266667+00:00

hi @Shree Hima Bindu Maganti i am seeing chat in scopes when i decode my acs access token.

"skypeid": "orgid:821c597b-fa46-40cc-b30e-4f9b98f2718a",

"scp": 1024, "csi": "1739251188", "exp": 1739256777, "rgn": "amer", "tid": "e3a46007-31cb-4529-b8cc-1e59b97ebdbd", "acsScope": "voip,chat", "resourceId": "ed5278ee-cdae-4788-9126-5160f964b6a6", "aad_iat": "1739251188", "aad_uti": "uVPfmSvAIk-m5c0RaoCUAA", "aad_appid": "1fd5118e-2576-4263-8130-9503064c837a", "iat": 1739251488,

when i tried to check interoperability like you mentioned i went through documentation for it at https://learn.microsoft.com/en-us/azure/communication-services/concepts/teams-interop . i am seeing that for teams user chat is not available via communication services sdk. it is available via graph api.

Answer 1

hi @Shree Hima Bindu Maganti

when i give user id as 8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600 i am getting below error

{

"CommunicationError": {

"Code": "BadRequest",

"Message": "The provided microsoft teams user id (8:orgid:6272876c-3b81-48a2-86d0-5b1d03fc1600) is invalid.",

"Details": []

}

when i give 6272876c-3b81-48a2-86d0-5b1d03fc1600 i am getting below error.

{

"CommunicationError": {

"Code": "Forbidden",

"Details": []

}

code snippet i am using :

const teamsParticipant:MicrosoftTeamsUserIdentifier = { microsoftTeamsUserId : "6272876c-3b81-48a2-86d0-5b1d03fc1600"};

    const chatParticipant:ChatParticipant = {

        id : teamsParticipant,

        displayName: "Dev 66"

    };

    let participants: ChatParticipant[] = [];

    participants.push(chatParticipant);

    const createChatThreadOptions:CreateChatThreadOptions = {

        participants : participants,

    };

    const createChatThreadRequest:CreateChatThreadRequest ={

        topic : "Hello teams"

    };

    const createChatThreadResult:CreateChatThreadResult =  await chatClient.createChatThread(createChatThreadRequest,createChatThreadOptions);

i am seeing chat in acs scope when i decode my acs access token:

	"scp": 1024,

"csi": "1739251188",

"exp": 1739256777,

"rgn": "amer",

"tid": "e3a46007-31cb-4529-b8cc-1e59b97ebdbd",

"acsScope": "voip,chat",

also i went through the documentation teams interoperability at https://learn.microsoft.com/en-us/azure/communication-services/concepts/teams-interop i am seeing that for teams user chat is enabled via Graph api only. is this the reason why i am not able to create chat thread.

User's image

devuser61 0 Reputation points

2025-02-13T09:59:20.78+00:00

Solution is we have to use graph APIs for accessing chats for teams users
Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-13T11:06:06.59+00:00

Hi @devuser61 ,
Thankyou for your Response.
I'm glad that you were able to resolve your issue and thank you for posting your solution so that others experiencing the same thing can easily reference this. I'll repost your solution in case you'd like to accept the answer.

Answer 2

Hi @devuser61 ,
Thankyou for your Response.
I'm glad that you were able to resolve your issue and thank you for posting your solution so that others experiencing the same thing can easily reference this! Since the Microsoft Q&A community has a policy that "The question author cannot accept their own answer. They can only accept answers by others ", I'll repost your solution in case you'd like to accept the answer.
sol:

Also i went through the documentation teams interoperability at https://learn.microsoft.com/en-us/azure/communication-services/concepts/teams-interop i am seeing that for teams user chat is enabled via Graph api only. is this the reason why i am not able to create chat thread.

User's image
If the answer is helpful, please click Accept Answer and kindly upvote it so that other people who faces similar issue may get benefitted from it.

Shree Hima Bindu Maganti 4,925 Reputation points Microsoft External Staff Moderator

2025-02-13T08:56:45.8+00:00

Hi @devuser61 ,
Following up to see if you have chance to check my previous response and help us with requested information to check and assist you further on this.

Share via

How to Create Chat Threads and Send Messages to Microsoft Teams Users with Azure Communication Services

2 answers

Your answer