Ezt a böngészőt már nem támogatjuk.
Frissítsen a Microsoft Edge-re, hogy kihasználhassa a legújabb funkciókat, a biztonsági frissítéseket és a technikai támogatást.
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.
A számok kiépítésének megkezdéséhez nyissa meg a Communication Services-erőforrást az Azure Portalon.
Lépjen az erőforrás menüjében a Telefonszámok panelre.
A varázsló elindításához nyomja le a Beolvasás gombot. A Telefonszá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.
A telefonszám konfigurálása két lépésből áll:
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.
Innen kattintson a Lap alján található Tovább: Számok gombra a kiosztani kívánt telefonszám(ok) testreszabásához.
A Számok lapon testre szabhatja a kiosztani kívánt telefonszám(ok) számát.
Megjegyzé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.
Megjegyzé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.
Az összefoglaló oldal áttekinti a telefonszámok kiosztásának számtípusát, funkcióit, telefonszámait és teljes havi költségét.
Megjegyzé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.
Lépjen az Azure Communication Services-erőforráshoz az Azure Portalon:
A telefonszámok kezeléséhez válassza a menü Telefonszámok paneljét.
Megjegyzés
Eltarthat néhány percig, amíg a kiosztott számok megjelennek ezen az oldalon.
A Telefonszámok lapon kiválaszthat egy telefonszámot a konfigurálásához.
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.
A Számok lapon telefonszámokat adhat ki.
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.
Lépjen a Kommunikációs szolgáltatás erőforrásához az Azure Portalon.
A Communication Services-erőforrás áttekintésében válassza a bal oldali menü "Telefonszámok" elemét.
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:
Válassza ki azt az országot/régiót , ahol ki szeretné adni a telefonszámot. Az ország/régió elérhetősége az Azure-előfizetés számlázási helyétől függ. Az egyes országokra/régiókra vonatkozó számokró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.
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:
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.
Megjegyzé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á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.
A megvásárolt telefonszámokat a Telefonszámok lapon találja meg. A számok kiépítése eltarthat néhány percig.
A Telefonszámok lapon kiválaszthat egy telefonszámot a konfigurálásához.
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.
A Számok lapon telefonszámokat adhat ki.
Válassza ki a kiadni kívánt telefonszámot, majd válassza a Kiadás gombot.
Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
Aktív Communication Services-erőforrás és kapcsolati sztring. Hozzon létre egy Communication Services-erőforrást.
Telepítse az Azure CLI-t.
Egy megvásárolt telefonszám.
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
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.
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:
<yourConnectionString> a kapcsolati sztring.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:
<purchasedPhoneNumber> a Communication Services-erőforráshoz társított telefonszámra.<yourConnectionString> a kapcsolati sztring.Megjegyzé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.
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.
Szerkessze a .bash_profilesaját , és adja hozzá a környezeti változót:
export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"
A környezeti változó hozzáadását követően futtassa a source ~/.bash_profile parancsot a konzolablakban a módosítások érvénybe léptetéséhez. Ha megnyitott IDE-vel hozta létre a környezeti változót, előfordulhat, hogy be kell zárnia és újra meg kell nyitnia a szerkesztőt, az IDE-t vagy a rendszerhéjat a változó eléréséhez.
dotnet parancsot annak ellenőrzéséhez, hogy telepítve van-e a .NET-ügyfélkódtár.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
Amíg továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication PhoneNumbers ü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)
{
...
}
A telefonszám-ü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);
A telefonszám-ügyfelek a Microsoft Entra hitelesítéssel is hitelesíthetők. 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);
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();
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();
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}");
}
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();
A megvásárolt telefonszámot közzéteheti.
var releaseOperation = await client.StartReleasePhoneNumberAsync("+14255550123");
await releaseOperation.WaitForCompletionResponseAsync();
Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run paranccsal.
dotnet run
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.
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>
A projektkönyvtárból:
System.out.println("Hello world!"); Az utasítás cseréjeimportA 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 PhoneNumberClientBuilder engedélyezve van a Microsoft Entra-hitelesítés használatára
// 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();
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());
}
A telefonszámok keresésének eredménye a 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.
PollResponse<PhoneNumberOperation> purchaseResponse = phoneNumberClient.beginPurchasePhoneNumbers(searchId, Context.NONE).waitForCompletion();
System.out.println("Purchase phone numbers operation is: " + purchaseResponse.getStatus());
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());
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
}
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());
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
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)
Miközben továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services Felügyeleti ügyfélkódtárat a Python-csomaghoz a pip install parancs használatával.
pip install azure-communication-phonenumbers
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)
PhoneNumbersClient A hitelesítés után megkezdhetjük a különböző függvények működését.
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)
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)
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)
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())
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 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
node --version a Node.js telepítésének ellenőrzéséhez.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();
npm install A parancs használatával telepítheti az Azure Communication Services Phone Numbers ügyfélkódtárát 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.
Importálja a PhoneNumbersClientet az ügyfélkódtárból, és példányosíthatja 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);
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}`);
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}`);
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.");
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}.`);
}
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.");
node A paranccsal futtassa a phone-numbers-quickstart.js fájlhoz hozzáadott kódot.
node phone-numbers-quickstart.js
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.
Ebben a rövid útmutatóban megtanulta, hogyan:
Oktatás
Modul
SMS-üzenet küldése C#-konzolalkalmazásból az Azure Communication Services szolgáltatással - Training
Ebben a modulban egy C#-konzolalkalmazást fog létrehozni, amely SMS-üzeneteket küld az Azure Communication Servicesen keresztül kiépített telefonszám használatával.
Dokumentáció
Megtudhatja, hogyan használhat hatékonyan különböző típusú telefonszámokat SMS-hez és telefonhoz.
Ismerje meg az ország/régió rendelkezésre állását, az előfizetések jogosultsági és számképességét a PSTN-hez és az SMS-számokhoz a Kommunikációs szolgáltatásokban.
Rövid útmutató – Telefonszám portolása Azure Communication Services
Ismerje meg, hogyan portozhat telefonszámot a Communication Services-erőforrásba