Rychlý start: Získání a správa telefonních čísel

Článek
11/09/2024

Důležité

Možnosti sms a veřejné telefonní sítě závisí na telefonním čísle, které používáte, a na zemi nebo oblasti, ve které pracujete podle fakturační adresy Azure. Další informace najdete v dokumentaci k způsobilosti k předplatnému.

Důležité

V případě velkých objemových objednávek nebo v případě nedostupnosti požadovaného telefonního čísla navštivte tuto stránku a požádejte o další pomoc.

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Aktivní prostředek komunikační služby.

Získání telefonního čísla

Pokud chcete začít zřizovat čísla, přejděte na webu Azure Portal k prostředku komunikační služby.

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

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

Snímek obrazovky zobrazující telefonní stránku prostředku komunikační služby

Stisknutím tlačítka Získat spusťte průvodce. Průvodce v okně Telefonní čísla vás provede řadou otázek, které vám pomůžou zvolit telefonní číslo, které nejlépe vyhovuje vašemu scénáři.

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

Snímek obrazovky zobrazující zobrazení Získat telefonní čísla

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

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

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

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

V našem příkladu jsme vybrali typ bezplatné linky s funkcemi Volání a Odesílání a přijímání SMS .

Snímek obrazovky zobrazující zobrazení Vybrat funkce

Tady klikněte na tlačítko Další: Čísla v dolní části stránky a upravte 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.

Snímek obrazovky se stránkou výběru Čísla

Poznámka:

V tomto rychlém startu se zobrazuje tok přizpůsobení typu číslo bezplatné linky . Prostředí se může mírně lišit, pokud jste zvolili typ místního čísla, ale konečný výsledek bude stejný.

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

Snímek obrazovky se stránkou výběru Čísla s rezervovanými čísly

Poznámka:

Dostupnost závisí na typu číslo, umístění a vybraných funkcích. Čísla jsou vyhrazena po krátkou dobu před vypršením platnosti transakce. Pokud platnost transakce vyprší, budete muset čísla znovu vybrat.

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

Nákup telefonních čísel

Na stránce souhrnu se zkontroluje typ čísla, funkce, telefonní čísla a celkové měsíční náklady, aby se telefonní čísla zřídila.

Poznámka:

Zobrazené ceny jsou měsíční opakované poplatky , které pokrývají náklady na pronájem vybraného telefonního čísla vám. V tomto zobrazení nejsou zahrnuty náklady na průběžné platby , které vzniknou při volání nebo přijímání volání. Ceníky jsou k dispozici tady. Tyto náklady závisí na typu a cílech, které se volaly. Například cena za minutu volání z regionálního čísla Seattlu do regionálního čísla v New Yorku a volání ze stejného čísla na mobilní číslo Ve Velké Británii se může lišit.

Nakonec kliknutím na Možnost Umístit objednávku v dolní části stránky potvrďte.

Snímek obrazovky zobrazující stránku Souhrn se zobrazenými měsíčními náklady typu Číslo, Funkce, Telefonní čísla a Celkové měsíční náklady

Vyhledání telefonních čísel na webu Azure Portal

Na webu Azure Portal přejděte k prostředku služby Azure Communication Services:

Snímek obrazovky zobrazující hlavní stránku prostředku komunikační služby

Výběrem okna Telefonní čísla v nabídce můžete spravovat vaše telefonní čísla.

Snímek obrazovky se stránkou telefonního čísla prostředku komunikační služby

Poznámka:

Zobrazení zřízených čísel na této stránce může trvat několik minut.

Aktualizace možností telefonního čísla

Na stránce Telefonní čísla můžete vybrat telefonní číslo, které chcete nakonfigurovat.

Snímek obrazovky se stránkou funkcí aktualizace

Vyberte funkce z dostupných možností a potom kliknutím na uložit výběr použijte.

Telefonní číslo vydané verze

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

Snímek obrazovky se stránkou telefonních čísel vydaných verzí

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

Důležité

Tato funkce služeb Azure Communication Services je aktuálně ve verzi Preview.

Rozhraní API a sady SDK verze Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti.

Další informace najdete v dodatečných podmínkách použití pro verze Preview Microsoft Azure.

