Hızlı Başlangıç: Telefon numaralarını alma ve yönetme

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Etkin bir İletişim Hizmetleri kaynağı.

Telefon numarası alma

Numaraları sağlamaya başlamak için Azure portalında İletişim Hizmetleri kaynağınıza gidin.

Kullanılabilir Telefon Numaralarını Ara

Kaynak menüsünde telefon numaraları dikey penceresine gidin.

Sihirbazı başlatmak için Al düğmesine basın. Telefon numaraları dikey penceresindeki sihirbaz, senaryonuza en uygun telefon numarasını seçmenize yardımcı olacak bir dizi soruda size yol gösterir.

Öncelikle telefon numarasını sağlamak istediğiniz Ülkeyi/bölgeyi seçmeniz gerekir. Ülke/bölge'yi seçtikten sonra gereksinimlerinize en uygun Kullanım örneğini seçmeniz gerekir.

Telefon numarası özelliklerinizi seçin

Telefon numaranızı yapılandırma iki adıma ayrılır:

1. Sayı türü seçimi
2. Sayı özelliklerinin seçimi

İki telefon numarası türü arasından seçim yapabilirsiniz: Yerel ve Ücretsiz. Bir sayı türü seçtikten sonra özelliği seçebilirsiniz.

Örneğimizde Arama yap ve SMS gönder ve al özelliklerine sahip ücretsiz bir numara türü seçtik.

Buradan, sağlamak istediğiniz telefon numaralarını özelleştirmek için sayfanın en altındaki İleri: Numaralar düğmesine tıklayın.

Telefon numaralarını özelleştirme

Numaralar sayfasında, sağlamak istediğiniz telefon numaralarını özelleştirebilirsiniz.

Kullanılabilir Alan kodları listesinden Alan kodunu seçin ve sağlamak istediğiniz miktarı girin, ardından seçtiğiniz gereksinimleri karşılayan numaraları bulmak için Ara'ya tıklayın. İhtiyaçlarınızı karşılayan telefon numaraları, aylık maliyetleriyle birlikte gösterilir.

Satın alma özetini görüntülemek ve siparişinizi vermek için sayfanın en altındaki İleri: Özet düğmesine tıklayın.

Telefon Numaraları Satın Al

Özet sayfasında, telefon numaralarını sağlamak için Numara türü, Özellikler, Telefon Numaraları ve Toplam aylık maliyet gözden geçirilecektir.

Son olarak, onaylamak için sayfanın alt kısmındaki Sipariş ver'e tıklayın.

Azure portalında telefon numaralarınızı bulma

Azure portalında Azure İletişim Hizmetleri kaynağınıza gidin:

Telefon numaralarınızı yönetmek için menüden Telefon Numaraları dikey penceresini seçin.

Telefon Numarası Özelliklerini Güncelleştirme

Telefon Numaraları sayfasında, yapılandırmak için bir telefon numarası seçebilirsiniz.

Kullanılabilir seçeneklerden özellikleri seçin ve ardından Kaydet'e tıklayarak seçiminizi uygulayın.

Sürüm Telefon Numarası

Numaralar sayfasında, telefon numaralarını serbest bırakabilirsiniz.

Serbest bırakmak istediğiniz telefon numarasını seçin ve ardından Serbest Bırak düğmesine tıklayın.

Azure İletişim Hizmetleri, telefon numaraları satın almak için yeni bir kullanıcı deneyimi sunar. Bu deneyim şu anda kullanıma alınıyor ve Azure portalda bir telefon numarası satın alırken bu deneyimle karşılaşabilirsiniz. Bu deneyimle ilgili geri bildiriminiz varsa, Azure portal uzantısındaki Geri bildirimde bulunmak için geri bildirimde bulunmaktan çekinmeyin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Etkin bir İletişim Hizmetleri kaynağı.

Telefon numarası satın alma

1. Azure portalında İletişim Hizmeti kaynağınıza gidin.

   

