Skip to content

Commit f9e7837

Browse files
authored
Update How to Manage Your Calling Identity.md
removing the display name for now and updating the intro to reflect that
1 parent 8271ab1 commit f9e7837

File tree

1 file changed

+27
-142
lines changed

1 file changed

+27
-142
lines changed

articles/communication-services/concepts/telephony/How to Manage Your Calling Identity.md

Lines changed: 27 additions & 142 deletions
Original file line numberDiff line numberDiff line change
@@ -14,167 +14,52 @@ ms.service: azure-communication-services
1414

1515
# Define your caller identity
1616

17+
A common challenge faced by businesses is the difficulty of getting their calls answered or even noticed by customers. In many cases, potential customers ignore or block calls from unknown or unfamiliar numbers.
1718

18-
One common challenge faced by businesses is the difficulty of getting
19-
their calls answered or even noticed by customers. In many cases, calls
20-
from unknown or unfamiliar numbers are ignored or blocked by recipients.
19+
Using an unidentified number can lead to missed opportunities for sales, customer service, and other important interactions. This problem can be especially challenging for businesses that rely heavily on phone-based communication, such as call centers or sales teams.
2120

21+
To address these challenges, Azure Communications Services offers customers the ability to define their caller's name when they place a public switched telephone network (PSTN) call and proposes a new Caller Name Delivery (CNAM) registration process. To avoid their customer calling numbers being flagged as spam, customers should register their PSTN outbound numbers with central registries and to follow best practices described in this article.
2222

23-
This leads to missed opportunities for sales, customer service, and other
23+
## What is Caller Name Delivery (CNAM)
2424

25-
important interactions. This can be especially challenging for
26-
businesses that rely heavily on phone-based communication, such as call
27-
centers or sales teams.
28-
29-
To address these challenges, Azure
30-
31-
Communications Services is offering customers the ability to define
32-
their caller's name when they place a PSTN call. Depending on their
33-
needs, customers can choose between two options: Caller Name Delivery
34-
(CNAM) registration or dynamic display name. To avoid
35-
36-
customer's calling numbers being flagged as "Spam",
37-
38-
customers should register their PSTN outbound numbers with central
39-
40-
registries and to follow best practices described in this article.
41-
42-
43-
## What is CNAM
44-
45-
### Overview
46-
47-
In the US, Caller Name Delivery (CNAM) provides the caller's name or
48-
company name in Caller ID, though it may show as \"restricted\" or \"not
49-
available\" due to blocking or technical issues. The terminating carrier
50-
retrieves this information through a database lookup DB (up to 8
51-
providers in the US) using the caller\'s phone number. In Canada, the
52-
caller's name can be added by either the client\'s equipment (e.g., PBX)
53-
or the originating carrier, as long as it complies with anti-spoofing
54-
and fraud regulations.
55-
56-
![CNAM Flow](../media/cnam-call-flow.png)
25+
In the US, Caller Name Delivery (CNAM) provides the caller's name or company name in Caller ID, though it can also show as \"restricted\" or \"not available\" due to blocking or technical issues. The terminating carrier retrieves this information through a database lookup (up to eight
26+
providers in the US) using the caller\'s phone number. In Canada, you can add the caller's name using either the client\'s equipment (such as PBX) or the originating carrier, as long as it complies with anti-spoofing and fraud regulations.
5727

28+
![A call flow diagram showing your call registered with a Caller Name Delivery (CNAM) from Azure Communication Services through an originating service provider and terminating service provider to the called device displaying your CNAM.](../media/cnam-call-flow.png)
5829

5930
### How to register
6031

61-
In order to request a CNAM registration for an ACS number, customers will simply need to send an email to <[email protected]>, using \"ACS Number Request -- CNAM Registration\" as part of customer's subject line and providing the below details:
62-
63-
- Customer and Azure details
64-
65-
- List of number and the corresponding caller name to register for
66-
each number (customer must own these numbers under the Azure
67-
Resources provided and he can register [only US local
68-
numbers]{.underline})
69-
70-
Please note that CNAM are limited to 15 characters (including spaces)
71-
and the following special characters are supported:
72-
73-
- **.** Period
32+
To request a CNAM registration for an Azure Communication Services number, customers need to send an email to `<[email protected]>`, using `"ACS Number Request -- CNAM Registration"` as part of subject line. In the body or the email, provide the following details:
7433

75-
- , Comma
34+
- Customer and Azure account details.
7635

77-
- & Ampersand
36+
- List a number and the corresponding caller name to register for each number. The customer must own these numbers under the Azure Resource provided. Customer can register only **US local numbers**.
7837

79-
- -- Dash
38+
CNAM caller names are limited to 15 characters (including spaces) and support the following special characters:
8039

81-
- \_ Underscore
40+
| Special character | Name |
41+
| --- |:--- |
42+
| **.** | period |
43+
| **,** | comma |
44+
| **&** | ampersand |
45+
| **-** | dash |
46+
| **_** | underscore |
47+
| **'** | single quote (as in Tom's Burgers) |
8248

