Megosztás a következőn keresztül:

Rövid útmutató: Telefonszámok lekérése és kezelése

  • Cikk

Fontos

Az SMS és a PSTN képességei a használt telefonszámtól és az Azure számlázási címétől függően működő országtól/régiótól függenek. További információkért tekintse meg az előfizetés jogosultsági dokumentációját.

Fontos

Nagy mennyiségű megrendelés esetén vagy ha a kívánt telefonszám nem érhető el, további segítségért látogasson el erre az oldalra.

Előfeltételek

Telefonszám lekérése

A számok kiépítésének megkezdéséhez nyissa meg a Communication Services-erőforrást az Azure Portalon.

A Communication Services-erőforrás főoldalát bemutató képernyőkép.

Elérhető Telefon számok keresése

Lépjen a Telefon Számok panelre az erőforrásmenüben.

Képernyőkép a Communication Services-erőforrás telefonlapjáról.

A varázsló elindításához nyomja le a Beolvasás gombot. A Telefon számok panel varázslója végigvezeti önt egy sor olyan kérdésen, amely segít kiválasztani a forgatókönyvnek leginkább megfelelő telefonszámot.

Először ki kell választania azt az országot/régiót , ahol ki szeretné adni a telefonszámot. Az Ország/régió kiválasztása után ki kell választania a használati esetet, amely a legjobban megfelel az igényeinek.

Képernyőkép a Telefonszámok lekérése nézetről.

A telefonszám-funkciók kiválasztása

A telefonszám konfigurálása két lépésből áll:

  1. A számtípus kiválasztása
  2. A számképességek kiválasztása

Két telefonszámtípus közül választhat: helyi és ingyenes. Amikor kiválasztott egy számtípust, kiválaszthatja a funkciót.

A példánkban egy ingyenes számtípust választottunk a Hívások kezdeményezése és AZ SMS küldése és fogadása funkcióval.

Képernyőkép a Funkciók kiválasztása nézetről.

Innen kattintson a Lap alján található Tovább: Számok gombra a kiosztani kívánt telefonszám(ok) testreszabásához.

Telefonszámok testreszabása

A Számok lapon testre szabhatja a kiosztani kívánt telefonszám(ok) számát.

Képernyőkép a Számok kijelölési oldalról.

Feljegyzés

Ez a rövid útmutató az ingyenes szám típusú testreszabási folyamatot mutatja be. A felület kissé eltérő lehet, ha a Helyi szám típust választotta, de a végeredmény ugyanaz lesz.

Válassza ki a területkódot az elérhető területkódok listájából, és adja meg a kiépíteni kívánt mennyiséget, majd a Keresés gombra kattintva keresse meg a kiválasztott követelményeknek megfelelő számokat. Az igényeinek megfelelő telefonszámok a havi költségekkel együtt jelennek meg.

Képernyőkép a Számok kijelölési oldalról fenntartott számokkal.

Feljegyzés

A rendelkezésre állás a Szám típusától, helyétől és a kiválasztott funkcióktól függ. A számok a tranzakció lejárata előtt rövid időre vannak fenntartva. Ha a tranzakció lejár, újra ki kell választania a számokat.

A vásárlás összegzésének megtekintéséhez és a megrendelés leadásához kattintson a Lap alján található Tovább: Összegzés gombra.

Vásárlás Telefon számok

Az összefoglaló oldal áttekinti a telefonszámok kiosztásának számtípusát, funkcióit, Telefon számait és teljes havi költségét.

Feljegyzés

A megjelenített árak a havi ismétlődő díjak , amelyek fedezik a kiválasztott telefonszám bérlésének költségét. Ez a nézet nem tartalmazza a használatalapú fizetés költségeit , amelyek a hívások indításakor vagy fogadásakor merülnek fel. Az árlisták itt érhetők el. Ezek a költségek a szám típusától és a hívott célhelyektől függnek. Például egy seattle-i regionális számról new york-i regionális számra irányuló hívás percenkénti ára, és az ugyanabból a számból egy egyesült királyságbeli mobilszámra irányuló hívás eltérő lehet.

Végül kattintson a Megrendelés gombra a lap alján a megerősítéshez.

Képernyőkép az Összegző oldalról, amelyen a Szám típus, a Szolgáltatások, a Telefon Számok és a Teljes havi költség látható.

Telefonszámok keresése az Azure Portalon

Lépjen az Azure Communication Services-erőforráshoz az Azure Portalon:

