Merge pull request #239457 from henikaraa/hkbranchNLSPP

Hkbranch nlspp

Author: PMEds28

articles/communication-services/concepts/numbers/mvp-use-case.png

@@ -0,0 +1,54 @@
+---
+title: Number Lookup API concepts in Azure Communication Services
+titleSuffix: An Azure Communication Services concept document
+description: Learn about Communication Services Number Lookup API concepts.
+author: henikaraa
+manager: rcole
+services: azure-communication-services
+
+ms.author: henikaraa
+ms.date: 05/02/2023
+ms.topic: conceptual
+ms.service: azure-communication-services
+---
+
+# Number Lookup overview
+
+[!INCLUDE [Private Preview Notice](../../includes/private-preview-include.md)]
+
+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.
+
+
+## Number Lookup features
+
+Key features of Azure Communication Services Number Lookup include:
+
+- **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.
+- **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.
+- **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.
+- **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.
+- **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).
+
+## Value Proposition
+
+The main benefits the solution will provide to ACS customers can be summarized on the below:
+-  **Reduce Cost:** Optimize your communication expenses by sending messages only to phone numbers that are SMS-ready 
+-  **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). 
+
+## Key Use Cases
+
+-  **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. 
+ *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.* 
+-  **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.
+*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.*
+
+![Diagram showing call recording architecture using calling client sdk.](../numbers/mvp-use-case.png)
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Get started with Number Lookup API](../../quickstarts/telephony/number-lookup.md)
+
+The following documents may be interesting to you:
+
+- Familiarize yourself with the [Number Lookup SDK](../numbers/number-lookup-sdk.md)

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

@@ -0,0 +1,39 @@
+---
+title: Number Lookup SDK overview for Azure Communication Services
+titleSuffix: An Azure Communication Services concept document
+description: Provides an overview of the Number Lookup SDK and its offerings.
+author: henikaraa
+manager: rcole
+services: azure-communication-services
+
+ms.author: henikaraa
+ms.date: 05/02/2023
+ms.topic: conceptual
+ms.service: azure-communication-services
+---
+
+# Number Lookup SDK overview
+
+[!INCLUDE [Private Preview Notice](../../includes/private-preview-include.md)]
+
+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.
+
+## Number Lookup SDK capabilities
+
+The following list presents the set of features which are currently available in our SDKs.
+
+| Group of features | Capability                                                                            | .NET  | JS | Java | Python |
+| ----------------- | ------------------------------------------------------------------------------------- | --- | ---- | ---- | ------ |
+| Core Capabilities | Get Number Type                                                          | ✔️   | ❌    | ❌    | ❌      |
+|                   | Get Carrier registered name                                         | ✔️   | ❌    | ❌    | ❌      |
+|                   | Get associated Mobile Network Code, if available(two or three decimal digits used to identify network operator within a country) | ✔️   | ❌    | ❌    | ❌      |
+|                   | Get associated Mobile Country Code, if available(three decimal digits used to identify the country of a mobile operator) | ✔️   | ❌    | ❌    | ❌      |
+| Phone Number      | All number types in E164 format                                      | ✔️   | ❌    | ❌    | ❌      |
+
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Get started with Number Lookup API](../../quickstarts/telephony/number-lookup.md)
+
+- [Number Lookup Concept](../numbers/number-lookup-concept.md)