Rychlý Start: získání a Správa telefonních čísel

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
• Aktivní prostředek služby Communication Services.

Získat telefonní číslo

Čísla zřizování zahájíte tak, že přejdete na prostředek služby Communication Services na Azure Portal.

hledat dostupná Telefon čísla

v nabídce prostředků přejděte do okna Telefon čísla .

Kliknutím na tlačítko získat spusťte průvodce. průvodce v okně Telefon čísla vás provede řadou otázek, které vám pomůžou vybrat telefonní číslo, které nejlépe vyhovuje vašemu scénáři.

Nejdřív budete muset zvolit zemi nebo oblast , kde byste chtěli telefonní číslo zřídit. Po výběru země nebo oblasti budete muset vybrat případ použití , který nejlépe vyhovuje vašim potřebám.

Výběr funkcí telefonního čísla

Konfigurace telefonního čísla je rozdělená do dvou kroků:

1. Výběr typu čísla
2. Výběr možností čísel

Můžete vybrat ze dvou typů telefonních čísel: místní a bezplatná. Když vyberete typ čísla, můžete vybrat funkci.

V našem příkladu jsme vybrali typ bezplatného čísla s voláním pro volání a odesílání a příjem funkcí SMS .

Tady můžete kliknutím na tlačítko Další: čísla v dolní části stránky přizpůsobit telefonní čísla, která chcete zřídit.

Přizpůsobení telefonních čísel

Na stránce čísla si přizpůsobíte telefonní čísla, která chcete zřídit.

V seznamu dostupných kódů oblastí zvolte směrové číslo oblasti a zadejte množství, které chcete zřídit, a kliknutím na Hledat vyhledejte čísla, která splňují vybrané požadavky. Telefonní čísla, která vyhovují vašim potřebám, se zobrazí spolu s jejich měsíčními náklady.

Chcete-li zobrazit souhrn nákupu a umístit objednávku, klikněte na tlačítko Další: Souhrn v dolní části stránky.

koupit Telefon čísla

stránka souhrn zkontroluje typ čísla, funkce, Telefon čísla a celkové měsíční náklady na zřízení telefonních čísel.

Nakonec kliknutím na umístit objednávku v dolní části stránky potvrďte.

Vyhledejte telefonní čísla na Azure Portal

Přejděte ke zdroji komunikačních služeb Azure na Azure Portal:

pokud chcete spravovat telefonní čísla, vyberte v nabídce okno čísla Telefon.

aktualizace možností Telefonho čísla

na stránce Telefon čísla můžete vybrat telefonní číslo a nakonfigurovat ho.

Vyberte funkce z dostupných možností a potom kliknutím na Uložit proveďte výběr.

číslo verze Telefon

Na stránce čísla můžete uvolnit telefonní čísla.

Vyberte telefonní číslo, které chcete uvolnit, a potom klikněte na tlačítko verze .

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
• Nejnovější verze klientské knihovny .NET Core pro váš operační systém.
• Aktivní prostředek komunikační služby a připojovací řetězec. Vytvořte prostředek služby Communications.

Kontrola požadovaných součástí

• V terminálu nebo příkazovém okně spusťte dotnet příkaz a ověřte, zda je nainstalována knihovna klienta .NET.

Nastavení

Vytvoření nové aplikace v C#

V okně konzoly (například cmd, PowerShell nebo bash) použijte dotnet new příkaz k vytvoření nové aplikace konzoly s názvem PhoneNumbersQuickstart . Tento příkaz vytvoří jednoduchý projekt C# "Hello World" s jedním zdrojovým souborem: program. cs.

dotnet new console -o PhoneNumbersQuickstart

Změňte adresář na nově vytvořenou složku aplikace a použijte dotnet build příkaz pro zkompilování aplikace.

cd PhoneNumbersQuickstart
dotnet build

Instalace balíčku