2. İletişim Hizmetleri kaynağına genel bakış bölümünde sol taraftaki menüden "Telefon numaraları" seçeneğini belirleyin.

   

3. Telefon numaranızı satın almak için sayfanın sol üst kısmındaki Al'ı seçin. Bunu seçtiğinizde alışveriş sihirbazımız başlatılır:

   

4. Telefon numarasını sağlamak istediğiniz Ülkeyi/bölgeyi seçin. Ülke/bölge kullanılabilirliği, Azure aboneliğinizin faturalama konumunu temel alır. Her ülke/bölge için hangi numaraların kullanılabilir olduğu hakkında daha fazla bilgiyi burada bulabilirsiniz. Ardından sayı türünü seçeceksiniz. İki telefon numarası türü arasından seçim yapabilirsiniz: Yerel ve Ücretsiz.

5. Seçtiğiniz ölçütlere uyan sayıları çekmek için Ara'yı seçin. İhtiyaçlarınıza uygun numarayı aramak için aşağıdakiler gibi çeşitli filtreleriniz vardır:

   • Kullanım örneği: Bu, bir uygulamadan (A2P) veya bir insan aracısından (P2P) çağrı yapmak için bu numarayı kullanıp kullanmadığınıza yöneliktir.
   • Arama: Bu, telefon numaranız için istediğiniz Arama özelliklerini belirlemeye yöneliktir: Arama yapma ve/veya arama alma.
   • SMS: Bu, telefon numaranız için istediğiniz SMS özelliklerini belirlemeye yöneliktir: SMS mesajları gönderme ve/veya alma.
   • Özel: Telefon numaranıza belirli bir ön ek veya rakam kümesi almak için özel filtreler de ekleyebilirsiniz.

   

6. Seçtiğiniz telefon numarasını veya numaraları bulduğunuzda, Numaraları Telefon sepetinde tutmak için Sepete ekle'yi seçin. Bu numaralar, sepetiniz otomatik olarak temizlenmeden önce 16 dakika tutulur.

   

   Not

   Gösterilen fiyatlar, seçili telefon numarasını size kiralama maliyetini kapsayan aylık yinelenen ücretlerdir. Arama yaptığınızda veya aldığınızda tahakkuk eden Kullandıkça öde maliyetleri bu görünüme dahil değildir. Fiyat listelerine buradan ulaşabilirsiniz. Bu maliyetler, numara türüne ve çağrılan hedeflere bağlıdır. Örneğin, Seattle bölgesel numarasından New York'taki bölgesel bir numaraya yapılan aramanın dakika başına fiyatı ve aynı numaradan Birleşik Krallık cep telefonu numarasına yapılan arama farklı olabilir.

7. Satın alma işleminizi gözden geçirmek için İleri'yi seçin. Satın alma işleminizi tamamlamak için Şimdi satın al'ı seçin.

   

8. Satın aldığınız numaraları Telefon numaraları sayfasında bulabilirsiniz. Sayıların sağlanması birkaç dakika sürebilir.

   

Telefon Numarası Özelliklerini Güncelleştirme

Telefon Numaraları sayfasında, yapılandırmak için bir telefon numarası seçebilirsiniz.

Kullanılabilir seçeneklerden özellikleri seçin ve ardından kaydet'i seçerek seçiminizi uygulayın.

Sürüm Telefon Numarası

Numaralar sayfasında, telefon numaralarını serbest bırakabilirsiniz.

Serbest bırakmak istediğiniz telefon numarasını seçin ve ardından Serbest Bırak düğmesini seçin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.

• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

• Azure CLI'yı yükleyin.

• Satın alınan bir telefon numarası.

Ayarlama

Uzantıyı ekleme

komutunu kullanarak Azure CLI için Azure İletişim Hizmetleri uzantısını az extension ekleyin.

az extension add --name communication

Azure CLI'da oturum açma

