You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/tpe/teams-phone-extensibility-quickstart.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,13 +23,13 @@ This article describes how an independent software vendor (ISV) can provision Te
23
23
- ISV’s Customer has access to Microsoft 365 Admin Center.
24
24
- ISV has access to change Azure Communication Services Resource settings.
25
25
- You grant Teams Tenant access to a CCaaS service for Graph API usage.
26
-
- ISV is using the .NET, JavaScript or Java ACS Call Automation SDK version 1.5.0 or above (Python version will be released soon).
27
-
- ISV is using the JavaScript ACS Client SDK version 1.37 and above.
26
+
- ISV uses the .NET, JavaScript, or Java ACS Call Automation SDK version 1.5.0 or above (Python version will be released soon).
27
+
- ISV uses the JavaScript ACS Client SDK version 1.37 and above.
28
28
29
29
30
30
## Quick start
31
31
32
-
The rest of this article describes quick starts for two different personas: CCaaS Developer and Teams Tenant. The CCaaS developer is the ISV persona building the CCaaS service using Azure Communication Services. The Teams Tenant is the persona that is a customer of the ISV that is administering to Teams Phone.
32
+
The rest of this article describes quick starts for two different personas: CCaaS Developer and Teams Tenant. The CCaaS developer is the ISV persona building the CCaaS service using Azure Communication Services. The Teams Tenant is the persona that's a customer of the ISV that's administering to Teams Phone.
33
33
34
34
### CCaaS Developer: Provision the AppID (Application ID)
35
35
@@ -112,7 +112,7 @@ Connect-MicrosoftTeams
112
112
Update-Module MicrosoftTeams
113
113
```
114
114
115
-
Use the [New-CsOnlineApplicationInstance (MicrosoftTeamsPowerShell)](/powershell/module/teams/new-csonlineapplicationinstance) cmdlet to create a Resource Account. There's no change for Teams Phone extensibility in this command. The ApplicationId parameter is your third party bot ID. Don't use the Teams first person Application IDs defined in [Set-CsOnlineApplicationInstance (MicrosoftTeamsPowerShell)](/powershell/module/teams/set-csonlineapplicationinstance#-applicationid) because they don't work for Teams Phone extensibility. It's up to the CCaaS developer on how to communicate the Application ID to the Teams Tenant.
115
+
Use the [New-CsOnlineApplicationInstance (MicrosoftTeamsPowerShell)](/powershell/module/teams/new-csonlineapplicationinstance) cmdlet to create a Resource Account. There's no change for Teams Phone extensibility in this command. The ApplicationId parameter is your third party bot ID. Don't use the Teams first person Application identifiers (IDs) defined in [Set-CsOnlineApplicationInstance (MicrosoftTeamsPowerShell)](/powershell/module/teams/set-csonlineapplicationinstance#-applicationid) because they don't work for Teams Phone extensibility. It's up to the CCaaS developer on how to communicate the Application ID to the Teams Tenant.
116
116
117
117
Example:
118
118
@@ -196,7 +196,7 @@ The CCaaS Admin also needs elevated permissions to access Teams Resource Account
196
196
### Querying Teams Resource Accounts with Filtering and Paging
197
197
198
198
The Teams Resource Accounts API supports **OData filtering**, **server‑side paging**, and **cursor-based continuation** via the `@odata.nextLink` field.
199
-
This enables CCaaS developers to efficiently retrieve Resource Accounts associated with their Azure Communication Services (ACS) resources.
199
+
This capability enables CCaaS developers to efficiently retrieve Resource Accounts associated with their Azure Communication Services (ACS) resources.
200
200
201
201
#### Query definition
202
202
@@ -205,9 +205,9 @@ This enables CCaaS developers to efficiently retrieve Resource Accounts associat
205
205
206
206
You can extend the base query with OData options such as:
207
207
208
-
- `$filter` — filter Resource Accounts by fields such as `appId` or `acsResourceId`
209
-
- `$top` — limit the number of results returned per page
210
-
- `@odata.nextLink` — Graph-provided URL for retrieving subsequent pages
208
+
- `$filter`—filter Resource Accounts by fields such as `appId` or `acsResourceId`
209
+
- `$top`—limit the number of results returned per page
210
+
- `@odata.nextLink`—Graph-provided URL for retrieving subsequent pages
211
211
212
212
---
213
213
@@ -245,7 +245,7 @@ You can use $top to specify the maximum number of results per page:
245
245
GET https://graph.microsoft.com/beta/admin/teams/resourceAccounts?$top=5
246
246
```
247
247
248
-
If more than 5 Resource Accounts exist, Microsoft Graph returns an @odata.nextLink value for the next page:
248
+
If more than five Resource Accounts exist, Microsoft Graph returns an @odata.nextLink value for the next page:
249
249
250
250
```rest
251
251
@@ -261,7 +261,7 @@ If more than 5 Resource Accounts exist, Microsoft Graph returns an @odata.nextLi
To continue paging, call the URL in the @odata.nextLink field until it is no longer present.
264
+
To continue paging, call the URL in the @odata.nextLink field until it's no longer present.
265
265
266
266
### Combined paging and filtering
267
267
@@ -270,9 +270,9 @@ Developers can combine $top and $filter to retrieve a filtered, paginated list:
270
270
```rest
271
271
GET https://graph.microsoft.com/beta/admin/teams/resourceAccounts?$top=5&$filter=acsResourceId eq 'aa123456-1234-1234-1234-aaa123456789'
272
272
```
273
-
This returns up to 5 Resource Accounts that match the specified ACS Resource ID.
273
+
This query returns up to five Resource Accounts that match the specified ACS Resource ID.
274
274
275
-
### C# Example — Filtering + Paging
275
+
### C# Example—Filtering + Paging
276
276
The following C# sample demonstrates how to:
277
277
278
278
1. Query Teams Resource Accounts
@@ -348,12 +348,12 @@ The following steps demonstrate how to receive and answer an incoming Teams call
348
348
1. Complete client and server consent as defined in [Access a user's Teams Phone separate from their Teams client](https://github.com/Azure/communication-preview/blob/master/Teams%20Phone%20Extensibility/teams-phone-extensibility-access-teams-phone.md).
349
349
350
350
> [!NOTE]
351
-
> For the Azure Communication Services resource, ensure the data location matches the Teams Tenant location to comply with data boundary regulations. You can retrieve programmatically details about tenant organisation via [Get organization](/graph/api/organization-get)
351
+
> For the Azure Communication Services resource, ensure the data location matches the Teams Tenant location to comply with data boundary regulations. You can retrieve programmatically details about tenant organization via [Get organization](/graph/api/organization-get)
352
352
>
353
353
354
354
#### Setup and host your Azure dev tunnels
355
355
356
-
Azure dev tunnels enable you to share local web services hosted on the internet. Run the commands to connect your local development environment to the public internet. Dev tunnels creates a persistent endpoint URL and which enables anonymous access. We use this endpoint to notify your application about calling events from the Azure Communication Services Call Automation service.
356
+
Azure dev tunnels enable you to share local web services hosted on the internet. Run the commands to connect your local development environment to the public internet. Dev tunnels create a persistent endpoint URL that enables anonymous access. We use this endpoint to notify your application about calling events from the Azure Communication Services Call Automation service.
### CCaaS Client Developer: How to place an outbound OBO call
514
514
515
-
Developers need to get the onbehalfof (OBO) identity (ID) Resource Account that the call needs to be placed on behalf of. The following articles describe how to place an outbound OBO call.
515
+
Developers need to get the on-behalf-of (OBO) Resource Account identity that the call needs to be placed on behalf of. The following articles describe how to place an outbound OBO call.
516
516
517
517
Once the OBO identity is acquired, you need to set the `onBehalfOfOptions` in the `StartTeamsGroupCallOptions()` or `StartTeamsCallOptions()` method. For more information, see [StartTeamsGroupCallOptions interface](/javascript/api/azure-communication-services/@azure/communication-calling/startteamsgroupcalloptions) or [StartTeamsCallOptions interface](/javascript/api/azure-communication-services/@azure/communication-calling/startteamscalloptions).
0 commit comments