Hızlı başlangıç: SMS iletisi gönder
Önemli
Telefon numarası kullanılabilirliği şu anda Birleşik Devletler (porto riko dahil), birleşik krallık veya irlanda dahil olmak üzere fatura adresi olan Azure abonelikleriyle kısıtlıdır. daha fazla bilgi için Telefon sayı türleri belgelerini ziyaret edin.
Önemli
SMS iletileri Birleşik Devletler telefon numaralarına gönderilebilir ve buradan alınabilir. diğer coğrafi bölgelerde bulunan Telefon numaraları henüz iletişim hizmetleri SMS tarafından desteklenmemektedir. daha fazla bilgi için bkz. Telefon sayı türleri.
Kullanmaya başlayın sms Azure İletişim Hizmetleri için İletişim Hizmetleri C# SMS SDK'sı kullanarak bu sdk'yı kullanın.
Bu hızlı başlangıç tamamladıktan sonra Azure hesabınıza birkaç ABD doları veya daha düşük bir maliyetle sahip oluruz.
Önkoşullar
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- İşletim sisteminiz .NET Core SDK en son sürüm.
- Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.
- SMS etkin bir telefon numarası. Telefon numarası al.
Önkoşul denetimi
- Bir terminalde veya komut penceresinde komutunu
dotnetçalıştırarak .NET SDK'sı yüklü olup olduğunu kontrol edin. - İletişim Hizmetleri kaynağınız ile ilişkili telefon numaralarını görüntülemek için Azure portal'da oturum açın,İletişim Hizmetleri kaynağınızı bulun ve sol gezinti bölmesinden telefon numaraları sekmesini açın.
Ayarlama
Yeni bir C# uygulaması oluşturma
Konsol penceresinde (cmd, PowerShell veya Bash gibi) komutunu kullanarak adıyla dotnet new yeni bir konsol uygulaması SmsQuickstart oluşturun. Bu komut, tek bir kaynak Merhaba Dünya basit bir "Merhaba Dünya" C# projesi oluşturur: Program.cs.
dotnet new console -o SmsQuickstart
Dizininizi yeni oluşturulan uygulama klasörüne değiştirme ve komutunu dotnet build kullanarak uygulamanızı derleme.
cd SmsQuickstart
dotnet build
Paketi yükleme
Uygulama dizinindeyken komutunu Azure İletişim Hizmetleri .NET paketi için SMS SDK'sı paketini dotnet add package yükleyin.
dotnet add package Azure.Communication.Sms --version 1.0.0
Ad alanını using dahil etmek için Program.cs'nin en üstüne bir yönerge Azure.Communication ekleyin.
using System;
using System.Collections.Generic;
using Azure;
using Azure.Communication;
using Azure.Communication.Sms;
Nesne modeli
Aşağıdaki sınıflar ve arabirimler, C# için SMS SDK'sı Azure İletişim Hizmetleri bazı önemli özellikleri ele almaktadır.
| Ad | Açıklama |
|---|---|
| SmsClient | Bu sınıf tüm SMS işlevleri için gereklidir. Abonelik bilgileriyle örneğinizi hazırlar ve SMS mesajları göndermek için kullanırsınız. |
| SmsSendOptions | Bu sınıf, teslim raporlamayı yapılandırmak için seçenekler sağlar. Bu enable_delivery_report True olarak ayarlanırsa, teslimat başarılı olduğunda bir olay yayımlar |
| SmsSendResult | Bu sınıf SMS hizmetinin sonucu içerir. |
İstemcinin kimliğini doğrulama
Program.cs'yi bir metin düzenleyicisinde açın ve bağlantı dizeniz ile başlatmak için Main yönteminin SmsClient gövdesini kodla değiştirin. Aşağıdaki kod, adlı bir ortam değişkenden kaynağın bağlantı dizesini COMMUNICATION_SERVICES_CONNECTION_STRING alır. Kaynağınız için bağlantı dizesini yönetmeyi öğrenin.
// This code demonstrates how to fetch your connection string
// from an environment variable.
string connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");
SmsClient smsClient = new SmsClient(connectionString);
1:1 SMS iletisi gönderme
Tek bir alıcıya SMS iletisi göndermek için Send SmsClient'dan or SendAsync işlevini arayın. Bu kodu Main Program.cs içinde yönteminin sonuna ekleyin:
SmsSendResult sendResult = smsClient.Send(
from: "<from-phone-number>",
to: "<to-phone-number>",
message: "Hello World via SMS"
);
Console.WriteLine($"Sms id: {sendResult.MessageId}");
yerine İletişim Hizmetleri kaynağınız ile ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti <from-phone-number> <to-phone-number> göndermek istediğiniz telefon numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
Seçeneklerle 1:N SMS iletisi gönderme
Alıcı listesine SMS iletisi göndermek için Send SmsClient'dan alıcının telefon numaralarının listesini kullanarak veya SendAsync işlevini arayın. Ayrıca, teslim raporunun etkin olup olmadığını belirtmek ve özel etiketler ayarlamak için isteğe bağlı parametreler de geçebilirsiniz.
Response<IReadOnlyList<SmsSendResult>> response = smsClient.Send(
from: "<from-phone-number>",
to: new string[] { "<to-phone-number-1>", "<to-phone-number-2>" },
message: "Weekly Promotion!",
options: new SmsSendOptions(enableDeliveryReport: true) // OPTIONAL
{
Tag = "marketing", // custom tags
});
IEnumerable<SmsSendResult> results = response.Value;
foreach (SmsSendResult result in results)
{
Console.WriteLine($"Sms id: {result.MessageId}");
Console.WriteLine($"Send Result Successful: {result.Successful}");
}
yerine İletişim Hizmetleri kaynağınız ile ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti göndermek istediğiniz <from-phone-number> <to-phone-number-1> telefon <to-phone-number-2> numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
parametresi, enableDeliveryReport Delivery Reporting'i yapılandırmak için kullanabileceğiniz isteğe bağlı bir parametredir. Bu, SMS iletileri teslim edilirken olayları yayma istediğiniz senaryolar için kullanışlıdır. SMS iletileriniz için Teslim Raporlaması'nın yapılandırılması için BKZ. SMS Olaylarını Işleme hızlı başlangıç.
Tag Teslim Raporuna etiket uygulamak için kullanılır
Kodu çalıştırma
komutunu kullanarak uygulamayı uygulama dizininize dotnet run çalıştırın.
dotnet run
Örnek Kod
Kullanmaya başlayın sms Azure İletişim Hizmetleri için İletişim Hizmetleri JavaScript SMS SDK'sı kullanarak bu sdk'yı kullanın.
Bu hızlı başlangıç tamamladıktan sonra Azure hesabınıza birkaç ABD doları veya daha düşük bir maliyetle sahip oluruz.
Önkoşullar
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Node.js Etkin LTS ve Bakım LTS sürümleri (8.11.1 ve 10.14.1 önerilir).
- Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.
- SMS etkin bir telefon numarası. Telefon numarası al.
Önkoşul denetimi
- Terminal veya komut penceresinde komutunu
node --versionçalıştırarak yüklü Node.js kontrol edin. - İletişim Hizmetleri kaynağınız ile ilişkili telefon numaralarını görüntülemek için Azure portal'da oturum açın,İletişim Hizmetleri kaynağınızı bulun ve sol gezinti bölmesinden telefon numaraları sekmesini açın.
Ayarlama
Yeni Node.js Oluşturma
İlk olarak terminal veya komut pencerenizi açın, uygulama için yeni bir dizin oluşturun ve bu dizine gidin.
mkdir sms-quickstart && cd sms-quickstart
varsayılan npm init -y ayarlarla package.json dosyası oluşturmak için çalıştırın.
npm init -y
Proje kök dizinindesend-sms.js dosyası oluşturmak için bir metin düzenleyicisi kullanın. Bu hızlı başlangıç için tüm kaynak kodunu aşağıdaki bölümlerde bu dosyaya ekleyebilirsiniz.
Paketi yükleme
npm installJavaScript için sms SDK'Azure İletişim Hizmetleri yüklemek üzere komutunu kullanın.
npm install @azure/communication-sms --save
seçeneği, --save kitaplığı package.json dosyanıza bağımlılık olarak listeler.
Nesne modeli
Aşağıdaki sınıflar ve arabirimler, Azure İletişim Hizmetleri SMS SDK'sı Node.js.
| Ad | Açıklama |
|---|---|
| SmsClient | Bu sınıf tüm SMS işlevleri için gereklidir. Abonelik bilgileriyle örneğinizi hazırlar ve SMS mesajları göndermek için kullanırsınız. |
| SmsSendRequest | Bu arabirim SMS isteğinin (örneğin, telefon numaralarının ve sms içeriklerinden gelen ve gelen ayarlarını yapılandırabilirsiniz). |
| SmsSendOptions | Bu arabirim, teslim raporlamayı yapılandırmak için seçenekler sağlar. olarak enableDeliveryReport true ayarlanırsa, teslim başarılı olduğunda bir olay yayımlar. |
| SmsSendResult | Bu sınıf SMS hizmetinin sonucu içerir. |
İstemcinin kimliğini doğrulama
SDK'dan SmsClient'i içeri aktarın ve bağlantı dizeniz ile örneğinizi alın. Aşağıdaki kod, adlı bir ortam değişkenden kaynağın bağlantı dizesini COMMUNICATION_SERVICES_CONNECTION_STRING alır. Kaynağınız için bağlantı dizesini yönetmeyi öğrenin.
send-sms.js adlı bir dosya oluşturun ve açın ve aşağıdaki kodu ekleyin:
const { SmsClient } = require('@azure/communication-sms');
// This code demonstrates how to fetch your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];
// Instantiate the SMS client
const smsClient = new SmsClient(connectionString);
1:N SMS iletisi gönderme
Alıcı listesine SMS iletisi göndermek için SmsClient'dan işlevini bir alıcı telefon numarası listesiyle arayın (tek bir alıcıya ileti göndermek isterseniz listeye yalnızca bir sayı send ekleyin). Bu kodu verinin sonuna send-sms.js:
async function main() {
const sendResults = await smsClient.send({
from: "<from-phone-number>",
to: ["<to-phone-number-1>", "<to-phone-number-2>"],
message: "Hello World 👋🏻 via SMS"
});
// individual messages can encounter errors during sending
// use the "successful" property to verify
for (const sendResult of sendResults) {
if (sendResult.successful) {
console.log("Success: ", sendResult);
} else {
console.error("Something went wrong when trying to send this message: ", sendResult);
}
}
}
main();
yerine İletişim Hizmetleri kaynağınız ile ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti göndermek istediğiniz <from-phone-number> <to-phone-number-1> telefon <to-phone-number-2> numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
Seçeneklerle 1:N SMS iletisi gönderme
Teslim raporunun etkin olup olmadığını belirtmek ve özel etiketler ayarlamak için bir options nesnesi de geçebilirsiniz.
async function main() {
const sendResults = await smsClient.send({
from: "<from-phone-number>",
to: ["<to-phone-number-1>", "<to-phone-number-2>"],
message: "Weekly Promotion!"
}, {
//Optional parameters
enableDeliveryReport: true,
tag: "marketing"
});
// individual messages can encounter errors during sending
// use the "successful" property to verify
for (const sendResult of sendResults) {
if (sendResult.successful) {
console.log("Success: ", sendResult);
} else {
console.error("Something went wrong when trying to send this message: ", sendResult);
}
}
}
main();
yerine İletişim Hizmetleri kaynağınız ile ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti göndermek istediğiniz <from-phone-number> <to-phone-number-1> telefon <to-phone-number-2> numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
parametresi, enableDeliveryReport Delivery Reporting'i yapılandırmak için kullanabileceğiniz isteğe bağlı bir parametredir. Bu, SMS iletileri teslim edilirken olayları yayma istediğiniz senaryolar için kullanışlıdır. SMS iletileriniz için Teslim Raporlaması'nın yapılandırılması için BKZ. SMS Olaylarını Işleme hızlı başlangıç.
tag , Teslim Raporuna etiket uygulamak için kullanabileceğiniz isteğe bağlı bir parametredir.
Kodu çalıştırma
send-sms.jsdosyasına eklenen kodu node çalıştırmak için komutunu kullanın.
node ./send-sms.js
Kullanmaya başlayın sms Azure İletişim Hizmetleri için İletişim Hizmetleri Python SMS SDK'sı kullanarak bu sdk'yı kullanın.
Bu hızlı başlangıç tamamladıktan sonra Azure hesabınıza birkaç ABD doları veya daha düşük bir maliyetle sahip oluruz.
Önkoşullar
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Python 2.7 veya 3.6+.
- Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.
- SMS etkin bir telefon numarası. Telefon numarası al.
Önkoşul denetimi
- Python'ın yüklü olup olduğunu kontrol etmek
python --versioniçin bir terminalde veya komut penceresinde komutunu çalıştırın. - İletişim Hizmetleri kaynağınız ile ilişkili telefon numaralarını görüntülemek için Azure portal'da oturum açın,İletişim Hizmetleri kaynağınızı bulun ve sol gezinti bölmesinden telefon numaraları sekmesini açın.
Ayarlama
Yeni Python uygulaması oluşturma
Terminal veya komut pencerenizi açın, uygulama için yeni bir dizin oluşturun ve bu dizine gidin.
mkdir sms-quickstart && cd sms-quickstart
Proje kök dizininde send-sms.py adlı bir dosya oluşturmak ve temel özel durum işleme dahil olmak üzere programın yapısını eklemek için bir metin düzenleyicisi kullanın. Bu hızlı başlangıç için tüm kaynak kodunu aşağıdaki bölümlerde bu dosyaya ekleyebilirsiniz.
import os
from azure.communication.sms import SmsClient
try:
# Quickstart code goes here
except Exception as ex:
print('Exception:')
print(ex)
Paketi yükleme
Uygulama dizinindeyken, komutunu Azure İletişim Hizmetleri Python için SMS SDK paketini pip install yükleyin.
pip install azure-communication-sms
Nesne modeli
Aşağıdaki sınıflar ve arabirimler, Python için SMS SDK'sı Azure İletişim Hizmetleri önemli özelliklerinden bazılarını ele almaktadır.
| Ad | Açıklama |
|---|---|
| SmsClient | Bu sınıf tüm SMS işlevleri için gereklidir. Abonelik bilgileriyle örneğinizi hazırlar ve SMS mesajları göndermek için kullanırsınız. |
| SmsSendResult | Bu sınıf SMS hizmetinin sonucu içerir. |
İstemcinin kimliğini doğrulama
Bağlantı dizeniz ile bir SmsClient örneği gönderin. Kaynağınız için bağlantı dizesini yönetmeyi öğrenin.
# Create the SmsClient object which will be used to send SMS messages
sms_client = SmsClient.from_connection_string(<connection_string>)
Kolaylık olması için bu hızlı başlangıçta bağlantı dizelerini kullanıyoruz, ancak üretim ortamlarında hizmet sorumlularının kullanılması önerilir.
1:1 SMS İletisi Gönderme
Tek bir alıcıya SMS iletisi göndermek için send SmsClient'dan tek bir alıcı telefon numarasıyla yöntemini arayın. Ayrıca, teslim raporunun etkin olup olmadığını belirtmek ve özel etiketler ayarlamak için isteğe bağlı parametreler de geçebilirsiniz. Bu kodu try send-sms.py'da bloğun sonuna ekleyin:
# calling send() with sms values
sms_responses = sms_client.send(
from_="<from-phone-number>",
to="<to-phone-number>",
message="Hello World via SMS",
enable_delivery_report=True, # optional property
tag="custom-tag") # optional property
yerine iletişim hizmetiyle ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti <from-phone-number> <to-phone-number> göndermek istediğiniz telefon numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
1:N SMS İletisi Gönderme
Alıcı listesine SMS iletisi göndermek için SmsClient'dan alıcının telefon numaralarının send listesini kullanarak yöntemini arayın. Ayrıca, teslim raporunun etkin olup olmadığını belirtmek ve özel etiketler ayarlamak için isteğe bağlı parametreler de geçebilirsiniz. Bu kodu try send-sms.py'da bloğun sonuna ekleyin:
# calling send() with sms values
sms_responses = sms_client.send(
from_="<from-phone-number>",
to=["<to-phone-number-1>", "<to-phone-number-2>"],
message="Hello World via SMS",
enable_delivery_report=True, # optional property
tag="custom-tag") # optional property
yerine iletişim hizmetiyle ilişkilendirilmiş SMS özellikli bir telefon numarası ve ileti göndermek <from-phone-number> <to-phone-number-1> <to-phone-number-2> istediğiniz telefon numarasıyla değiştirmeniz gerekir.
Uyarı
Telefon numaralarının E.164 uluslararası standart biçiminde (örn. +14255550123) sağlanmalıdır. From telefon numarası da Kısa Kod (ör. 23456) olabilir.
İsteğe Bağlı Parametreler
parametresi, enable_delivery_report Delivery Reporting'i yapılandırmak için kullanabileceğiniz isteğe bağlı bir parametredir. Bu, SMS iletileri teslim edilirken olayları yayma istediğiniz senaryolar için kullanışlıdır. SMS iletileriniz için Teslim Raporlaması'nın yapılandırılması için BKZ. SMS Olaylarını Işleme hızlı başlangıç.
parametresi, tag Teslim Raporuna etiket uygulamak için kullanabileceğiniz isteğe bağlı bir parametredir.
Kodu çalıştırma
komutunu kullanarak uygulamayı uygulama dizininize python çalıştırın.
python send-sms.py
Python betiği aşağıdakine benzer şekilde olmalı:
import os
from azure.communication.sms import SmsClient
try:
# Create the SmsClient object which will be used to send SMS messages
sms_client = SmsClient.from_connection_string("<connection string>")
# calling send() with sms values
sms_responses = sms_client.send(
from_="<from-phone-number>",
to="<to-phone-number>",
message="Hello World via SMS",
enable_delivery_report=True, # optional property
tag="custom-tag") # optional property
except Exception as ex:
print('Exception:')
print(ex)
SMS mesajları göndermek için Iletişim Hizmetleri Java SMS SDK 'sını kullanarak Azure Iletişim Hizmetleri ile çalışmaya başlayın.
Bu hızlı başlangıcı tamamlamak, Azure hesabınızda birkaç ABD Doları veya daha kısa bir ücret doğurur.
Not
Bu hızlı başlangıç için GitHub tarihinde son kodu bulun
Ö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.
- Etkin bir Iletişim Hizmetleri kaynağı ve bağlantı dizesi. Iletişim Hizmetleri kaynağı oluşturun.
- SMS etkin telefon numarası. Telefon numarası alın.
Önkoşul denetimi
- Bir Terminal veya komut penceresinde,
mvn -vMaven 'nin yüklenip yüklenmediğini denetlemek için komutunu çalıştırın. - Iletişim Hizmetleri kaynağınız ile ilişkili telefon numaralarını görüntülemek için Azure Portaloturum açın, iletişim hizmetleri kaynağınızı bulun ve sol gezinti bölmesinden telefon numaraları sekmesini açın.
Ayarlanıyor
Yeni bir Java uygulaması oluşturma
Terminal veya komut pencerenizi açın ve Java uygulamanızı oluşturmak istediğiniz dizine gidin. Maven-,-hızlı başlangıç ş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 ' hedefi, ArtifactId ile aynı ada sahip bir dizin oluşturur. bu dizin altında, src/main/java dizini proje kaynak kodunu içerir, src/test/java dizini test kaynağını içerir ve pom.xml dosyası projenin Project nesne modeli veya pod olur.
Paketi yükler
pom.xml dosyasını metin düzenleyicinizde açın. Aşağıdaki bağımlılık öğesini bağımlılıklar grubuna ekleyin.
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-sms</artifactId>
<version>1.0.1</version>
</dependency>
Uygulama çerçevesini ayarlama
/Src/Main/Java/com/Communication/QuickStart/App.Java 'i bir metin düzenleyicisinde açın, içeri aktarma yönergeleri ekleyin ve System.out.println("Hello world!"); ifadesini kaldırın:
package com.communication.quickstart;
import com.azure.communication.sms.models.*;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.communication.sms.*;
import com.azure.core.util.Context;
import java.util.Arrays;
public class App
{
public static void main( String[] args )
{
// Quickstart code goes here
}
}
Nesne modeli
Aşağıdaki sınıflar ve arabirimler, Java için Azure Communication Services SMS SDK 'sının bazı önemli özelliklerinden bazılarını işler.
| Ad | Açıklama |
|---|---|
| SmsClientBuilder | Bu sınıf, SmsClient oluşturur. Bunu uç nokta, kimlik bilgileri ve bir http istemcisiyle sağlarsınız. |
| SmsClient | Bu sınıf tüm SMS işlevleri için gereklidir. SMS mesajları göndermek için bunu kullanırsınız. |
| Smssendoseçenekleri | Bu sınıf özel etiketler eklemek ve teslim raporlamayı yapılandırmak için seçenekler sağlar. DeliveryReportEnabled değeri true olarak ayarlanırsa, teslim başarılı olduğunda bir olay yayınlanır |
| SmsSendResult | Bu sınıf, SMS hizmetinden elde edilen sonucu içerir. |
İstemcinin kimliğini doğrulama
SmsClientBağlantı dizeniz ile bir örneğini oluşturun. (Kimlik bilgileri Key Azure Portal. Kaynağınızın bağlantı dizesini yönetmehakkında bilgi edinin. Ayrıca, istemcisini uygulayan özel HTTP istemcisiyle istemciyi başlatabilirsiniz com.azure.core.http.HttpClient .
main yöntemine aşağıdaki kodu ekleyin:
// You can find your endpoint and access key from your resource in the Azure portal
String endpoint = "https://<resource-name>.communication.azure.com/";
AzureKeyCredential azureKeyCredential = new AzureKeyCredential("<access-key-credential>");
SmsClient smsClient = new SmsClientBuilder()
.endpoint(endpoint)
.credential(azureKeyCredential)
.buildClient();
Ayrıca, uç nokta ve erişim anahtarı sağlamak yerine connectionString () işlevini kullanarak tüm bağlantı dizesini de sağlayabilirsiniz.
// 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>";
SmsClient smsClient = new SmsClientBuilder()
.connectionString(connectionString)
.buildClient();
1:1 SMS iletisi gönder
Tek bir alıcıya SMS iletisi göndermek için, send SmsClient 'deki yöntemi tek bir alıcı telefon numarasıyla çağırın. Ayrıca, teslim raporunun etkinleştirilip etkinleştirilmeyeceğini ve özel Etiketler ayarlayamayacağını belirtmek için isteğe bağlı parametreleri de geçirebilirsiniz.
SmsSendResult sendResult = smsClient.send(
"<from-phone-number>",
"<to-phone-number>",
"Weekly Promotion");
System.out.println("Message Id: " + sendResult.getMessageId());
System.out.println("Recipient Number: " + sendResult.getTo());
System.out.println("Send Result Successful:" + sendResult.isSuccessful());
<from-phone-number>Iletişim Hizmetleri kaynağınız ile ILIŞKILI SMS etkin telefon numarasıyla ve <to-phone-number> ileti göndermek istediğiniz telefon numarasıyla değiştirmelisiniz.
Uyarı
Telefon numaralarının E. 164 uluslararası standart biçiminde (ör.: + 14255550123) sağlanması gerektiğini unutmayın. Kimden telefon numarası da kısa bir kod olabilir (ör: 23456).
Seçeneklerle 1: N SMS ileti gönderin
Bir alıcı listesine SMS iletisi göndermek için, bir send alıcı telefon numarası listesiyle yöntemi çağırın. Ayrıca, teslim raporunun etkinleştirilip etkinleştirilmeyeceğini ve özel Etiketler ayarlayamayacağını belirtmek için isteğe bağlı parametreleri de geçirebilirsiniz.
SmsSendOptions options = new SmsSendOptions();
options.setDeliveryReportEnabled(true);
options.setTag("Marketing");
Iterable<SmsSendResult> sendResults = smsClient.sendWithResponse(
"<from-phone-number>",
Arrays.asList("<to-phone-number1>", "<to-phone-number2>"),
"Weekly Promotion",
options /* Optional */,
Context.NONE).getValue();
for (SmsSendResult result : sendResults) {
System.out.println("Message Id: " + result.getMessageId());
System.out.println("Recipient Number: " + result.getTo());
System.out.println("Send Result Successful:" + result.isSuccessful());
}
<from-phone-number>Iletişim Hizmetleri kaynağınız ile ILIŞKILI SMS etkin telefon numarasıyla <to-phone-number-1> ve <to-phone-number-2> ileti göndermek istediğiniz telefon numarası ile değiştirmelisiniz.
Uyarı
Telefon numaralarının E. 164 uluslararası standart biçiminde (ör.: + 14255550123) sağlanması gerektiğini unutmayın. Kimden telefon numarası da kısa bir kod olabilir (ör: 23456).
setDeliveryReportEnabledYöntemi, teslim raporlamayı yapılandırmak için kullanılır. Bu, SMS iletileri teslim edildiğinde olayları yayma isteyebileceğiniz senaryolar için yararlıdır. SMS iletilerinize yönelik teslim raporlamayı yapılandırmak için SMS olayları Hızlı Başlangıç Kılavuzu ' na bakın.
setTagYöntemi teslim raporuna bir etiket uygulamak için kullanılır.
Kodu çalıştırma
pom.xml dosyasını içeren dizine gidin ve komutunu kullanarak projeyi derleyin mvn .
mvn compile
Ardından, paketini oluşturun.
mvn package
mvnUygulamayı yürütmek için aşağıdaki komutu çalıştırın.
mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false
Sorun giderme
SMS tesliminde ilgili sorunları gidermek için, teslim ayrıntılarını yakalamak üzere Event Grid ile teslim raporlamayı etkinleştirebilirsiniz .
Kaynakları temizleme
Bir Iletişim Hizmetleri aboneliğini temizleyip kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, onunla ilişkili diğer tüm kaynakları da siler. Kaynakları Temizlemehakkında daha fazla bilgi edinin.
Sonraki adımlar
Bu hızlı başlangıçta, Azure Iletişim hizmetlerini kullanarak SMS iletileri gönderme hakkında daha fazla öğrendiniz.