83-
- ' Single quotation (i.e. Tom's Burgers)
84-
85-
Once the request is approved by the carrier, it takes **48 hours to be
86-
published.**
49+
Once the request is approved by the carrier, it takes **48 hours to be published.**
8750

8851
### Things to consider
8952

90-
1. The reliability of CNAM delivery with the call varies depending on
91-
the country/region and carriers that handle the call\--either as an
92-
intermediary or a terminating carrier.
93-
94-
2. Inconsistencies in CNAM can be caused when the intermediate or
95-
terminating carriers delay refreshing the CNAM information in
96-
authoritative databases\--as in the United States. In
97-
countries/regions where there are no authoritative databases for
98-
CNAM, individual carrier practices can also cause problems with CNAM
99-
information arriving intact with the call.
100-
101-
3. ACS currently doesn\'t support CNAM registration for
102-
countries/regions other than the United States.
103-
104-
4. This registration is available only for US local numbers (not
105-
supported on toll free).
53+
1. The reliability of CNAM delivery with the call varies depending on the country/region and carriers that handle the call; either as an intermediary or a terminating carrier.
10654

107-
5. This service only applies for OUTBOUND calls and for the numbers
108-
that customer owns.
55+
2. Inconsistencies in CNAM can be caused when the intermediate or terminating carriers delay refreshing the CNAM information in authoritative databases, such as in the United States. In countries/regions where there are no authoritative databases for CNAM, individual carrier practices can also cause problems with CNAM information arriving intact with the call.
10956

110-
6. CNAM DBs are not always up to date and not all the same and there is
111-
a potential for misspellings.
57+
3. Azure Communication Services currently doesn't support CNAM registration for countries or regions outside the United States.
11258

113-
7. There are multiple CNAM databases across the country and terminating
114-
carriers may subscribe to one or multiple databases.
59+
4. This registration is available only for US local numbers. It doesn't support toll free numbers.
11560

116-
## Display Name
117-
118-
### Overview
119-
120-
Display Name allows customers to pass a caller name in the code
121-
when making a call, which gives them more flexibility and control over
122-
the branding of each call. This option is available with both ACS SDKs:
123-
Call Automation and Calling SDK. This is also supported by both Direct
124-
Offer and Direct Routing.
125-
126-
### How to set the display name
127-
128-
To define the display name when placing an outbound call,
129-
130-
customers can use the property
131-
*[CallInvite.SourceDisplayName](https://learn.microsoft.com/en-us/dotnet/api/azure.communication.callautomation.callinvite.sourcedisplayname?view=azure-dotnet).*
132-
133-
Customers can set the display name appearing on target callee.
134-
135-
136-
The following example places a PSTN outbound call using Call
137-
138-
Automation:
139-
140-
```javascript
141-
async function createOutboundCall() {
142-
const callInvite: CallInvite = {
143-
targetParticipant: callee,
144-
sourceCallIdNumber: {
145-
phoneNumber: process.env.ACS_RESOURCE_PHONE_NUMBER || "",
146-
},
147-
};
148-
callInvite.SourceDisplayName = "Contoso Bank";
149-
const options: CreateCallOptions = { callIntelligenceOptions: { cognitiveServicesEndpoint: process.env.COGNITIVE_SERVICES_ENDPOINT } };
150-
console.log("Placing outbound call...");
151-
acsClient.createCall(callInvite, process.env.CALLBACK_URI + "/api/callbacks", options);
152-
}
153-
```
154-
155-
Where:
156-
157-
- **CALLBACK_URI**: Once customer has their
158-
159-
[DevTunnel](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started?tabs=windows)
160-
host initialized, update this field with that URI.
161-
162-
- **ACS_RESOURCE_PHONE_NUMBER**: update this field with the Azure
163-
Communication Services phone number customer has acquired. This
164-
phone number should use
165-
the [E164](https://en.wikipedia.org/wiki/E.164) phone number format.
166-
167-
- **COGNITIVE_SERVICES_ENDPOINT**: update field with customer's Azure
168-
AI services endpoint.
169-
170-
### Things to consider
61+
5. This service only applies to *outbound* calls for numbers that customer owns.
17162

172-
The reliability of display name delivery with the call varies depending
173-
on the country/region and carriers that handle the call\--either as an
174-
intermediary or a terminating carrier. In the US, the delivery of
175-
display names is unreliable, and, in many cases, the downstream carriers
176-
will strip the caller ID. In Canada, it's more reliable and in some
177-
states considered standard practice, the recommendation for CA/US is to
178-
use both CNAM and the API to set the Caller ID, and in the RoW the
179-
experience varies based on the country.
63+
6. CNAM databases aren't always up to date and not consistently updated. There's a potential for misspellings.
18064

65+
7. There are multiple CNAM databases across the country and terminating carriers may subscribe to one or more databases.

0 commit comments

Comments
 (0)