Služba Azure Communication Services představuje nové uživatelské prostředí pro nákup telefonních čísel. Toto prostředí se právě letí a při nákupu telefonního čísla na webu Azure Portal vás k tomuto prostředí může zavádět. Pokud máte zpětnou vazbu k tomuto prostředí, neváhejte ho předat prostřednictvím tlačítka Poskytnout zpětnou vazbu na webu Azure Portal.

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Aktivní prostředek komunikační služby.

Zakoupení telefonního čísla

Na webu Azure Portal přejděte k prostředku komunikační služby.
V přehledu prostředků Komunikační služby vyberte v nabídce vlevo možnost Telefonní čísla.
Vyberte Získat v levém horním rohu stránky a kupte si telefonní číslo. Výběrem tohoto příkazu spustíte našeho průvodce nákupy:
Zvolte zemi nebo oblast, ve které chcete zřídit telefonní číslo. Dostupnost země nebo oblasti je založená na umístění fakturace pro vaše předplatné Azure. Další informace o tom, jaká čísla jsou k dispozici pro každou zemi nebo oblast, najdete tady. V dalším kroku zvolíte typ čísla. Můžete si vybrat ze dvou typů telefonních čísel: místní a bezplatná linka.
Výběrem možnosti Hledat můžete načíst čísla, která splňují vybraná kritéria. K vyhledání čísla, které vyhovuje vašim potřebám, máte různé filtry, mezi které patří:
- Případ použití: Toto číslo slouží k volání z aplikace (A2P) nebo z lidského agenta (P2P).
- Volání: Toto je určení možností volání, které chcete pro své telefonní číslo: Volání a/nebo přijímání hovorů.
- SMS: Toto je pro určení možností SMS, které chcete pro své telefonní číslo: Odesílání a/nebo příjem SMS zpráv.
- Vlastní: Můžete také přidat vlastní filtry, abyste získali určitou předponu nebo sadu číslic v telefonním čísle.
Jakmile najdete telefonní číslo nebo čísla podle svého výběru, vyberte Přidat do košíku a čísla se budou uchovávat v telefonním košíku. Tato čísla se uchovávají po dobu 16 minut, než se košík automaticky vymaže.

Poznámka:

Zobrazené ceny jsou měsíční opakované poplatky , které pokrývají náklady na pronájem vybraného telefonního čísla vám. V tomto zobrazení nejsou zahrnuty náklady na průběžné platby , které vzniknou při volání nebo přijímání volání. Ceníky jsou k dispozici tady. Tyto náklady závisí na typu a cílech, které se volaly. Například cena za minutu volání z regionálního čísla Seattlu do regionálního čísla v New Yorku a volání ze stejného čísla na mobilní číslo Ve Velké Británii se může lišit.
Vyberte Další a zkontrolujte nákup. Nákup dokončíte tak, že vyberete Koupit.
Zakoupená čísla najdete zpět na stránce Telefonní čísla . Zřízení čísel může trvat několik minut.

Aktualizace možností telefonního čísla

Na stránce Telefonní čísla můžete vybrat telefonní číslo, které chcete nakonfigurovat.

Vyberte funkce z dostupných možností a pak vyberte Uložit , aby se výběr použil.

Telefonní číslo vydané verze

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

Vyberte telefonní číslo, které chcete uvolnit, a pak vyberte tlačítko Uvolnit .

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
Nainstalujte Azure CLI.
Zakoupené telefonní číslo.

Nastavení

Přidání rozšíření

Pomocí příkazu přidejte rozšíření Azure Communication Services pro Azure CLI az extension .

az extension add --name communication

Budete se muset přihlásit k Azure CLI. Můžete se přihlásit spuštěním az login příkazu z terminálu a zadat své přihlašovací údaje.

Operace

Seznam zakoupených telefonních čísel

Spuštěním následujícího příkazu načtěte všechna zakoupená telefonní čísla.

az communication phonenumber list --connection-string "<yourConnectionString>"

Proveďte tuto náhradu v kódu:

Nahraďte <yourConnectionString> připojovací řetězec.

Získání podrobností o zakoupených telefonních číslech

Spuštěním následujícího příkazu získejte podrobnosti o telefonním čísle zakoupeného telefonního čísla.

az communication phonenumber show --phonenumber <purchasedPhoneNumber> --connection-string "<yourConnectionString>"

Proveďte tyto nahrazení v kódu:

Nahraďte <purchasedPhoneNumber> telefonním číslem přidruženým k vašemu prostředku komunikační služby.
Nahraďte <yourConnectionString> připojovací řetězec.

Poznámka:

Možnost Azure CLI poskytuje funkce pouze pro výpis a zobrazení telefonních čísel. Nepodporuje jiné operace, jako je vyhledávání, nákup, úpravy nebo vydávání telefonních čísel.

(Volitelné) Použití operací telefonních čísel Azure CLI bez předání připojovací řetězec

Proměnnou AZURE_COMMUNICATION_CONNECTION_STRING prostředí můžete nakonfigurovat tak, aby používala operace telefonních čísel Azure CLI, aniž byste museli předávat --connection_string připojovací řetězec. Pokud chcete nakonfigurovat proměnnou prostředí, otevřete okno konzoly a na následujících kartách vyberte operační systém. Nahraďte <yourConnectionString> skutečnými připojovací řetězec.

Otevřete okno konzoly a zadejte následující příkaz:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Po přidání proměnné prostředí možná bude nutné restartovat všechny spuštěné programy, které budou potřebovat číst tuto proměnnou prostředí, a to včetně okna konzoly. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.

Upravte proměnnou .zshrcprostředí a přidejte ji:

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Po přidání proměnné prostředí spusťte v okně konzoly příkaz source ~/.zshrc, aby se změna projevila. Pokud jste vytvořili proměnnou prostředí s otevřeným integrovaným vývojovém prostředím, možná budete muset zavřít a znovu otevřít editor, integrované vývojové prostředí nebo prostředí, aby bylo možné získat přístup k proměnné.

Upravte proměnnou .bash_profileprostředí a přidejte ji:

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Po přidání proměnné prostředí spusťte v okně konzoly příkaz source ~/.bash_profile, aby se změna projevila. Pokud jste vytvořili proměnnou prostředí s otevřeným integrovaným vývojovém prostředím, možná budete muset zavřít a znovu otevřít editor, integrované vývojové prostředí nebo prostředí, aby bylo možné získat přístup k proměnné.

Poznámka:

Vyhledání finalizovaného kódu pro tento rychlý start na GitHubu

Požadavky

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

Kontrola požadovaných součástí

V terminálu nebo příkazovém okně spusťte dotnet příkaz a zkontrolujte, jestli je nainstalovaná klientská knihovna .NET.

Nastavení

Vytvoření nové aplikace jazyka C#

V okně konzoly (například cmd, PowerShell nebo Bash) pomocí dotnet new příkazu vytvořte novou konzolovou aplikaci s názvem PhoneNumbersQuickstart. Tento příkaz vytvoří jednoduchý projekt "Hello World" C# s jedním zdrojovým souborem: Program.cs.

dotnet new console -o PhoneNumbersQuickstart

Změňte adresář na nově vytvořenou složku aplikace a pomocí dotnet build příkazu zkompilujte aplikaci.

cd PhoneNumbersQuickstart
dotnet build

Nainstalujte balíček .

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 direktivu using na začátek Program.cs , aby zahrnovala obory názvů.

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

Aktualizujte Main podpis funkce tak, aby byl asynchronní.

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

Ověření klienta

Klienti telefonního čísla se dají ověřit pomocí připojovací řetězec získané z prostředků Azure Communication Services na webu Azure Portal.

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

Klienti telefonního čísla mají také možnost ověřování pomocí ověřování Microsoft Entra. U této možnosti AZURE_CLIENT_SECRETAZURE_CLIENT_ID je AZURE_TENANT_ID potřeba nastavit proměnné prostředí 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

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

Abyste si mohli koupit telefonní čísla, musíte nejdřív vyhledat dostupná telefonní čísla. Pokud chcete vyhledat telefonní čísla, zadejte směrové číslo oblasti, typ přiřazení, funkce telefonního čísla, typ telefonního čísla a množství. Všimněte si, že pro typ bezplatného telefonního čísla je poskytnutí směrového čísla 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();

Nákup telefonních čísel

Výsledkem hledání telefonních čísel je PhoneNumberSearchResult. Obsahuje kód SearchId , který lze předat do rozhraní API nákupních čísel, aby bylo možné získat čísla ve vyhledávání. Všimněte si, že volání rozhraní API pro nákupní telefonní čísla bude účtovat poplatky za váš účet Azure.

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

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

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

S zakoupeným číslem můžete aktualizovat možnosti.

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

Telefonní číslo vydané verze

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

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

Ukázka kódu

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

Poznámka:

