Skip to content

Commit 37d8f81

Browse files
committed
New Next Steps
Added Next Steps links to 5 docs. Minor edits per Acrolinx.
1 parent 873f1be commit 37d8f81

File tree

5 files changed

+32
-24
lines changed

5 files changed

+32
-24
lines changed

articles/communication-services/concepts/numbers/number-types.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.service: azure-communication-services
1414

1515
# Number types
1616

17-
Azure Communication Services allows you to use phone numbers to make voice calls and send SMS messages with the public-switched telephone network (PSTN). In this document, we'll review the phone number types, region availability, and use cases for planning your telephony and SMS solution using Communication Services.
17+
Azure Communication Services allows you to use phone numbers to make voice calls and send SMS messages with the public-switched telephone network (PSTN). In this document, we review the phone number types, region availability, and use cases for planning your telephony and SMS solution using Communication Services.
1818

1919
## Available options
2020

@@ -25,7 +25,7 @@ Azure Communication Services offers three types of Numbers: Toll-Free, Local, an
2525
- **To send or receive an SMS**, choose a Toll-Free Number or a Short Code
2626
- **To make or receive phone calls**, choose a Toll-Free Number or a Local Number
2727

28-
The table below summarizes these number types with supported capabilities:
28+
This table summarizes the number types and supported capabilities:
2929

3030
| Type | Example | Send SMS | Receive SMS | Make Calls | Receive Calls | Typical Use Case | Restrictions |
3131
| :-------------------------------------------------------------------- | :---------------- | :------: | :---------: | :--------: | :-----------: | :------------------------------------------- | :------------- |
@@ -35,7 +35,8 @@ The table below summarizes these number types with supported capabilities:
3535

3636
## Next steps
3737

38-
For additional information about getting or managing phone numbers please see the following pages:
38+
For more information about getting or managing phone numbers, see the following topics:
3939

4040
- Get a [Toll-Free or Local Phone Number](../../quickstarts/telephony/get-phone-number.md)
4141
- Get a [Short-Code](../../quickstarts/sms/apply-for-short-code.md)
42+
- [Quickstart: Look up operator information for a phone number](../../quickstarts/telephony/number-lookup.md)

articles/communication-services/concepts/sms/concepts.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,9 @@ Key features of Azure Communication Services SMS SDKs include:
3636

3737
## Sender types supported
3838

39-
Sending SMS to any recipient requires getting a phone number. Choosing the right number type is critical to the success of your messaging campaign. Few of the factors to consider when choosing a number type include destination(s) of the message, throughput requirement of your messaging campaign, and the timeline when you want to start sending messages. Azure Communication Services enables you to send SMS using a variety of sender types - toll-free number (1-8XX), short codes (12345), and alphanumeric sender ID (CONTOSO). The following table walks you through the features of each number type:
39+
Sending SMS to any recipient requires getting a phone number. Choosing the right number type is critical to the success of your messaging campaign. Some factors to consider when choosing a number type include destination(s) of the message, throughput requirement of your messaging campaign, and the timeline when you want to start sending messages. Azure Communication Services enables you to send SMS using a variety of sender types - toll-free number (1-8XX), short codes (12345), and alphanumeric sender ID (CONTOSO). The following table walks you through the features of each number type:
4040

41-
|Factors | Toll-Free| Short Code | Dynamic Alphanumeric Sender ID| Pre-registered Alphanumeric Sender ID|
41+
|Factors | Toll-Free| Short Code | Dynamic Alphanumeric Sender ID| Preregistered Alphanumeric Sender ID|
4242
|---------------------|----------|------------|-----------------------|-----------------------|
4343
|**Description**|Toll free numbers are telephone numbers with distinct three-digit codes that can be used for business to consumer communication without any charge to the consumer| Short codes are 5-6 digit numbers used for business to consumer messaging such as alerts, notifications, and marketing | Alphanumeric Sender IDs are displayed as a custom alphanumeric phrase like the company’s name (CONTOSO, MyCompany) on the recipient handset. Alphanumeric sender IDs can be used for a variety of use cases like one-time passcodes, marketing alerts, and flight status notifications. Dynamic alphanumeric sender ID is supported in countries that do not require registration for use.| Alphanumeric Sender IDs are displayed as a custom alphanumeric phrase like the company’s name (CONTOSO, MyCompany) on the recipient handset. Alphanumeric sender IDs can be used for a variety of use cases like one-time passcodes, marketing alerts, and flight status notifications. Pre-registered alphanumeric sender ID is supported in countries that require registration for use. |
4444
|**Format**|+1 (8XX) XYZ PQRS| 12345 | CONTOSO* |CONTOSO* |
@@ -56,11 +56,12 @@ Sending SMS to any recipient requires getting a phone number. Choosing the right
5656
> [!div class="nextstepaction"]
5757
> [Get started with sending sms](../../quickstarts/sms/send.md)
5858
59-
The following documents might be interesting to you:
59+
See the following articles for more information:
6060