Ještě pořád v adresáři aplikace nainstalujte klientskou knihovnu Azure Communication PhoneNumbers pro balíček .NET pomocí dotnet add package příkazu.

dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0

Přidejte do using horní části programu. cs direktivu, aby zahrnovala obory názvů.

using System;
using System.Linq;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Aktualizujte Main signaturu funkce tak, aby byla asynchronní.

static async Task Main(string[] args)
{
  ...
}

Ověření klienta

Telefon počet klientů se dá ověřit pomocí připojovacího řetězce získaného z prostředků komunikačních služeb Azure v [Azure Portal] [azure_portal].

// Get a connection string to our Azure Communication Services resource.
var connectionString = "<connection_string>";
var client = new PhoneNumbersClient(connectionString);

Telefon počet klientů má také možnost ověřování pomocí ověřování Azure Active Directory. S touto možností, AZURE_CLIENT_SECRET AZURE_CLIENT_ID a AZURE_TENANT_ID proměnné prostředí musí být nastavené pro ověřování.

// Get an endpoint to our Azure Communication Services resource.
var endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Správa telefonních čísel

Vyhledat dostupná telefonní čísla

Aby bylo možné koupit telefonní čísla, je třeba nejprve vyhledat dostupná telefonní čísla. Chcete-li vyhledat telefonní čísla, zadejte směrové číslo oblasti, typ přiřazení, Možnosti telefonního čísla, typ telefonního číslaa množství. Všimněte si, že pro typ telefonního čísla bez poplatků je zadání kódu oblasti volitelné.

var capabilities = new PhoneNumberCapabilities(calling:PhoneNumberCapabilityType.None, sms:PhoneNumberCapabilityType.Outbound);
var searchOptions = new PhoneNumberSearchOptions { AreaCode = "833", Quantity = 1 };

var searchOperation = await client.StartSearchAvailablePhoneNumbersAsync("US", PhoneNumberType.TollFree, PhoneNumberAssignmentType.Application, capabilities, searchOptions);
await searchOperation.WaitForCompletionAsync();

Koupit telefonní čísla

Výsledek hledání telefonních čísel je PhoneNumberSearchResult . Obsahuje, SearchId který se dá předávat do rozhraní API nákupních čísel, aby se získaly čísla ve vyhledávání. Všimněte si, že volání rozhraní API pro telefonní čísla nákupu bude mít za následek poplatek za váš účet Azure.

var purchaseOperation = await client.StartPurchasePhoneNumbersAsync(searchOperation.Value.SearchId);
await purchaseOperation.WaitForCompletionResponseAsync();

Získat telefonní čísla

Po nákupním čísle ho můžete načíst z klienta.

var getPhoneNumberResponse = await client.GetPurchasedPhoneNumberAsync("+14255550123");
Console.WriteLine($"Phone number: {getPhoneNumberResponse.Value.PhoneNumber}, country code: {getPhoneNumberResponse.Value.CountryCode}");

Můžete také načíst všechna zakoupená telefonní čísla.

var purchasedPhoneNumbers = client.GetPurchasedPhoneNumbersAsync();
await foreach (var purchasedPhoneNumber in purchasedPhoneNumbers)
{
    Console.WriteLine($"Phone number: {purchasedPhoneNumber.PhoneNumber}, country code: {purchasedPhoneNumber.CountryCode}");
}

Aktualizace možností telefonního čísla

Po zakoupeném čísle můžete možnosti aktualizovat.

var updateCapabilitiesOperation = await client.StartUpdateCapabilitiesAsync("+14255550123", calling: PhoneNumberCapabilityType.Outbound, sms: PhoneNumberCapabilityType.InboundOutbound);
await updateCapabilitiesOperation.WaitForCompletionAsync();

Telefonní číslo verze

Můžete vydat zakoupené telefonní číslo.

var releaseOperation = await client.StartReleasePhoneNumberAsync("+14255550123");
await releaseOperation.WaitForCompletionResponseAsync();

Spuštění kódu