Azure CLI'da oturum açmanız gerekir. Terminalden komutunu çalıştırarak az login ve kimlik bilgilerinizi sağlayarak oturum açabilirsiniz.

Operations

Satın alınan telefon numaralarını listeleme

Satın alınan tüm telefon numaralarını almak için aşağıdaki komutu çalıştırın.

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

Kodda bu değişikliği yapın:

• değerini bağlantı dizesi ile değiştirin<yourConnectionString>.

Satın alınan telefon numarası ayrıntılarını alma

Satın alınan bir telefon numarasının telefon numarası ayrıntılarını almak için aşağıdaki komutu çalıştırın.

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

Kodda şu değişiklikleri yapın:

• değerini İletişim Hizmetleri kaynağınızla ilişkili bir telefon numarasıyla değiştirin <purchasedPhoneNumber> .
• değerini bağlantı dizesi ile değiştirin<yourConnectionString>.

(İsteğe bağlı) Bağlantı dizesi geçirmeden Azure CLI telefon numaraları işlemlerini kullanma

Ortam değişkeniniAZURE_COMMUNICATION_CONNECTION_STRING, bağlantı dizesi geçirmek için kullanmak zorunda kalmadan Azure CLI telefon numaraları işlemlerini kullanacak --connection_string şekilde yapılandırabilirsiniz. Ortam değişkenini yapılandırmak için bir konsol penceresi açın ve aşağıdaki sekmelerden işletim sisteminizi seçin. değerini gerçek bağlantı dizesi ile değiştirin<yourConnectionString>.

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• İşletim sisteminiz için en son sürüm .NET Core istemci kitaplığı .
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

• Terminalde veya komut penceresinde komutunu çalıştırarak dotnet .NET istemci kitaplığının yüklü olup olmadığını denetleyin.

Ayarlama

Yeni bir C# uygulaması oluşturma

Bir konsol penceresinde (cmd, PowerShell veya Bash gibi), adlı PhoneNumbersQuickstartyeni bir konsol uygulaması oluşturmak için komutunu kullanındotnet new. Bu komut, tek bir kaynak dosyayla basit bir "Merhaba Dünya" C# projesi oluşturur: Program.cs.

dotnet new console -o PhoneNumbersQuickstart

Dizininizi yeni oluşturulan uygulama klasörüne değiştirin ve komutunu kullanarak dotnet build uygulamanızı derleyin.

cd PhoneNumbersQuickstart
dotnet build

paketini yükleyin

Uygulama dizinindeyken komutunu kullanarak .NET paketi için Azure Communication PhoneNumbers istemci kitaplığını dotnet add package yükleyin.

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

Ad alanlarını eklemek için Program.cs en üstüne bir using yönerge ekleyin.

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

İşlev imzasını zaman uyumsuz olacak şekilde güncelleştirin Main .

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

İstemcinin kimliğini doğrulama

Telefon Numarası istemcilerinin kimliği, Azure portalındaki Azure İletişim Hizmetleri kaynaklardan alınan bağlantı dizesi kullanılarak doğrulanabilir.

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

Telefon Numarası istemcileri, Microsoft Entra kimlik doğrulaması ile kimlik doğrulama seçeneğine de sahiptir. Bu seçenekle, AZURE_CLIENT_SECRETAZURE_CLIENT_ID ve AZURE_TENANT_ID ortam değişkenlerinin kimlik doğrulaması için ayarlanması gerekir.

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

Telefon numaralarını yönetme

Kullanılabilir telefon numaralarını arama

Telefon numaraları satın almak için önce kullanılabilir telefon numaralarını aramanız gerekir. Telefon numaralarını aramak için alan kodunu, atama türünü, telefon numarası özelliklerini, telefon numarası türünü ve miktarı sağlayın. Ücretsiz telefon numarası türü için alan kodunun isteğe bağlı olduğunu unutmayın.

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

Telefon numaraları satın alma