61+
- [Number lookup overview](../../concepts/numbers/number-lookup-concept.md)
6162
- Check SMS FAQ for questions regarding [SMS](../sms/sms-faq.md)
6263
- Familiarize yourself with the [SMS SDK](../sms/sdk-features.md)
6364
- Get an SMS capable [phone number](../../quickstarts/telephony/get-phone-number.md)
6465
- Get a [short code](../../quickstarts/sms/apply-for-short-code.md)
65-
- [Phone number types in Azure Communication Services](../telephony/plan-solution.md)
66+
- Learn about [Phone number types in Azure Communication Services](../telephony/plan-solution.md)
6667
- Apply for [Toll-free verification](./sms-faq.md#toll-free-verification)

articles/communication-services/concepts/telephony/telephony-concept.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,28 +16,28 @@ ms.subservice: pstn
1616

1717
[!INCLUDE [Regional Availability Notice](../../includes/regional-availability-include.md)]
1818

19-
Azure Communication Services Calling SDKs can be used to add telephony and Public Switched Telephone Network access to your applications. This page summarizes key telephony concepts and capabilities. See the [calling library](../../quickstarts/voice-video-calling/getting-started-with-calling.md) to learn more about specific SDK languages and capabilities.
19+
Azure Communication Services Calling SDKs enable you to add telephony and Public Switched Telephone Network (PSTN) access to your applications. This page summarizes key telephony concepts and capabilities. See the [calling library](../../quickstarts/voice-video-calling/getting-started-with-calling.md) to learn more about specific SDK languages and capabilities.
2020

2121
[!INCLUDE [Survey Request](../../includes/survey-request.md)]
2222

23-
## Overview of telephony
24-
Whenever your users interact with a traditional telephone number, calls are facilitated by PSTN (Public Switched Telephone Network) voice calling. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users. Communication Services provides two discrete ways to reach the PSTN network: Voice Calling (PSTN) and Azure direct routing.
23+
## Telephony overview
24+
Whenever your users interact with a traditional telephone number, the Public Switched Telephone Network (PSTN) voice calling handles the call. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users. Communication Services provides two discrete ways to reach the PSTN network: Voice Calling (PSTN) and Azure direct routing.
2525

2626
### Voice Calling (PSTN)
2727

2828
An easy way of adding PSTN connectivity to your app or service, in such case, Microsoft is your telco provider. You can buy numbers directly from Microsoft. Azure Cloud Calling is an all-in-the-cloud telephony solution for Communication Services. It is the simplest option that connects Communication Services to the Public Switched Telephone Network (PSTN) to enable calls to landlines and mobile phones worldwide. Microsoft acts as your PSTN carrier, as shown in the following diagram:
2929

3030
![Voice Calling (PSTN) diagram.](../media/telephony-concept/azure-calling-diagram.png)
3131

32-
If you answer yes to the following, then Voice Calling (PSTN) is the right solution for you:
32+
If you answer **yes** to the following questions, then Voice Calling (PSTN) is the right solution for you:
3333
- Voice Calling (PSTN) is available in your region.
34-
- You do not need to retain your current PSTN carrier.
34+
- You don't need to retain your current PSTN carrier.
3535
- You want to use Microsoft-managed access to the PSTN.
3636

3737
With this option:
3838
- You get numbers directly from Microsoft and can call phones around the world.
39-
- You do not require deployment or maintenance of an on-premises deployment—because Voice Calling (PSTN) operates out of Azure Communication Services.
40-
- Note: If necessary, you can choose to connect a supported Session Border Controller (SBC) through Azure direct routing for interoperability with third-party PBXs, analog devices, and other third-party telephony equipment supported by the SBC.
39+
- You don't need to deploy or maintain any on-premises system because Voice Calling (PSTN) operates through Azure Communication Services.
40+
- Note: If necessary, you can choose to connect a supported Session Border Controller (SBC) through Azure Communication Services direct routing for interoperability with third-party Pprivate branch exchanges (PBXs), analog devices, and other third-party telephony equipment supported by the SBC.
4141

4242
This option requires an uninterrupted connection to Azure Communication Services.
4343

@@ -49,19 +49,19 @@ With this option, you can connect legacy on-premises telephony and your carrier
4949

5050
![Azure direct routing diagram.](../media/telephony-concept/sip-interface-diagram.png)
5151

52-
If you answer yes to any of the following questions, then Azure direct routing is the right solution for you:
52+
If you answer **yes** to any of the following questions, then Azure direct routing is the right solution for you:
5353

54-
- You want to use Communication Services with PSTN calling capabilities.
54+
- You want to use Azure Communication Services with PSTN calling capabilities.
5555
- You need to retain your current PSTN carrier.
56-
- You want to mix routing, with some calls going through Voice Calling (PSTN), some through your carrier.
56+
- You want to mix routing, with some calls going through Voice Calling (PSTN) and some through your carrier.
5757
- You need to interoperate with third-party PBXs and/or equipment such as overhead pagers, analog devices, and so on.
5858

5959
With this option:
6060

6161
- You connect your own supported SBC to Azure Communication Services without the need for extra on-premises software.
6262
- You can use literally any telephony carrier with Communication Services.
6363
- You can choose to configure and manage this option, or it can be configured and managed by your carrier or partner (ask if your carrier or partner provides this option).
64-
- You can configure interoperability between your telephony equipment, such as a third-party PBX and analog devices, and Communication Services.
64+
- You can configure interoperability between your telephony equipment, such as a third-party PBX and analog devices, and Azure Communication Services.
6565

6666
This option requires:
6767

@@ -78,9 +78,11 @@ This option requires:
7878
- [Session Border Controllers certified for Azure Communication Services direct routing](./certified-session-border-controllers.md)
7979
- [Pricing](../pricing.md)
8080
- Learn about [call automation API](../call-automation/call-automation.md) that enables you to build server-based calling workflows to control and manage calls for phone numbers and direct routing
81+
- [Number lookup overview](../../concepts/numbers/number-lookup-concept.md)
8182

8283
### Quickstarts
8384

8485
- [Get a phone number](../../quickstarts/telephony/get-phone-number.md)
8586
- [Outbound call to a phone number](../../quickstarts/telephony/pstn-call.md)
86-
- [Use call automation to build calling workflow that can place calls to phone numbers, play voice prompts and more](../../quickstarts/call-automation/quickstart-make-an-outbound-call.md)
87+
- [Use call automation to build calling workflow that can place calls to phone numbers, play voice prompts and more](../../quickstarts/call-automation/quickstart-make-an-outbound-call.md)
88+
- [Look up operator information for a phone number](../../quickstarts/telephony/number-lookup.md)

articles/communication-services/quickstarts/sms/send.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Quickstart - Send an SMS message
33
titleSuffix: Azure Communication Services
4-
description: "In this quickstart, you'll learn how to send an SMS message by using Azure Communication Services. See code examples in C#, JavaScript, Java, and Python."
4+
description: "In this quickstart, you learn how to send an SMS message by using Azure Communication Services. See code examples in C#, JavaScript, Java, and Python."
55
author: tophpalmer
66
manager: chpalm
77
services: azure-communication-services
@@ -16,7 +16,7 @@ zone_pivot_groups: acs-azcli-js-csharp-java-python-logic-apps
1616
# Quickstart: Send an SMS message
1717

1818
> [!IMPORTANT]
19-
> SMS capabilities depend on the phone number you use and the country/region that you're operating within as determined by your Azure billing address. For more information, visit the [Subscription eligibility](../../concepts/numbers/sub-eligibility-number-capability.md) documentation.
19+
> SMS capabilities depend on the phone number you use and the country/region that you're operating within as determined by your Azure billing address. For more information, see [Subscription eligibility](../../concepts/numbers/sub-eligibility-number-capability.md).
2020
2121
[!INCLUDE [Survey Request](../../includes/survey-request.md)]
2222

@@ -58,11 +58,11 @@ If you want to clean up and remove a Communication Services subscription, you ca
5858

5959
## Toll-free verification
6060

61-
If you have a new toll-free number and want to send [high volume of SMS messages](../../concepts/sms/sms-faq.md#what-happens-if-i-dont-verify-my-toll-free-numbers) or send SMS messages to Canadian phone numbers, please visit [here](../../concepts/sms/sms-faq.md#how-do-i-submit-a-toll-free-verification) to learn how to verify your toll-free number.
61+
If you have a new toll-free number and want to send a [high volume of SMS messages](../../concepts/sms/sms-faq.md#what-happens-if-i-dont-verify-my-toll-free-numbers) or send SMS messages to Canadian phone numbers, see [SMS FAQ > How do I submit a toll-free verification](../../concepts/sms/sms-faq.md#how-do-i-submit-a-toll-free-verification) to learn how to verify your toll-free number.
6262

6363
## Next steps
6464

65-
In this quickstart, you learned how to send SMS messages by using Communication Services.
65+
In this quickstart, you learned how to send SMS messages using Azure Communication Services.
6666

6767
> [!div class="nextstepaction"]
6868
> [Receive and reply to SMS](./receive-sms.md)
@@ -72,3 +72,5 @@ In this quickstart, you learned how to send SMS messages by using Communication
7272
7373
> [!div class="nextstepaction"]
7474
> [Phone number types](../../concepts/telephony/plan-solution.md)
75+
76+
For more information, see [Quickstart: Look up operator information for a phone number](../telephony/number-lookup.md).

articles/communication-services/quickstarts/telephony/pstn-call.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Quickstart - Call to a telephone number
33
titleSuffix: An Azure Communication Services quickstart
4-
description: In this quickstart, you'll learn how to add PSTN calling capabilities to your app using Azure Communication Services.
4+
description: In this quickstart, you learn how to add PSTN calling capabilities to your app using Azure Communication Services.
55
author: nikuklic
66
ms.author: nikuklic
77
ms.date: 06/30/2021
@@ -36,5 +36,7 @@ If you want to clean up and remove a Communication Services subscription, you ca
3636

3737
For more information, see the following articles:
3838

39+
- Learn about [Calling SDK capabilities](../voice-video-calling/getting-started-with-calling.md)
40+
- Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md)
3941
- Learn about [Calling SDK capabilities](../voice-video-calling/getting-started-with-calling.md)
4042
- Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md)

0 commit comments

Comments
 (0)