A Communication Services-erőforrás főoldalát bemutató képernyőkép.

A telefonszámok kezeléséhez válassza a Telefon Számok panelt a menüben.

Képernyőkép a Communication Services-erőforrás telefonszámlapjáról.

Feljegyzés

Eltarthat néhány percig, amíg a kiosztott számok megjelennek ezen az oldalon.

Telefon Szám képességeinek frissítése

A Telefon Számok lapon kiválaszthat egy telefonszámot a konfigurálásához.

Képernyőkép a frissítési funkciók oldalról.

Válassza ki az elérhető lehetőségek közül a funkciókat, majd kattintson a Mentés gombra a kijelölés alkalmazásához.

Kiadási Telefon száma

A Számok lapon telefonszámokat adhat ki.

Képernyőkép a kiadási telefonszámok oldalról.

Válassza ki a kiadni kívánt telefonszámot, majd kattintson a Kiadás gombra.

Fontos

Az Azure Communication Services ezen funkciója jelenleg előzetes verzióban érhető el.

Az előzetes verziójú API-k és SDK-k szolgáltatásszintű szerződés nélkül érhetők el. Javasoljuk, hogy éles számítási feladatokhoz ne használja őket. Előfordulhat, hogy egyes funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek.

További információkért tekintse át a Microsoft Azure Előzetes verzió kiegészítő használati feltételeit.

Az Azure Communication Services új felhasználói felületet vezet be a telefonszámok vásárlásához. Ez a felhasználói élmény jelenleg is elérhető, és előfordulhat, hogy ezt a felhasználói élményt akkor tapasztalja meg, amikor telefonszámot vásárol az Azure Portalon. Ha visszajelzést kap erről a felületről, ne habozzon, hogy az Azure Portal bővítmény Visszajelzés küldése gombján keresztül adja meg.

Előfeltételek

Telefonszám vásárlása

  1. Lépjen a Kommunikációs szolgáltatás erőforrásához az Azure Portalon.

    A Communication Services-erőforrás főoldalát bemutató képernyőkép.

  2. A Communication Services-erőforrás áttekintésében válassza a bal oldali menü "Telefon számok" elemét.

    Képernyőkép a Communication Services-erőforrás telefonszámainak oldalról.

  3. A telefonszám megvásárlásához válassza a Lap bal felső részén található Beolvasás lehetőséget. Ha ezt választja, elindítja a vásárlási varázslót:

    Képernyőkép a telefonszám bevásárlókocsi keresővarázslójáról.

  4. Válassza ki azt az országot/régiót , ahol ki szeretné adni a telefonszámot. Az ország rendelkezésre állása az Azure-előfizetés számlázási helyétől függ. Az egyes országok számáról itt talál további információt. Ezután kiválasztja a számtípust. Két telefonszámtípus közül választhat: helyi és ingyenes.

  5. Válassza a Keresés lehetőséget a kiválasztott feltételeknek megfelelő számok lekéréséhez. Különböző szűrőkkel keresheti meg az igényeinek megfelelő számot, többek között az alábbiakat:

    • Használati eset: Ez arra vonatkozik, hogy ezt a számot használja-e egy alkalmazásból (A2P) vagy egy emberi ügynökből (P2P) való híváshoz.
    • Hívás: Ez a telefonszámhoz használni kívánt hívási képességek meghatározására használható: hívások kezdeményezése és/vagy hívások fogadása.
    • SMS: Ez a telefonszámhoz használni kívánt SMS-képességek meghatározására használható: SMS-üzenetek küldése és/vagy fogadása.
    • Egyéni: Egyéni szűrőket is hozzáadhat, hogy lekérjen egy bizonyos előtagot vagy számjegykészletet a telefonszámában.

    Képernyőkép a telefonszám-vásárlási oldalról az elérhető telefonszámokkal.

  6. Miután megtalálta a kiválasztott telefonszámot vagy számokat, válassza a Hozzáadás a kosárhoz lehetőséget a telefonszámok tárolásához a Telefonos kosárban. Ezek a számok 16 percig vannak tárolva, mielőtt a kosár automatikusan törlődik.

    Képernyőkép a telefonszám bevásárlókosararól két telefonszámmal a kosárban.

    Feljegyzés

    A megjelenített árak a havi ismétlődő díjak , amelyek fedezik a kiválasztott telefonszám bérlésének költségét. Ez a nézet nem tartalmazza a használatalapú fizetés költségeit , amelyek a hívások indításakor vagy fogadásakor merülnek fel. Az árlisták itt érhetők el. Ezek a költségek a szám típusától és a hívott célhelyektől függnek. Például egy seattle-i regionális számról new york-i regionális számra irányuló hívás percenkénti ára, és az ugyanabból a számból egy egyesült királyságbeli mobilszámra irányuló hívás eltérő lehet.

  7. Válassza a Tovább lehetőséget a vásárlás áttekintéséhez. A vásárlás befejezéséhez válassza a Vásárlás most lehetőséget.

    Képernyőkép 2 áttekintendő és megvásárolható telefonszámról.

  8. A megvásárolt számokat a Telefon számok oldalán találja meg. A számok kiépítése eltarthat néhány percig.

    Képernyőkép a telefonszámok oldaláról, amelyen az újonnan vásárolt telefonszámok piros szegélylel vannak bekeretítve.