Telefon numaralarını aramanın sonucu bir PhoneNumberSearchResult'dir. Bu, aramadaki sayıları almak için satın alma numaraları API'sine geçirilebilen bir SearchId içerir. Satın alma telefon numaraları API'sini çağırmanın Azure Hesabınızdan ücret alınmasına neden olacağını unutmayın.

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

Telefon numaraları alma

Satın alma numarasından sonra istemciden alabilirsiniz.

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

Ayrıca satın alınan tüm telefon numaralarını da alabilirsiniz.

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

Telefon numarası özelliklerini güncelleştirme

Satın alınan bir numarayla özellikleri güncelleştirebilirsiniz.

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

Sürüm telefon numarası

Satın alınan bir telefon numarasını serbest bırakabilirsiniz.

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

Kodu çalıştırma

komutunu kullanarak dotnet run uygulamayı uygulama dizininizden çalıştırın.

dotnet run

Örnek Kod

Örnek uygulamayı GitHub'dan indirebilirsiniz

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Java Development Kit (JDK) sürüm 8 veya üzeri.
• Apache Maven.
• Dağıtılmış bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Ayarlama

Yeni java uygulaması oluşturma

Terminalinizi veya komut pencerenizi açın. Java uygulamanızı oluşturmak istediğiniz dizine gidin. Maven-archetype-quickstart şablonundan Java projesi oluşturmak için aşağıdaki komutu çalıştırın.

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

'Oluştur' görevinin ile aynı ada artifactIdsahip bir dizin oluşturduğunu göreceksiniz. Bu dizin altında, src/main/java dizini proje kaynak kodunu içerir, src/test/java directory test kaynağını içerir ve pom.xml dosya projenin Proje Nesne Modeli veya POM'dir.

paketini yükleyin

metin düzenleyicinizde pom.xml dosyasını açın. Bağımlılık grubuna aşağıdaki bağımlılık öğelerini ekleyin.

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

Uygulama çerçevesini ayarlama

Proje dizininden:

1. /src/main/java/com/communication/quickstart dizinine gidin
2. App.java dosyasını düzenleyicinizde açma
3. deyimini System.out.println("Hello world!"); değiştirme
4. Yönerge ekleme import

Başlamak için aşağıdaki kodu kullanın:

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

Telefon Numaraları İstemcisinin Kimliğini Doğrulama

PhoneNumberClientBuilder, Microsoft Entra kimlik doğrulamasını kullanmak için etkinleştirildi

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

Alternatif olarak, kimlik doğrulaması yapmak için iletişim kaynağından uç nokta ve erişim anahtarını kullanmak da mümkündür.

// 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 Numaralarını Yönet

Kullanılabilir Telefon Numaralarını Ara

Telefon numaraları satın almak için önce kullanılabilir telefon numaralarını aramanız gerekir. Telefon numaralarını aramak için alan kodunu, atama türünü, telefon numarası özelliklerini, telefon numarası türünü ve miktarı sağlayın. Ücretsiz telefon numarası türü için alan kodunun isteğe bağlı olduğunu unutmayın.

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

Telefon Numaraları Satın Al

Telefon numaralarını aramanın sonucu bir PhoneNumberSearchResult'tır. Bu, aramadaki sayıları almak için satın alma numaraları API'sine geçirilebilen bir searchId içerir. Satın alma telefon numaraları API'sini çağırmanın Azure Hesabınızdan ücret alınmasına neden olacağını unutmayın.

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

Telefon Numaraları Alma

Satın alma numarasından sonra istemciden alabilirsiniz.

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

Ayrıca satın alınan tüm telefon numaralarını da alabilirsiniz.

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

Telefon Numarası Özelliklerini Güncelleştirme

Satın alınan bir numarayla özellikleri güncelleştirebilirsiniz.

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
}

Sürüm Telefon Numarası

Satın alınan bir telefon numarasını serbest bırakabilirsiniz.

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