Spusťte aplikaci z adresáře aplikace pomocí dotnet run příkazu.

dotnet run

Příklad kódu

Ukázkovou aplikaci si můžete stáhnout z GitHub

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
• Java Development Kit (JDK) verze 8 nebo vyšší.
• Apache Maven.- Nasazená Communication Services prostředku a připojovacího řetězce. Vytvořte prostředek Communication Services .

Nastavení

Vytvoření nové aplikace v Javě

Otevřete terminál nebo příkazové okno. Přejděte do adresáře, ve kterém chcete vytvořit aplikaci v Javě. Spuštěním následujícího příkazu vygenerujte projekt Java ze šablony maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Všimněte si, že úloha generate vytvořila adresář se stejným názvem jako artifactId . V tomto adresáři obsahuje adresář src/main/java zdrojový kód projektu, obsahuje zdroj testu a soubor je objektový model pom Project src/test/java directory pom.xml projektu.

Instalace balíčku

Otevřete soubor pom.xml v textovém editoru. Přidejte následující elementy závislosti do skupiny závislostí.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.0.0</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
</dependency>

Nastavení architektury aplikace

Z adresáře projektu:

1. Přejděte do adresáře /src/main/java/com/communication/quickstart.
2. Otevřete soubor App.java v editoru.
3. Nahrazení System.out.println("Hello world!"); příkazu
4. Přidání import direktiv

Začněte následujícím kódem:

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.core.util.polling.LongRunningOperationStatus;
import com.azure.core.util.polling.PollResponse;
import com.azure.core.util.polling.SyncPoller;
import com.azure.identity.*;
import java.io.*;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Phone Numbers Quickstart");
        // Quickstart code goes here
    }
}

Ověření klienta Telefon Numbers

PhoneNumberClientBuilder může používat ověřování Azure Active Directory dat.

// You can find your endpoint and access key from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Další možností je použít k ověření koncový bod a přístupový klíč z komunikačního prostředku.

// You can find your connection string from your resource in the Azure portal
String connectionString = "endpoint=https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Správa Telefon čísel

Vyhledejte Dostupná Telefon čísla.

Pokud si chcete koupit telefonní čísla, musíte nejprve vyhledat dostupná telefonní čísla. Pokud chcete vyhledat telefonní čísla, zadejte kód oblasti, typ přiřazení,možnosti telefonního čísla, typ telefonníhočísla a množství. Všimněte si, že pro typ bezplatného telefonního čísla je zadání kódu oblasti volitelné.

 PhoneNumberCapabilities capabilities = new PhoneNumberCapabilities()
    .setCalling(PhoneNumberCapabilityType.INBOUND)
    .setSms(PhoneNumberCapabilityType.INBOUND_OUTBOUND);
PhoneNumberSearchOptions searchOptions = new PhoneNumberSearchOptions().setAreaCode("833").setQuantity(1);

SyncPoller<PhoneNumberOperation, PhoneNumberSearchResult> poller = phoneNumberClient
    .beginSearchAvailablePhoneNumbers("US", PhoneNumberType.TOLL_FREE, PhoneNumberAssignmentType.APPLICATION, capabilities, searchOptions, Context.NONE);
PollResponse<PhoneNumberOperation> response = poller.waitForCompletion();
String searchId = "";

if (LongRunningOperationStatus.SUCCESSFULLY_COMPLETED == response.getStatus()) {
    PhoneNumberSearchResult searchResult = poller.getFinalResult();
    searchId = searchResult.getSearchId();
    System.out.println("Searched phone numbers: " + searchResult.getPhoneNumbers());
    System.out.println("Search expires by: " + searchResult.getSearchExpiresBy());
    System.out.println("Phone number costs:" + searchResult.getCost().getAmount());
}

Purchase Telefon Numbers