Telefon Szám képességeinek frissítése

A Telefon Számok lapon kiválaszthat egy telefonszámot a konfigurálásához.

Képernyőkép a frissítési funkciók oldalról.

Válassza ki az elérhető lehetőségek funkcióit, majd válassza a Mentés lehetőséget a kijelölés alkalmazásához.

Kiadási Telefon száma

A Számok lapon telefonszámokat adhat ki.

Képernyőkép a kiadási telefonszámok oldalról.

Válassza ki a kiadni kívánt telefonszámot, majd válassza a Kiadás gombot.

Előfeltételek

Beállítás

A bővítmény hozzáadása

Adja hozzá az Azure CLI Azure Communication Services-bővítményét a az extension parancs használatával.

az extension add --name communication

Bejelentkezés az Azure CLI-be

Be kell jelentkeznie az Azure CLI-be. Bejelentkezhet a az login parancs terminálról való futtatásával, és megadhatja a hitelesítő adatait.

Üzemeltetés

Megvásárolt telefonszám(ok) listázása

Futtassa a következő parancsot az összes megvásárolt telefonszám lekéréséhez.

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

Végezze el ezt a pótlást a kódban:

  • Cserélje le <yourConnectionString> a kapcsolati sztring.

Megvásárolt telefonszám részleteinek lekérése

Futtassa a következő parancsot egy megvásárolt telefonszám telefonszámadatainak lekéréséhez.

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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <purchasedPhoneNumber> a Communication Services-erőforráshoz társított telefonszámra.
  • Cserélje le <yourConnectionString> a kapcsolati sztring.

Feljegyzés

Az Azure CLI-beállítás csak a telefonszámok listázásához és megjelenítéséhez nyújt funkciókat. Nem támogatja az egyéb műveleteket, például a telefonszámok keresését, vásárlását, szerkesztését vagy kiadását.

(Nem kötelező) Azure CLI-telefonszám-műveletek használata kapcsolati sztring átadása nélkül

A környezeti változót AZURE_COMMUNICATION_CONNECTION_STRING úgy konfigurálhatja, hogy az Azure CLI telefonszám-műveleteit használja anélkül, hogy --connection_string a kapcsolati sztring kellene megadnia. Környezeti változó konfigurálásához nyisson meg egy konzolablakot, és válassza ki az operációs rendszert az alábbi lapokról. Cserélje le <yourConnectionString> a tényleges kapcsolati sztring.

Nyisson meg egy konzolablakot, és írja be a következő parancsot:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Miután hozzáadta a környezeti változót, előfordulhat, hogy újra kell indítania minden futó programot, amelynek szüksége lehet a környezeti változó beolvasására, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Feljegyzés

A rövid útmutató véglegesített kódjának megkeresése a GitHubon

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a dotnet parancsot annak ellenőrzéséhez, hogy telepítve van-e a .NET-ügyfélkódtár.

Beállítás

Új C#-alkalmazás létrehozása

Egy konzolablakban (például parancsmag, PowerShell vagy Bash) a dotnet new paranccsal hozzon létre egy új konzolalkalmazást a névvel PhoneNumbersQuickstart. Ez a parancs egy egyszerű ""Helló világ!" alkalmazás" C#-projektet hoz létre egyetlen forrásfájllal: Program.cs.

dotnet new console -o PhoneNumbersQuickstart

Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára, és használja a dotnet build parancsot az alkalmazás fordításához.

cd PhoneNumbersQuickstart
dotnet build