Kodu çalıştırma

pom.xml dosyasını içeren dizine gidin ve aşağıdaki mvn komutu kullanarak projeyi derleyin.

mvn compile

Ardından paketi derleyin.

mvn package

Uygulamayı yürütmek için aşağıdaki mvn komutu çalıştırın.

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

Uygulamanın çıkışı, tamamlanan her eylemi açıklar:

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

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Python 3.7+.
• Dağıtılmış bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Ayarlama

Yeni Python uygulaması oluşturma

Terminalinizi veya komut pencerenizi açın ve uygulamanız için yeni bir dizin oluşturun ve ardından bu dizine gidin.

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

Proje kök dizininde phone_numbers_sample.py adlı bir dosya oluşturmak ve aşağıdaki kodu eklemek için bir metin düzenleyicisi kullanın. Kalan hızlı başlangıç kodunu aşağıdaki bölümlerde ekleyeceğiz.

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)

paketini yükleyin

Uygulama dizinindeyken komutunu kullanarak Python paketi için Azure İletişim Hizmetleri Yönetim istemci kitaplığını pip install yükleyin.

pip install azure-communication-phonenumbers

Telefon Numaraları İstemcisinin Kimliğini Doğrulama

PhoneNumbersClient, Microsoft Entra kimlik doğrulamasını kullanmak için etkinleştirilir. DefaultAzureCredential Nesnesini kullanmak, Microsoft Entra Id kullanmaya başlamanın en kolay yoludur ve komutunu kullanarak pip install yükleyebilirsiniz.

pip install azure-identity

DefaultAzureCredential Nesne oluşturmak için AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, ve AZURE_TENANT_ID zaten kayıtlı Microsoft Entra uygulamanızdan karşılık gelen değerleriyle ortam değişkenleri olarak ayarlamanız gerekir.

Bu ortam değişkenlerini alma hakkında hızlı bir başlangıç için CLI'dan hizmet sorumlularını ayarlama hızlı başlangıcını izleyebilirsiniz.

Kitaplığı yükledikten sonra istemcinin azure-identity kimliğini doğrulamaya devam edebiliriz.

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)

Alternatif olarak, kimlik doğrulaması yapmak için iletişim kaynağından uç nokta ve erişim anahtarını kullanmak da mümkündür.

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)

İşlevler

PhoneNumbersClient kimliği doğrulandıktan sonra, gerçekleştirebileceği farklı işlevler üzerinde çalışmaya başlayabiliriz.

Kullanılabilir Telefon Numaralarını Ara

Telefon numaraları satın almak için önce kullanılabilir telefon numaralarını aramanız gerekir. Telefon numaralarını aramak için alan kodunu, atama türünü, telefon numarası özelliklerini, telefon numarası türünü ve miktarı sağlayın (varsayılan miktar 1 olarak ayarlanır). Ücretsiz telefon numarası türü için alan kodunun isteğe bağlı olduğunu unutmayın.

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)

Telefon Numaraları Satın Al

Telefon numaralarını aramanın sonucu bir PhoneNumberSearchResult'dir. Bu, aramadaki sayıları almak için satın alma numaraları API'sine geçirilebilen bir searchId içerir. Satın alma telefon numaraları API'sini çağırmanın Azure Hesabınızdan ücret alınmasına neden olacağını unutmayın.

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)

Satın alınan telefon numaraları alma

Satın alma numarasından sonra istemciden alabilirsiniz.

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)

Ayrıca satın alınan tüm telefon numaralarını da alabilirsiniz.

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 Numarası Özelliklerini Güncelleştirme

Daha önce satın alınan bir telefon numarasının özelliklerini güncelleştirebilirsiniz.

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

Sürüm Telefon Numarası

Satın alınan bir telefon numarasını serbest bırakabilirsiniz.

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

Kodu çalıştırma