Vyhledání finalizovaného kódu pro tento rychlý start na GitHubu

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Java Development Kit (JDK) verze 8 nebo novější.
Apache Maven
Nasazený prostředek komunikační služby a připojovací řetězec. Vytvořte prostředek komunikační služby.

Nastavení

Vytvoření nové aplikace v Javě

Otevřete terminál nebo příkazové okno. Přejděte do adresáře, do kterého 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 generování vytvořila adresář se stejným názvem jako .artifactId V tomto adresáři obsahuje adresář src/main/java zdrojový kód projektu, src/test/java directory zdroj testů a pom.xml soubor je projektový objektový model nebo POM projektu.

Nainstalujte balíček .

Otevřete soubor pom.xml v textovém editoru. Do skupiny závislostí přidejte následující prvky 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:

Přejděte do adresáře /src/main/java/com/communication/quickstart .
Otevření souboru App.java v editoru
System.out.println("Hello world!"); Nahrazení příkazu
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 telefonních čísel

PhoneNumberClientBuilder je povolený pro použití ověřování Microsoft Entra.

// 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();

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

// 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 telefonních čísel

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

 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());
}

Nákup telefonních čísel

Výsledkem hledání telefonních čísel je PhoneNumberSearchResult. Obsahuje kód searchId , který lze předat do rozhraní API nákupních čísel, aby bylo možné získat čísla ve vyhledávání. Všimněte si, že volání rozhraní API pro nákupní telefonní čísla bude účtovat 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ískat telefonní čísla

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 možností telefonního čísla

S zakoupeným číslem 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
}

Telefonní číslo vydané 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

Pomocí následujícího mvn příkazu přejděte do adresáře obsahujícího soubor pom.xml a zkompilujte projekt.

mvn compile

Pak balíček sestavte.

mvn package

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

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

Poznámka:

Vyhledání finalizovaného kódu pro tento rychlý start na GitHubu

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Python 3.7+.
Nasazený prostředek komunikační služby a připojovací řetězec. Vytvořte prostředek komunikační služby.

Nastavení

Vytvoření nové aplikace v Pythonu

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

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. Zbývající kód rychlého startu přidáme v následujících částech.

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)

Nainstalujte balíček .

V adresáři aplikace nainstalujte pomocí příkazu klientskou knihovnu pro správu služeb Azure Communication Services pro balíček Pythonu pip install .

pip install azure-communication-phonenumbers

Ověření klienta telefonních čísel

Je PhoneNumbersClient povoleno používat ověřování Microsoft Entra. Použití objektu DefaultAzureCredential je nejjednodušší způsob, jak začít s Microsoft Entra ID a můžete ho pip install nainstalovat pomocí příkazu.

pip install azure-identity

Vytvoření objektu DefaultAzureCredential vyžaduje, abyste měli AZURE_CLIENT_ID, AZURE_CLIENT_SECRETa AZURE_TENANT_ID již nastaven jako proměnné prostředí s odpovídajícími hodnotami z vaší registrované aplikace Microsoft Entra.

Pokud chcete rychle začít s získáním těchto proměnných prostředí, můžete postupovat podle pokynů k nastavení instančních objektů z rychlého startu rozhraní příkazového řádku.

Jakmile knihovnu azure-identity nainstalujete, můžeme pokračovat v ověřování klienta.

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 také možné použít koncový bod a přístupový klíč z komunikačního prostředku 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)

Funkce

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

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

Abyste si mohli koupit telefonní čísla, musíte nejdřív vyhledat všechna dostupná telefonní čísla. Pokud chcete vyhledat telefonní čísla, zadejte směrové číslo oblasti, typ přiřazení, funkce telefonního čísla, typ telefonního čísla a množství (výchozí množství je nastavené na 1). Všimněte si, že pro typ bezplatného telefonního čísla je poskytnutí směrového čísla 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)

Nákup telefonních čísel

Výsledkem hledání telefonních čísel je PhoneNumberSearchResult. Obsahuje kód searchId , který lze předat do rozhraní API nákupních čísel, aby bylo možné získat čísla ve vyhledávání. Všimněte si, že volání rozhraní API pro nákupní telefonní čísla bude účtovat poplatky 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)

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

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í telefonního čí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())

Telefonní číslo vydané verze

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

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

Z příkazového řádku konzoly přejděte do adresáře obsahujícího soubor phone_numbers_sample.py a spusťte aplikaci spuštěním následujícího příkazu Pythonu.

python phone_numbers_sample.py

