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

  • Makale

Önemli

SMS ve PSTN özellikleri, kullandığınız telefon numarasına ve Azure fatura adresiniz tarafından belirlenen şekilde içinde çalıştığınız ülkeye/bölgeye bağlıdır. Daha fazla bilgi için Abonelik uygunluğu belgelerini ziyaret edin.

Önemli

Yüksek hacimli siparişler için veya istediğiniz telefon numarasının kullanılamadığı durumlarda daha fazla yardım için lütfen bu sayfayı ziyaret edin.

Önkoşullar

Telefon numarası alma

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

İletişim Hizmetleri kaynağının ana sayfasını gösteren ekran görüntüsü.

Kullanılabilir Telefon Numaralarını Ara

Kaynak menüsündeki Telefon Numaraları dikey penceresine gidin.

İletişim Hizmetleri kaynağının telefon sayfasını gösteren ekran görüntüsü.

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 numaralarını al görünümünü gösteren ekran görüntüsü.

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.

Özellik seç görünümünü gösteren ekran görüntüsü.

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.

Sayılar seçim sayfasını gösteren ekran görüntüsü.

Not

Bu hızlı başlangıçta Ücretsiz Sayı türü özelleştirme akışı gösterilir. Yerel Numara türünü seçtiyseniz deneyim biraz farklı olabilir, ancak sonuç aynı olacaktır.

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.

Ayrılmış numaralar içeren Sayılar seçim sayfasını gösteren ekran görüntüsü.

Not

Kullanılabilirlik, Sayı türüne, konuma ve seçtiğiniz özelliklere bağlıdır. Numaralar, işlemin süresi dolmadan önce kısa bir süre için ayrılır. İşlemin süresi dolarsa sayıları yeniden seçmeniz gerekir.

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.

Satın Alma Telefon Numaraları

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

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.

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

Sayı türü, Özellikler, Telefon Numaraları ve Aylık toplam maliyetin gösterildiği Özet sayfasını gösteren ekran görüntüsü.

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

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

İletişim Hizmetleri Kaynağının ana sayfasını gösteren ekran görüntüsü.

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

İletişim Hizmetleri Kaynağının telefon numarası sayfasını gösteren ekran görüntüsü.

Not

Sağlanan sayıların bu sayfada gösterilmesi birkaç dakika sürebilir.

Telefon Numarası Özelliklerini Güncelleştirme

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

Güncelleştirme özellikleri sayfasını gösteren ekran görüntüsü.

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

Yayın Telefon Numarası

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

Sürüm telefon numaraları sayfasını gösteren ekran görüntüsü.

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

Önemli

Azure İletişim Hizmetleri'nin bu özelliği şu anda önizleme aşamasındadır.

Önizleme API'leri ve SDK'ları hizmet düzeyi sözleşmesi olmadan sağlanır. Bunları üretim iş yükleri için kullanmamanızı öneririz. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir.

Daha fazla bilgi için Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı gözden geçirin.

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

Telefon numarası satın alma

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

    İletişim Hizmetleri kaynağının ana sayfasını gösteren ekran görüntüsü.

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

    İletişim Hizmetleri kaynağının telefon numaraları sayfasını gösteren ekran görüntüsü.

  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:

    Telefon numarası alışveriş sepeti arama sihirbazını gösteren ekran görüntüsü.

  4. Telefon numarasını sağlamak istediğiniz Ülkeyi/bölgeyi seçin. Ülke kullanılabilirliği, Azure aboneliğinizin faturalama konumunu temel alır. Her ülke 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.

    Kullanılabilir telefon numaralarının yer aldığı telefon numarası satın alma sayfasını gösteren ekran görüntüsü.

  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.

    Sepette iki telefon numarası bulunan telefon numarası alışveriş sepetini gösteren ekran görüntüsü.

    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.

    Gözden geçirilip satın alınacak 2 telefon numarasını gösteren ekran görüntüsü.

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

    Yeni satın alınan telefon numaralarının kırmızı kenarlıkla kutulandığı telefon numaraları sayfasının ekran görüntüsü.

Telefon Numarası Özelliklerini Güncelleştirme

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

Güncelleştirme özellikleri sayfasını gösteren ekran görüntüsü.

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

Yayın Telefon Numarası

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

Sürüm telefon numaraları sayfasını gösteren ekran görüntüsü.

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

Önkoşullar

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

Not

Azure CLI seçeneği yalnızca telefon numaralarını listelemek ve göstermek için işlevsellik sağlar. Telefon numaralarını arama, satın alma, düzenleme veya yayınlama gibi diğer işlemleri desteklemez.

(İ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>.

Bir konsol penceresi açın ve aşağıdaki komutu girin:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Ortam değişkenini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenini okumak için gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Not

GitHub'da bu hızlı başlangıcın son halini alan kodu bulun

Önkoşullar

Ö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 Telefon Numbers 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ı istemcileri, Azure portalındaki Azure İletişim Hizmetleri kaynaklarından 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 Sayı istemcileri, Microsoft Entra kimlik doğrulaması ile kimlik doğrulaması da sunar. 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

Not

GitHub'da bu hızlı başlangıcın son halini alan kodu bulun

Önkoşullar

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

Telefon NumberClientBuilder, Microsoft Entra kimlik doğrulamasını kullanacak şekilde 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());
}

Satın Alma Telefon Numaraları

Telefon numarası aramanın sonucu bir Telefon NumberSearchResult olur. 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 Sayı al

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
}

Yayın 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

Not

GitHub'da bu hızlı başlangıcın son halini alan kodu bulun

Önkoşullar

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önetici istration 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)

Satın Alma Telefon Numaraları

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

Yayın 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

Not

GitHub'da bu hızlı başlangıcın son halini alan kodu bulun

Önkoşullar

Ö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 Numbers 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 Telefon NumbersClient 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

Sorun giderme

Sık Sorulan Sorular ve Sorunlar:

  • Bir telefon numarası yayınlandığında, telefon numarası faturalama döneminin sonuna kadar Azure portalındaki ACS kaynağınızda gösterilir. Ayrıca faturalama döneminin sonuna kadar yeniden satın alınamaz.

  • İletişim Hizmetleri kaynağı silindiğinde, bu kaynakla ilişkili telefon numaraları otomatik olarak aynı anda serbest bırakılır.

Sonraki adımlar

Bu hızlı başlangıçta aşağıdakilerin nasıl yapılacağını öğrendiniz:

SMS gönderme

Ücretsiz doğrulama

Satın alınan telefon numaralarını kullanarak giden aramalar için iş akışı oluşturma

Uygulamalarda aramayı kullanmaya başlama