Konsol isteminden phone_numbers_sample.py dosyasını içeren dizine gidin, ardından aşağıdaki Python komutunu yürüterek uygulamayı çalıştırın.

python phone_numbers_sample.py

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Etkin LTS ve Bakım LTS sürümlerini Node.js (8.11.1 ve 10.14.1 önerilir).
• Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

• Terminalde veya komut penceresinde Node.js yüklenip yüklenmediğini denetlemek için komutunu çalıştırın node --version .

Ayarlama

Yeni Node.js Uygulaması oluşturma

İlk olarak terminalinizi veya komut pencerenizi açın, uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

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

Varsayılan ayarlarla bir package.json dosyası oluşturmak için komutunu çalıştırınnpm init -y.

npm init -y

Yeni oluşturduğunuz dizinin kökünde phone-numbers-quickstart.js adlı bir dosya oluşturun. Aşağıdaki kod parçacığını ekleyin:

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

main();

paketini yükleyin

npm install JavaScript için Azure İletişim Hizmetleri Telefon Numaraları istemci kitaplığını yüklemek için komutunu kullanın.

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

seçeneği--save, kitaplığı package.json dosyanıza bağımlılık olarak ekler.

İstemcinin kimliğini doğrulama

İstemci kitaplığından PhoneNumbersClient dosyasını içeri aktarın ve bağlantı dizesi örneğinizle örneği oluşturun. Aşağıdaki kod, adlı COMMUNICATION_SERVICES_CONNECTION_STRINGbir ortam değişkeninden kaynağın bağlantı dizesi alır. Kaynağınızın bağlantı dizesi yönetmeyi öğrenin.

aşağıdaki kodu phone-numbers-quickstart.js en üstüne ekleyin:

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

Telefon numaralarını yönetme

Kullanılabilir telefon numaralarını arama

Telefon numaraları satın almak için önce kullanılabilir telefon numaralarını aramanız gerekir. Telefon numaralarını aramak için alan kodunu, atama türünü, telefon numarası özelliklerini, telefon numarası türünü ve miktarı sağlayın. Ücretsiz telefon numarası türü için alan kodunun isteğe bağlı olduğunu unutmayın.

İşlevinize main aşağıdaki kod parçacığını ekleyin:

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

Telefon numarası satın alma

Telefon numaralarını aramanın sonucu bir PhoneNumberSearchResult'dir. Bu, aramadaki sayıları almak için satın alma numaraları API'sine geçirilebilen bir searchId içerir. Satın alma telefon numaraları API'sini çağırmanın Azure Hesabınızdan ücret alınmasına neden olacağını unutmayın.

İşlevinize main aşağıdaki kod parçacığını ekleyin:

/**
 * Purchase Phone Number
 */

const purchasePoller = await phoneNumbersClient.beginPurchasePhoneNumbers(searchId);

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

Telefon numarası özelliklerini güncelleştirme

Satın alınan bir telefon numarasıyla, özelliklerini güncelleştirmek için aşağıdaki kodu ekleyin:

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

Satın alınan telefon numaraları alma

Satın alma numarasından sonra istemciden alabilirsiniz. Az önce satın aldığınız telefon numarasını almak için işlevinize main aşağıdaki kodu ekleyin:

/**
 * Get Purchased Phone Number
 */

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

Ayrıca satın alınan tüm telefon numaralarını da alabilirsiniz.

const purchasedPhoneNumbers = await phoneNumbersClient.listPurchasedPhoneNumbers();

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

Sürüm telefon numarası

Artık satın alınan telefon numarasını serbest bırakabilirsiniz. Aşağıdaki kod parçacığını işlevinize main ekleyin:

/**
 * Release Purchased Phone Number
 */

const releasePoller = await phoneNumbersClient.beginReleasePhoneNumber(phoneNumber);

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

Kodu çalıştırma

node phone-numbers-quickstart.js dosyasına eklediğiniz kodu çalıştırmak için komutunu kullanın.

node phone-numbers-quickstart.js