Skip to content

Commit f8f2c0c

Browse files
Fix formatting and improve clarity in documentation
1 parent 2ba351e commit f8f2c0c

1 file changed

Lines changed: 15 additions & 15 deletions

File tree

articles/communication-services/quickstarts/tpe/teams-phone-extensibility-quickstart.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,13 @@ This article describes how an independent software vendor (ISV) can provision Te
2323
- ISV’s Customer has access to Microsoft 365 Admin Center.
2424
- ISV has access to change Azure Communication Services Resource settings.
2525
- 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.
2828

2929

3030
## Quick start
3131

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.
3333

3434
### CCaaS Developer: Provision the AppID (Application ID)
3535

@@ -112,7 +112,7 @@ Connect-MicrosoftTeams
112112
Update-Module MicrosoftTeams
113113
```
114114

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.
116116

117117
Example:
118118

@@ -196,7 +196,7 @@ The CCaaS Admin also needs elevated permissions to access Teams Resource Account
196196
### Querying Teams Resource Accounts with Filtering and Paging
197197
198198
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.
200200
201201
#### Query definition
202202
@@ -205,9 +205,9 @@ This enables CCaaS developers to efficiently retrieve Resource Accounts associat
205205
206206
You can extend the base query with OData options such as:
207207
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
211211
212212
---
213213
@@ -245,7 +245,7 @@ You can use $top to specify the maximum number of results per page:
245245
GET https://graph.microsoft.com/beta/admin/teams/resourceAccounts?$top=5
246246
```
247247

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:
249249

250250
```rest
251251
@@ -261,7 +261,7 @@ If more than 5 Resource Accounts exist, Microsoft Graph returns an @odata.nextLi
261261
"https://graph.microsoft.com/beta/admin/teams/resourceAccounts?$top=5&$skiptoken=abc123..."
262262
}
263263
```
264-
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.
265265

266266
### Combined paging and filtering
267267

@@ -270,9 +270,9 @@ Developers can combine $top and $filter to retrieve a filtered, paginated list:
270270
```rest
271271
GET https://graph.microsoft.com/beta/admin/teams/resourceAccounts?$top=5&$filter=acsResourceId eq 'aa123456-1234-1234-1234-aaa123456789'
272272
```
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.
274274

275-
### C# ExampleFiltering + Paging
275+
### C# ExampleFiltering + Paging
276276
The following C# sample demonstrates how to:
277277

278278
1. Query Teams Resource Accounts
@@ -348,12 +348,12 @@ The following steps demonstrate how to receive and answer an incoming Teams call
348348
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).
349349

350350
> [!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)
352352
>
353353
354354
#### Setup and host your Azure dev tunnels
355355

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.
357357

358358
```dotnetcli
359359
devtunnel create --allow-anonymous
@@ -512,7 +512,7 @@ this._teamsCallAgent = await this._callClient.createTeamsCallAgent(this.tokenCre
512512

513513
### CCaaS Client Developer: How to place an outbound OBO call
514514

515-
Developers need to get the on behalf of (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.
516516

517517
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).
518518

0 commit comments

Comments
 (0)