Výsledkem hledání telefonních čísel je PhoneNumberSearchResult. Obsahuje objekt , který lze předat rozhraní API pro čísla nákupů za účelem searchId získání čísel při hledání. Upozorňujeme, že volání rozhraní API pro telefonní čísla k nákupu bude mít za následek poplatky za váš účet Azure.

PollResponse<PhoneNumberOperation> purchaseResponse = phoneNumberClient.beginPurchasePhoneNumbers(searchId, Context.NONE).waitForCompletion();
System.out.println("Purchase phone numbers operation is: " + purchaseResponse.getStatus());

Získání Telefon čísel

Po nákupním čísle ho můžete načíst z klienta.

PurchasedPhoneNumber phoneNumber = phoneNumberClient.getPurchasedPhoneNumber("+14255550123");
System.out.println("Phone Number Country Code: " + phoneNumber.getCountryCode());

Můžete také načíst všechna zakoupená telefonní čísla.

PagedIterable<PurchasedPhoneNumber> phoneNumbers = phoneNumberClient.listPurchasedPhoneNumbers(Context.NONE);
PurchasedPhoneNumber phoneNumber = phoneNumbers.iterator().next();
System.out.println("Phone Number Country Code: " + phoneNumber.getCountryCode());

Aktualizace Telefon čísel

Když máte zakoupené číslo, můžete aktualizovat možnosti.

PhoneNumberCapabilities capabilities = new PhoneNumberCapabilities();
capabilities
    .setCalling(PhoneNumberCapabilityType.INBOUND)
    .setSms(PhoneNumberCapabilityType.INBOUND_OUTBOUND);

SyncPoller<PhoneNumberOperation, PurchasedPhoneNumber> poller = phoneNumberClient.beginUpdatePhoneNumberCapabilities("+18001234567", capabilities, Context.NONE);
PollResponse<PhoneNumberOperation> response = poller.waitForCompletion();
if (LongRunningOperationStatus.SUCCESSFULLY_COMPLETED == response.getStatus()) {
    PurchasedPhoneNumber phoneNumber = poller.getFinalResult();
    System.out.println("Phone Number Calling capabilities: " + phoneNumber.getCapabilities().getCalling()); //Phone Number Calling capabilities: inbound
    System.out.println("Phone Number SMS capabilities: " + phoneNumber.getCapabilities().getSms()); //Phone Number SMS capabilities: inbound+outbound
}

Číslo Telefon verze

Zakoupené telefonní číslo můžete uvolnit.

PollResponse<PhoneNumberOperation> releaseResponse =
    phoneNumberClient.beginReleasePhoneNumber("+14255550123", Context.NONE).waitForCompletion();
System.out.println("Release phone number operation is: " + releaseResponse.getStatus());

Spuštění kódu

Přejděte do adresáře, který obsahujepom.xml a zkompilujte projekt pomocí následujícího mvn příkazu.

mvn compile

Pak sestavte balíček .

mvn package

Spusťte aplikaci mvn spuštěním následujícího příkazu.

mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false

Výstup aplikace popisuje každou dokončenou akci:

Azure Communication Services - Phone Numbers Quickstart

Searched phone numbers: [+18001234567]

Purchase phone numbers operation is: SUCCESSFULLY_COMPLETED

Phone Number Country Code: US

Phone Number Calling capabilities: inbound

Phone Number SMS capabilities: inbound

Release phone number operation is: SUCCESSFULLY_COMPLETED

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
• Python 2,7, 3,5 nebo novější.
• Nasazený prostředek komunikačních služeb a připojovací řetězec. Vytvořte prostředek služby Communications.

Nastavení

Vytvoření nové aplikace v Pythonu

Otevřete okno terminálu nebo příkazového řádku a pro svou aplikaci vytvořte nový adresář a pak na něj přejděte.

mkdir phone-numbers-quickstart && cd phone-numbers-quickstart

Pomocí textového editoru vytvořte soubor s názvem phone_numbers_sample. py v kořenovém adresáři projektu a přidejte následující kód. Do následujících částí přidáváme zbývající kód pro rychlý Start.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Phone Numbers Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