Telepítse a(z) csomagot

Miközben továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Telefon Numbers ügyfélkódtárat a .NET-csomaghoz a dotnet add package parancs használatával.

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

Adjon hozzá egy direktívát using a Program.cs elejéhez a névterek belefoglalásához.

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

A függvény aláírásának frissítése Main aszinkron módon.

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

Az ügyfél hitelesítése

Telefon Szám típusú ügyfelek hitelesíthetők az Azure Portal Azure Communication Services-erőforrásaiból beszerzett kapcsolati sztring használatával.

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

Telefon Szám ügyfeleknek lehetősége van a Microsoft Entra-hitelesítéssel történő hitelesítésre is. Ezzel a beállítással a AZURE_CLIENT_SECRETAZURE_CLIENT_ID AZURE_TENANT_ID környezeti változókat be kell állítani a hitelesítéshez.

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

Telefonszámok kezelése

Elérhető telefonszámok keresése

A telefonszámok vásárlásához először meg kell keresnie az elérhető telefonszámokat. Telefonszámok kereséséhez adja meg a körzetszámot, a hozzárendelés típusát, a telefonszám képességeit, a telefonszám típusát és mennyiségét. Vegye figyelembe, hogy az ingyenes telefonszámtípus esetében a körzetszám megadása nem kötelező.

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

Telefonszámok vásárlása

A telefonszámok keresésének eredménye egy PhoneNumberSearchResult. Ez egy SearchId olyan elemet tartalmaz, amelyet átadhat a beszerzési számok API-nak a keresésben szereplő számok beszerzéséhez. Vegye figyelembe, hogy a vásárlási telefonszámok API meghívása díjköteles lesz az Azure-fiókjában.

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

Telefonszám(ok) lekérése

A vásárlási szám után lekérheti az ügyféltől.

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

Az összes megvásárolt telefonszámot is lekérheti.

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

Telefonszám-képességek frissítése

Egy megvásárolt számmal frissítheti a képességeket.

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

Kiadási telefonszám

A megvásárolt telefonszámot közzéteheti.

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

A kód futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run paranccsal.

dotnet run

Mintakód

A mintaalkalmazást letöltheti a GitHubról

Feljegyzés

A rövid útmutató véglegesített kódjának megkeresése a GitHubon

Előfeltételek

Beállítása

Új Java-alkalmazás létrehozása

Nyissa meg a terminált vagy a parancsablakot. Lépjen arra a könyvtárra, ahol létre szeretné hozni a Java-alkalmazást. Futtassa az alábbi parancsot a Java-projekt létrehozásához a maven-archetype-quickstart sablonból.

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

Megfigyelheti, hogy a "létrehozás" feladat létrehozott egy könyvtárat, amelynek a neve megegyezik a artifactId. Ebben a könyvtárban az src/main/java könyvtár tartalmazza a projekt forráskódját, a src/test/java directory tesztforrást, a pom.xml fájl pedig a projekt projektobjektum-modelljét vagy POM-ját.

Telepítse a(z) csomagot

Nyissa meg a pom.xml fájlt a szövegszerkesztőben. Adja hozzá a következő függőségi elemeket a függőségek csoportjához.

<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>

Az alkalmazás-keretrendszer beállítása

A projektkönyvtárból:

  1. Lépjen a /src/main/java/com/communication/quickstart könyvtárra
  2. Nyissa meg a App.java fájlt a szerkesztőben
  3. System.out.println("Hello world!"); Az utasítás cseréje
  4. Irányelvek hozzáadása import

A kezdéshez használja a következő kódot:

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
    }
}

A Telefon-számügyfél hitelesítése

A Telefon NumberClientBuilder engedélyezve van a Microsoft Entra-hitelesítés használatához

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

Másik lehetőségként a végpont és a hozzáférési kulcs használata a kommunikációs erőforrásból a hitelesítéshez is lehetséges.

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

Telefon számok kezelése

Elérhető Telefon számok keresése

A telefonszámok vásárlásához először meg kell keresnie az elérhető telefonszámokat. Telefonszámok kereséséhez adja meg a körzetszámot, a hozzárendelés típusát, a telefonszám képességeit, a telefonszám típusát és mennyiségét. Vegye figyelembe, hogy az ingyenes telefonszámtípus esetében a körzetszám megadása nem kötelező.

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

Vásárlás Telefon számok

