Skip to content

Commit 3985c12

Browse files
committed
Number lookup private preview documentation
1 parent c0022a5 commit 3985c12

File tree

3 files changed

+16
-19
lines changed

3 files changed

+16
-19
lines changed
-110 KB
Loading

articles/communication-services/concepts/numbers/number-lookup-concept.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,46 +2,44 @@
22
title: Number Lookup API concepts in Azure Communication Services
33
titleSuffix: An Azure Communication Services concept document
44
description: Learn about Communication Services Number Lookup API concepts.
5-
author: hkaraa
5+
author: henikaraa
66
manager: rcole
77
services: azure-communication-services
88

9-
ms.author: hkaraa
9+
ms.author: henikaraa
1010
ms.date: 05/02/2023
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
13-
ms.subservice: number lookup
13+
ms.subservice: phone numbers
1414
---
1515

1616
# Number Lookup overview
1717

1818
[!INCLUDE [Private Preview Notice](../../includes/private-preview-include.md)]
19-
> This feature is available today only for US and Canadian phone numbers.
2019

21-
Azure Communication Services enables you to retrieve insights and lookup a specific phone number using the Communication Services Number Lookup SDK. It's part of the Number Management SDK and can be used to support customer service scenarios, appointment reminders, two-factor authentication, and other real-time communication needs. Communication Services Number Lookup allows you to reliably retrieve number insights before engaging with end users.
22-
[!INCLUDE ]
20+
Azure Communication Services enable you to retrieve insights and look up a specific phone number using the Azure Communication Services Number Lookup SDK. It is part of the Phone Numbers SDK and can be used to support customer service scenarios, appointment reminders, two-factor authentication, and other real-time communication needs. Azure Communication Services Number Lookup allows you to reliably retrieve number insights before engaging with end-users.
2321

2422

2523
## Number Lookup features
2624

27-
Key features of Azure Communication Services Number Lookup SDKs include:
25+
Key features of Azure Communication Services Number Lookup include:
2826

2927
- **Simple** Our API is easy to integrate with your application. We provide detailed documentation to guide you through the process, and our team of experts is always available to assist you.
3028
- **High Accuracy** We gather data from the most reliable suppliers to ensure that you receive accurate data. Our data is updated regularly to guarantee the highest quality possible.
31-
- **High Velocity** Our API is designed to deliver fast and accurate data, even under high loads. It is optimized for speed and performance to ensure that you always receive the information you need, quickly and reliably.
32-
- **SMS Capability Check** Our API provides you with the associated number type to determine whether or not an SMS can be sent to a particular number. This helps avoid frustrating attempts to send messages to non-SMS capable numbers.
33-
- **Carrier Details** We provide information about the country of destination and carrier information. This can help you estimate potential costs and find alternative messaging methods (e.g. sending an email).
29+
- **High Velocity** Our API is designed to deliver fast and accurate data, even when dealing with high volumes of data. It is optimized for speed and performance to ensure you always receive the information you need quickly and reliably.
30+
- **Number Capability Check** Our API provides the associated number type that generally can help determine if an SMS can be sent to a particular number. This helps to avoid frustrating attempts to send messages to non-SMS-capable numbers.
31+
- **Carrier Details** We provide information about the country of destination and carrier information which helps to estimate potential costs and find alternative messaging methods (e.g., sending an email).
3432

3533
## Value Proposition
3634

3735
The main benefits the solution will provide to ACS customers can be summarized on the below:
38-
- **Reduce Cost:** optimize your communication expenses by sending messages only to phone numbers that are SMS ready and still active
39-
- **Increase efficiency:** better target customers based on subscribers’ data (name, type, location). You can also decide the best communication channel to choose based on status (e.g. SMS or email while roaming instead of calls).
36+
- **Reduce Cost:** Optimize your communication expenses by sending messages only to phone numbers that are SMS-ready
37+
- **Increase efficiency:** Better target customers based on subscribers’ data (name, type, location, etc.). You can also decide on the best communication channel to choose based on status (e.g., SMS or email while roaming instead of calls).
4038

4139
## Key Use Cases
4240

4341
- **Validate the number can receive the SMS before you send it:** Check if a number has SMS capabilities or not and decide if needed to use different communication channels.
44-
*Contoso bank collected the phone numbers of the people who are interested in their services on their site. Contoso wants to send an invite to register for the promotional offer. Contoso checks before sending the link on the offer if SMS is possible channel for the number that customer provided on the site and don’t waste money to send SMS on landline or disconnected mobile numbers.*
42+
*Contoso bank collected the phone numbers of the people who are interested in their services on their site. Contoso wants to send an invite to register for the promotional offer. Contoso checks before sending the link on the offer if SMS is possible channel for the number that customer provided on the site and don’t waste money to send SMS to non mobile numbers.*
4543
- **Estimate the total cost of an SMS campaign before you launch it:** Get the current carrier of the target number and compare that with the list of known carrier surcharges.
4644
*Contoso, a marketing company, wants to launch a large SMS campaign to promote a product. Contoso checks the current carrier details for the different numbers he is targeting with this campaign to estimate the cost based on what ACS is charging him.*
4745

@@ -50,7 +48,7 @@ The main benefits the solution will provide to ACS customers can be summarized o
5048
## Next steps
5149

5250
> [!div class="nextstepaction"]
53-
> [Get started with Number Lookup API](../../quickstarts/number-lookup/getdata.md)
51+
> [Get started with Number Lookup API](../../quickstarts/telephony/number-lookup.md)
5452
5553
The following documents may be interesting to you:
5654

articles/communication-services/concepts/numbers/number-lookup-sdk.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,22 @@
22
title: Number Lookup SDK overview for Azure Communication Services
33
titleSuffix: An Azure Communication Services concept document
44
description: Provides an overview of the Number Lookup SDK and its offerings.
5-
author: hkaraa
5+
author: henikaraa
66
manager: rcole
77
services: azure-communication-services
88

9-
ms.author: hkaraa
9+
ms.author: henikaraa
1010
ms.date: 05/02/2023
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
13-
ms.subservice: number lookup
13+
ms.subservice: phone numbers
1414
---
1515

1616
# Number Lookup SDK overview
1717

1818
[!INCLUDE [Private Preview Notice](../../includes/private-preview-include.md)]
1919

20-
Azure Communication Services Number Lookup SDK can be used to your applications in order to add additional checks before sending and SMS or placing a call.
20+
Azure Communication Services Number Lookup is part of the Phone Numbers SDK. It can be used for your applications to add additional checks before sending and SMS or placing a call.
2121

2222
## Number Lookup SDK capabilities
2323

@@ -26,7 +26,6 @@ The following list presents the set of features which are currently available in
2626
| Group of features | Capability | .NET | JS | Java | Python |
2727
| ----------------- | ------------------------------------------------------------------------------------- | --- | ---- | ---- | ------ |
2828
| Core Capabilities | Get Number Type | ✔️ ||||
29-
| | Get Country of origin (ISO code) | ✔️ ||||
3029
| | Get Carrier registered name | ✔️ ||||
3130
| | Get associated Mobile Network Code, if available(two or three decimal digits used to identify network operator within a country) | ✔️ ||||
3231
| | Get associated Mobile Country Code, if available(three decimal digits used to identify the country of a mobile operator) | ✔️ ||||

0 commit comments

Comments
 (0)