Skip to content

Commit 9aa550e

Browse files
committed
added rest doc
1 parent 66386af commit 9aa550e

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

articles/communication-services/concepts/includes/identifiers/identifiers-rest.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,53 @@ The `PhoneNumberIdentifierModel` represents a phone number. The service assumes
124124

125125
[PhoneNumberIdentifierModel](https://github.com/Azure/azure-rest-api-specs/blob/c1883ee5b87c41dfcb699420409bc0e31cff0786/specification/communication/data-plane/Common/stable/2022-07-13/common.json#L126)
126126

127+
### Microsoft Teams Application
128+
129+
The `MicrosoftTeamsAppIdentifierModel` represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
130+
131+
#### Basic usage
132+
133+
```json
134+
// request
135+
{
136+
"microsoftTeamsApp": {
137+
"appId": "45ab2481-1c1c-4005-be24-0ffb879b1130"
138+
}
139+
}
140+
141+
// response
142+
{
143+
"kind": "microsoftTeamsApp",
144+
"rawId": "28:orgid:45ab2481-1c1c-4005-be24-0ffb879b1130",
145+
"microsoftTeamsApp": {
146+
"appId": "45ab2481-1c1c-4005-be24-0ffb879b1130"
147+
}
148+
}
149+
150+
151+
// if you're not operating in the public cloud, you must also pass the right Cloud type in a request
152+
{
153+
"microsoftTeamsApp": {
154+
"appId": "45ab2481-1c1c-4005-be24-0ffb879b1130",
155+
"cloud": "gcch"
156+
}
157+
}
158+
159+
// response
160+
{
161+
"kind": "microsoftTeamsApp",
162+
"rawId": "28:gcch:45ab2481-1c1c-4005-be24-0ffb879b1130",
163+
"microsoftTeamsApp": {
164+
"appId": "45ab2481-1c1c-4005-be24-0ffb879b1130",
165+
"cloud": "gcch"
166+
}
167+
}
168+
```
169+
170+
#### API reference
171+
172+
[MicrosoftTeamsAppIdentifierModel](https://github.com/Azure/azure-rest-api-specs/blob/ea28180c6ce9027df36568307f235868d581144c/specification/communication/data-plane/Common/stable/2023-11-15/common.json#L165C6-L165C38)
173+
127174
### Unknown
128175

129176
If a new identifier gets introduced in a service, it will get downgraded to the `CommunicationIdentifierModel` if you are on an old API version.

0 commit comments

Comments
 (0)