A telefonszámok keresésének eredménye egy Telefon NumberSearchResult. Ez egy searchId olyan elemet tartalmaz, amelyet átadhat a beszerzési számok API-nak a keresésben szereplő számok beszerzéséhez. Vegye figyelembe, hogy a vásárlási telefonszámok API meghívása díjköteles lesz az Azure-fiókjában.

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

Telefon Szám(ok) lekérése

A vásárlási szám után lekérheti az ügyféltől.

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

Az összes megvásárolt telefonszámot is lekérheti.

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

Telefon Szám képességeinek frissítése

Egy megvásárolt számmal frissítheti a képességeket.

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
}

Kiadási Telefon száma

A megvásárolt telefonszámot közzéteheti.

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

A kód futtatása

Lépjen a pom.xml fájlt tartalmazó könyvtárra, és fordítsa le a projektet az alábbi mvn paranccsal.

mvn compile

Ezután hozza létre a csomagot.

mvn package

Futtassa a következő mvn parancsot az alkalmazás végrehajtásához.

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

Az alkalmazás kimenete az összes befejezett műveletet ismerteti:

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

Feljegyzés

A rövid útmutató véglegesített kódjának megkeresése a GitHubon

Előfeltételek

Beállítás

Új Python-alkalmazás létrehozása

Nyissa meg a terminált vagy a parancsablakot, és hozzon létre egy új könyvtárat az alkalmazáshoz, majd navigáljon hozzá.

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

Szövegszerkesztővel hozzon létre egy phone_numbers_sample.py nevű fájlt a projekt gyökérkönyvtárában, és adja hozzá a következő kódot. A többi gyorsútmutató-kódot a következő szakaszokban fogjuk hozzáadni.

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)

Telepítse a(z) csomagot

Miközben továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services Rendszergazda istration ügyfélkódtárat a Python-csomaghoz a pip install parancs használatával.

pip install azure-communication-phonenumbers

A Telefon-számügyfél hitelesítése

Engedélyezve PhoneNumbersClient van a Microsoft Entra-hitelesítés használata. A Microsoft Entra ID használatának legegyszerűbb módja az DefaultAzureCredential objektum használata, amelyet a pip install parancs használatával telepíthet.

pip install azure-identity

Egy DefaultAzureCredential objektum létrehozásához rendelkeznie AZURE_CLIENT_IDkell , AZURE_CLIENT_SECRETés AZURE_TENANT_ID már környezeti változóként kell beállítania a regisztrált Microsoft Entra-alkalmazás megfelelő értékeit.

A környezeti változók beszerzésének gyors útmutatójához kövesse a szolgáltatásnevek beállítását a parancssori felület rövid útmutatójából.

Miután telepítette a azure-identity kódtárat, folytathatjuk az ügyfél hitelesítését.

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)

Másik lehetőségként a végpont és a hozzáférési kulcs használata a kommunikációs erőforrásból a hitelesítéshez is lehetséges.

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

PhoneNumbersClient A hitelesítés után megkezdhetjük a különböző függvények működését.

Elérhető Telefon számok keresése

A telefonszámok vásárlásához először meg kell keresnie az elérhető telefonszámokat. Telefonszámok kereséséhez adja meg a körzetszámot, a hozzárendelés típusát, a telefonszám képességeit, a telefonszám típusát és a mennyiséget (az alapértelmezett mennyiség értéke 1). Vegye figyelembe, hogy az ingyenes telefonszámtípus esetében a körzetszám megadása nem kötelező.

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)

Vásárlás Telefon számok

A telefonszámok keresésének eredménye egy PhoneNumberSearchResult. Ez egy searchId olyan elemet tartalmaz, amelyet átadhat a beszerzési számok API-nak a keresésben szereplő számok beszerzéséhez. Vegye figyelembe, hogy a vásárlási telefonszámok API meghívása díjköteles lesz az Azure-fiókjában.

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)

Megvásárolt telefonszám(ok) beszerzése

A vásárlási szám után lekérheti az ügyféltől.

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)

Az összes megvásárolt telefonszámot is lekérheti.

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)

Telefon Szám képességeinek frissítése

Frissítheti a korábban vásárolt telefonszámok képességeit.

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

Kiadási Telefon száma

A megvásárolt telefonszámot közzéteheti.

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

A kód futtatása

A konzol parancssorából lépjen a phone_numbers_sample.py fájlt tartalmazó könyvtárra, majd futtassa a következő Python-parancsot az alkalmazás futtatásához.