Instalace balíčku

Stále v adresáři aplikace nainstalujte klientskou knihovnu pro správu služby Azure Communication Services pro balíček python pomocí pip install příkazu.

pip install azure-communication-phonenumbers

ověření klienta Telefonch čísel

PhoneNumbersClientje povoleno použít Azure Active Directory ověřování. použití DefaultAzureCredential objektu je nejjednodušší způsob, jak začít s Azure Active Directory a můžete ho nainstalovat pomocí pip install příkazu.

pip install azure-identity

Vytvoření DefaultAzureCredential objektu vyžaduje, abyste měli AZURE_CLIENT_ID , AZURE_CLIENT_SECRET a AZURE_TENANT_ID už nastavené jako proměnné prostředí s odpovídajícími hodnotami z vaší registrované aplikace služby Azure AD.

K rychlému rozpracovanému sestavování těchto proměnných prostředí můžete využít Nastavení instančních objektů z rychléhostartu rozhraní příkazového řádku.

Po instalaci azure-identity knihovny můžeme ověřování klienta i nadále používat.

import os
from azure.communication.phonenumbers import PhoneNumbersClient
from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    print('Azure Communication Services - Phone Numbers Quickstart')
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Případně je možné použít také koncový bod a přístupový klíč z prostředku komunikace k ověření.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

# You can find your connection string from your resource in the Azure portal
connection_string = 'https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<YOUR_ACCESS_KEY>'
try:
    print('Azure Communication Services - Phone Numbers Quickstart')
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Functions

Po PhoneNumbersClient ověření můžeme začít pracovat na různých funkcích, které může dělat.

hledat dostupná Telefon čísla

Aby bylo možné koupit telefonní čísla, je třeba nejprve vyhledat všechna dostupná telefonní čísla. Pokud chcete vyhledat telefonní čísla, zadejte směrové číslo oblasti, typ přiřazení, Možnosti telefonního čísla, typ telefonního číslaa množství (výchozí množství je nastavené na 1). Všimněte si, že pro typ telefonního čísla bez poplatků je zadání kódu oblasti volitelné.

import os
from azure.communication.phonenumbers import PhoneNumbersClient, PhoneNumberCapabilityType, PhoneNumberAssignmentType, PhoneNumberType, PhoneNumberCapabilities
from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    print('Azure Communication Services - Phone Numbers Quickstart')
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
    capabilities = PhoneNumberCapabilities(
        calling = PhoneNumberCapabilityType.INBOUND,
        sms = PhoneNumberCapabilityType.INBOUND_OUTBOUND
    )
    search_poller = phone_numbers_client.begin_search_available_phone_numbers(
        "US",
        PhoneNumberType.TOLL_FREE,
        PhoneNumberAssignmentType.APPLICATION,
        capabilities,
        polling = True
    )
    search_result = search_poller.result()
    print ('Search id: ' + search_result.search_id)
    phone_number_list = search_result.phone_numbers
    print('Reserved phone numbers:')
    for phone_number in phone_number_list:
        print(phone_number)

except Exception as ex:
    print('Exception:')
    print(ex)

koupit Telefon čísla

Výsledek hledání telefonních čísel je PhoneNumberSearchResult . Obsahuje, searchId který se dá předávat do rozhraní API nákupních čísel, aby se získaly čísla ve vyhledávání. Všimněte si, že volání rozhraní API pro telefonní čísla nákupu bude mít za následek poplatek za váš účet Azure.