Poznámka:

Vyhledání finalizovaného kódu pro tento rychlý start na GitHubu

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Node.js verze LTS active LTS a maintenance LTS (doporučuje se verze 8.11.1 a 10.14.1).
Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.

Kontrola požadovaných součástí

V terminálu nebo příkazovém okně spusťte kontrolu node --version , jestli je nainstalovaná Node.js.

Nastavení

Vytvoření nové aplikace Node.js

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

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

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

npm init -y

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

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

main();

Nainstalujte balíček .

npm install Pomocí příkazu nainstalujte klientskou knihovnu telefonních čísel služeb Azure Communication Services pro JavaScript.

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

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

Ověření klienta

Importujte PhoneNumbersClient z klientské knihovny a vytvořte instanci pomocí svého připojovací řetězec. 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 phone-numbers-quickstart.js přidejte následující kód:

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

Do funkce main přidejte následující fragment 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}`);

Koupit telefonní číslo

Do funkce main přidejte následující fragment 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

Po zakoupení telefonního čísla přidejte následující kód pro aktualizaci svých možností:

/**
 * 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. Přidejte do funkce main následující kód, abyste získali 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 vydané verze

Zakoupené telefonní číslo teď můžete uvolnit. Do své main funkce přidejte následující fragment 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

node Pomocí příkazu spusťte kód, který jste přidali do souboru phone-numbers-quickstart.js.

node phone-numbers-quickstart.js

Řešení problému

Běžné dotazy a problémy:

Po vydání telefonního čísla se telefonní číslo zobrazí v prostředku služby ACS na webu Azure Portal až do konce fakturačního období. Také se nedá znovu použít až do konce fakturačního období.
Po odstranění prostředku komunikační služby se telefonní čísla přidružená k ho prostředku automaticky uvolní současně.

Další kroky

V tomto rychlém startu jste se naučili:

Zakoupení telefonního čísla
Správa telefonního čísla
Uvolnění telefonního čísla
Odeslání aplikace pro ověření bezplatnou bezplatnou linkou (viz, jestli je to povinné)

Odeslání zprávy SMS

Ověření bezplatnou bezplatnou linkou

Vytvoření pracovního postupu pro odchozí hovory pomocí zakoupených telefonních čísel

Začínáme s voláním v aplikacích

Sdílet prostřednictvím

Rychlý start: Získání a správa telefonních čísel

Požadavky

Získání telefonního čísla

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

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

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

Nákup telefonních čísel

Vyhledání telefonních čísel na webu Azure Portal

Aktualizace možností telefonního čísla

Telefonní číslo vydané verze

Požadavky

Zakoupení telefonního čísla

Aktualizace možností telefonního čísla

Telefonní číslo vydané verze

Požadavky

Nastavení

Přidání rozšíření

Přihlášení k Azure CLI

Operace

Seznam zakoupených telefonních čísel

Získání podrobností o zakoupených telefonních číslech

(Volitelné) Použití operací telefonních čísel Azure CLI bez předání připojovací řetězec

Požadavky

Kontrola požadovaných součástí

Nastavení

Vytvoření nové aplikace jazyka C#

Nainstalujte balíček .

Ověření klienta

Správa telefonních čísel

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

Nákup telefonních čísel

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

Aktualizace možností telefonního čísla

Telefonní číslo vydané verze

Spuštění kódu

Ukázka kódu

Požadavky

Nastavení

Vytvoření nové aplikace v Javě

Nainstalujte balíček .

Nastavení architektury aplikace

Ověření klienta telefonních čísel

Správa telefonních čísel

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

Nákup telefonních čísel

Získat telefonní čísla

Aktualizace možností telefonního čísla

Telefonní číslo vydané verze

Spuštění kódu

Požadavky

Nastavení

Vytvoření nové aplikace v Pythonu

Nainstalujte balíček .

Ověření klienta telefonních čísel

Funkce

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

Nákup telefonních čísel

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

Aktualizace možností telefonního čísla

Telefonní číslo vydané verze

Spuštění kódu

Požadavky

Kontrola požadovaných součástí

Nastavení

Vytvoření nové aplikace Node.js

Nainstalujte balíček .

Ověření klienta

Správa telefonních čísel

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

Koupit telefonní číslo

Aktualizace možností telefonního čísla

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

Telefonní číslo vydané verze

Spuštění kódu

Řešení problému

Další kroky

Váš názor

Další materiály