python phone_numbers_sample.py

Feljegyzés

A rövid útmutató véglegesített kódjának megkeresése a GitHubon

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa node --version a Node.js telepítésének ellenőrzéséhez.

Beállítás

Új Node.js-alkalmazás létrehozása

Először nyissa meg a terminált vagy a parancsablakot, hozzon létre egy új könyvtárat az alkalmazáshoz, és navigáljon hozzá.

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

Futtassa npm init -y az alapértelmezett beállításokkal rendelkező package.json fájl létrehozásához.

npm init -y

Hozzon létre egy phone-numbers-quickstart.js nevű fájlt az imént létrehozott könyvtár gyökerében. Adja hozzá a következő kódrészletet:

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

main();

Telepítse a(z) csomagot

npm install A paranccsal telepítheti az Azure Communication Services Telefon Numbers ügyfélkódtárat JavaScripthez.

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

A --save beállítás függőségként adja hozzá a tárat a package.json fájlhoz.

Az ügyfél hitelesítése

Importálja a Telefon NumbersClientet az ügyfélkódtárból, és hozza létre a kapcsolati sztring. Az alábbi kód lekéri az erőforrás kapcsolati sztring egy nevesített COMMUNICATION_SERVICES_CONNECTION_STRINGkörnyezeti változóból. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

Adja hozzá a következő kódot a phone-numbers-quickstart.js tetejére:

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

Telefonszámok kezelése

Elérhető telefonszámok keresése

A telefonszámok vásárlásához először meg kell keresnie az elérhető telefonszámokat. Telefonszámok kereséséhez adja meg a körzetszámot, a hozzárendelés típusát, a telefonszám képességeit, a telefonszám típusát és mennyiségét. Vegye figyelembe, hogy az ingyenes telefonszámtípus esetében a körzetszám megadása nem kötelező.

Adja hozzá a következő kódrészletet a main függvényhez:

/**
 * 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}`);

Telefonszám vásárlása

A telefonszámok keresésének eredménye egy PhoneNumberSearchResult. Ez egy searchId olyan elemet tartalmaz, amelyet átadhat a beszerzési számok API-nak a keresésben szereplő számok beszerzéséhez. Vegye figyelembe, hogy a vásárlási telefonszámok API meghívása díjköteles lesz az Azure-fiókjában.

Adja hozzá a következő kódrészletet a main függvényhez:

/**
 * Purchase Phone Number
 */

const purchasePoller = await phoneNumbersClient.beginPurchasePhoneNumbers(searchId);

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

Telefonszám-képességek frissítése

A már megvásárolt telefonszámok esetén adja hozzá a következő kódot a képességeinek frissítéséhez:

/**
 * 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.");

Megvásárolt telefonszám(ok) beszerzése

A vásárlási szám után lekérheti az ügyféltől. Adja hozzá a következő kódot a main függvényhez az imént vásárolt telefonszám lekéréséhez:

/**
 * Get Purchased Phone Number
 */

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

Az összes megvásárolt telefonszámot is lekérheti.

const purchasedPhoneNumbers = await phoneNumbersClient.listPurchasedPhoneNumbers();

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

Kiadási telefonszám

Most már kiadhatja a megvásárolt telefonszámot. Adja hozzá az alábbi kódrészletet a main függvényhez:

/**
 * Release Purchased Phone Number
 */

const releasePoller = await phoneNumbersClient.beginReleasePhoneNumber(phoneNumber);

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

A kód futtatása

node A paranccsal futtassa a phone-numbers-quickstart.js fájlhoz hozzáadott kódot.

node phone-numbers-quickstart.js

Hibaelhárítás

Gyakori kérdések és problémák:

  • A telefonszám kiadásakor a telefonszám a számlázási ciklus végéig megjelenik az ACS-erőforrásban az Azure Portalon. A számlázási ciklus végéig nem lehet visszavásároltnak lennie.

  • A Communication Services-erőforrás törlésekor az erőforráshoz társított telefonszámok automatikusan megjelennek egyszerre.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan:

  • Telefonszám vásárlása
  • A telefonszám kezelése
  • Telefonszám felszabadítása
  • Ingyenes ellenőrző alkalmazás beküldése (ha szükséges)

SMS küldése

Ingyenes ellenőrzés

Munkafolyamat létrehozása kimenő hívásokhoz a megvásárolt telefonszámok használatával

Ismerkedés az alkalmazások hívásával