import os
from azure.communication.phonenumbers import (
    PhoneNumbersClient,
    PhoneNumberCapabilityType,
    PhoneNumberAssignmentType,
    PhoneNumberType,
    PhoneNumberCapabilities
)
from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    print('Azure Communication Services - Phone Numbers Quickstart')
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
    capabilities = PhoneNumberCapabilities(
        calling = PhoneNumberCapabilityType.INBOUND,
        sms = PhoneNumberCapabilityType.INBOUND_OUTBOUND
    )
    search_poller = phone_numbers_client.begin_search_available_phone_numbers(
        "US",
        PhoneNumberType.TOLL_FREE,
        PhoneNumberAssignmentType.APPLICATION,
        capabilities,
        area_code="833",
        polling = True
    )
    search_result = poller.result()
    print ('Search id: ' + search_result.search_id)
    phone_number_list = search_result.phone_numbers
    print('Reserved phone numbers:')
    for phone_number in phone_number_list:
        print(phone_number)

    purchase_poller = phone_numbers_client.begin_purchase_phone_numbers(search_result.search_id, polling = True)
    purchase_poller.result()
    print("The status of the purchase operation was: " + purchase_poller.status())
except Exception as ex:
    print('Exception:')
    print(ex)

Koupit telefonní čísla

Po nákupním čísle ho můžete načíst z klienta.

purchased_phone_number_information = phone_numbers_client.get_purchased_phone_number("+18001234567")
print('Phone number: ' + purchased_phone_number_information.phone_number)
print('Country code: ' + purchased_phone_number_information.country_code)

Můžete také načíst všechna zakoupená telefonní čísla.

purchased_phone_numbers = phone_numbers_client.list_purchased_phone_numbers()
print('Purchased phone numbers:')
for purchased_phone_number in purchased_phone_numbers:
    print(purchased_phone_number.phone_number)

aktualizace možností Telefonho čísla

Můžete aktualizovat možnosti dříve zakoupeného telefonního čísla.

update_poller = phone_numbers_client.begin_update_phone_number_capabilities(
    "+18001234567",
    PhoneNumberCapabilityType.OUTBOUND,
    PhoneNumberCapabilityType.OUTBOUND,
    polling = True
)
update_poller.result()
print('Status of the operation: ' + update_poller.status())

číslo verze Telefon

Můžete vydat zakoupené telefonní číslo.

release_poller = phone_numbers_client.begin_release_phone_number("+18001234567")
release_poller.result()
print('Status of the operation: ' + release_poller.status())

Spuštění kódu

V příkazovém řádku konzoly přejděte do adresáře, který obsahuje soubor phone_numbers_sample. py a spusťte následující příkaz Pythonu pro spuštění aplikace.

python phone_numbers_sample.py

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
• Node.js Verze Active LTS a Maintenance LTS (doporučuje se verze 8.11.1 a 10.14.1).
• Aktivní prostředek Communication Services připojovací řetězec. Vytvořte prostředek Communication Services .

Kontrola předpokladů

• V terminálu nebo v příkazovém okně spusťte příkaz a node --version zkontrolujte, Node.js je nainstalovaná.

Nastavení

Vytvoření nové Node.js aplikace

Nejprve otevřete terminál nebo příkazové okno, vytvořte nový adresář pro vaši aplikaci a přejděte do něj.

mkdir phone-numbers-quickstart && cd phone-numbers-quickstart

Spuštěním npm init -y vytvořte soubor package.json s výchozím nastavením.

npm init -y

V kořenovém adresářiphone-numbers-quickstart.js, který jste právě vytvořili, vytvořte soubor s názvem . Přidejte do něj následující fragment kódu:

async function main() {
    // quickstart code will here
}

main();

Instalace balíčku

Pomocí příkazu npm install nainstalujte klientskou knihovnu Azure Communication Services Telefon Numbers pro JavaScript.

npm install @azure/communication-phone-numbers --save

Možnost --save přidá knihovnu jako závislost do souboru package.json.

Ověření klienta

Importujte PhoneNumbersClient z klientské knihovny a vytvořte instanci pomocí připojovacího řetězce. Následující kód načte připojovací řetězec pro prostředek z proměnné prostředí s názvem COMMUNICATION_SERVICES_CONNECTION_STRING . Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.

Na začátek souboru přidejte následujícíphone-numbers-quickstart.js:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code demonstrates how to fetch your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Správa telefonních čísel

Vyhledání dostupných telefonních čísel

Pokud si chcete koupit telefonní čísla, musíte nejprve vyhledat dostupná telefonní čísla. Pokud chcete vyhledat telefonní čísla, zadejte kód oblasti, typ přiřazení,možnosti telefonního čísla, typ telefonníhočísla a množství. Všimněte si, že pro typ bezplatného telefonního čísla je zadání kódu oblasti volitelné.

Do funkce přidejte následující fragment main kódu:

/**
 * Search for Available Phone Number
 */

// Create search request
const searchRequest = {
    countryCode: "US",
    phoneNumberType: "tollFree",
    assignmentType: "application",
    capabilities: {
      sms: "outbound",
      calling: "none"
    },
    areaCode: "833",
    quantity: 1
  };

const searchPoller = await phoneNumbersClient.beginSearchAvailablePhoneNumbers(searchRequest);

// The search is underway. Wait to receive searchId.
const { searchId, phoneNumbers } = await searchPoller.pollUntilDone();
const phoneNumber = phoneNumbers[0];

console.log(`Found phone number: ${phoneNumber}`);
console.log(`searchId: ${searchId}`);

Nákup telefonního čísla

Výsledkem hledání telefonních čísel je PhoneNumberSearchResult . Obsahuje objekt , který lze předat rozhraní API pro čísla nákupů za účelem searchId získání čísel při hledání. Upozorňujeme, že volání rozhraní API pro telefonní čísla k nákupu bude mít za následek poplatky za váš účet Azure.

Do funkce přidejte následující fragment main kódu:

/**
 * Purchase Phone Number
 */

const purchasePoller = await phoneNumbersClient.beginPurchasePhoneNumbers(searchId);

// Purchase is underway.
await purchasePoller.pollUntilDone();
console.log(`Successfully purchased ${phoneNumber}`);

Aktualizace možností telefonního čísla

Když je telefonní číslo zakoupené, přidejte následující kód, který aktualizuje jeho možnosti:

/**
 * Update Phone Number Capabilities
 */

// Create update request.
// This will update phone number to send and receive sms, but only send calls.
const updateRequest = {
  sms: "inbound+outbound",
  calling: "outbound"
};

const updatePoller = await phoneNumbersClient.beginUpdatePhoneNumberCapabilities(
  phoneNumber,
  updateRequest
);

// Update is underway.
await updatePoller.pollUntilDone();
console.log("Phone number updated successfully.");

Získání zakoupených telefonních čísel

Po nákupním čísle ho můžete načíst z klienta. Do funkce přidejte následující main kód, který vám získejte telefonní číslo, které jste právě zakoupili:

/**
 * Get Purchased Phone Number
 */

const { capabilities } = await phoneNumbersClient.getPurchasedPhoneNumber(phoneNumber);
console.log("These capabilities:", capabilities, "should be the same as these:", updateRequest, ".");

Můžete také načíst všechna zakoupená telefonní čísla.

const purchasedPhoneNumbers = await phoneNumbersClient.listPurchasedPhoneNumbers();

for await (const purchasedPhoneNumber of purchasedPhoneNumbers) {
  console.log(`Phone number: ${purchasedPhoneNumber.phoneNumber}, country code: ${purchasedPhoneNumber.countryCode}.`);
}

Telefonní číslo pro vydání verze

Zakoupené telefonní číslo teď můžete uvolnit. Do funkce přidejte následující fragment main kódu:

/**
 * Release Purchased Phone Number
 */

const releasePoller = await phoneNumbersClient.beginReleasePhoneNumber(phoneNumber);

// Release is underway.
await releasePoller.pollUntilDone();
console.log("Successfully release phone number.");

Spuštění kódu

Pomocí příkazu node spusťte kód, který jste přidali dophone-numbers-quickstart.jssouboru.

node phone-numbers-quickstart.js