Mengirim pesan SMS

Important

Kemampuan SMS bergantung pada nomor telepon yang Anda gunakan dan negara/wilayah tempat Anda beroperasi sebagaimana ditentukan oleh alamat penagihan Azure Anda. Untuk informasi selengkapnya, lihat Kelayakan langganan.

Mulai menggunakan Azure Communication Services dengan menggunakan modul Komunikasi di Azure CLI untuk mengirim pesan SMS.

Menyelesaikan artikel ini dikenakan biaya kecil beberapa sen USD atau kurang di akun Azure Anda.

Prerequisites

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Layanan Komunikasi.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.
Versi Azure CLI terbaru untuk sistem operasi Anda.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan az --version untuk memeriksa apakah Azure CLI diinstal.

Persiapan

Menginstal modul komunikasi

Untuk menginstal modul komunikasi, jalankan perintah berikut di terminal atau jendela perintah.

az extension add --name communication

Anda perlu masuk ke Azure CLI. Anda dapat masuk menjalankan az login perintah dari terminal dan memberikan kredensial Anda.

Pastikan Anda menggunakan langganan yang benar

Jika Anda memiliki beberapa langganan di akun Anda, pastikan Anda menggunakan langganan yang benar untuk tutorial ini.

Di terminal atau jendela perintah, jalankan perintah berikut untuk memeriksa langganan saat ini.

az account show

Jika Anda perlu mengubah langganan, Anda bisa melakukannya dengan menjalankan perintah berikut.

az account set --subscription "<yourSubscriptionId>"

Anda perlu mengganti <yourSubscriptionId> dengan ID langganan aktual, yang dapat Anda temukan di bagian Langganan di portal Azure.

(Opsional) Menggunakan operasi sms Azure CLI tanpa melewati string koneksi

Anda dapat mengonfigurasi AZURE_COMMUNICATION_CONNECTION_STRING variabel lingkungan untuk menggunakan operasi sms Azure CLI tanpa harus menggunakan --connection_string untuk meneruskan string koneksi. Untuk mengonfigurasi variabel lingkungan, buka jendela konsol dan pilih sistem operasi Anda dari tab di bawah ini. Ganti <yourConnectionString> dengan string koneksi aktual Anda.

Buka jendela konsol dan masukkan perintah berikut:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Setelah Anda menambahkan variabel lingkungan, Anda mungkin perlu menghidupkan ulang program yang sedang berjalan yang perlu membaca variabel lingkungan, termasuk jendela konsol. Misalnya, jika Anda menggunakan Visual Studio sebagai editor, mulai ulang Visual Studio sebelum menjalankan contoh.

Edit .zshrc Anda, dan tambahkan variabel lingkungan:

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.zshrc dari jendela konsol Anda untuk menerapkan perubahan. Jika Anda membuat variabel lingkungan dengan IDE terbuka, Anda mungkin perlu menutup dan membuka kembali editor, IDE, atau shell untuk mengakses variabel.

Edit .bash_profile Anda, dan tambahkan variabel lingkungan:

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk menerapkan perubahan. Jika Anda membuat variabel lingkungan dengan IDE terbuka, Anda mungkin perlu menutup dan membuka kembali editor, IDE, atau shell untuk mengakses variabel.

Operations

Kirim pesan SMS 1:1

Untuk mengirim pesan SMS ke satu penerima, panggil send metode dari modul sms dengan satu nomor telepon penerima.

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>"

Buat penggantian ini dalam kode:

Ganti <fromPhoneNumber> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <toPhoneNumber> dengan nomor telepon yang ingin Anda kirimi pesan.
Ganti <yourConnectionString> dengan string koneksi Anda.

Warning

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123. Nilai untuk <fromPhoneNumber> juga dapat berupa kode pendek, misalnya, 23456 atau ID pengirim alfanumerik, misalnya, CONTOSO.

Kirim pesan SMS 1

Untuk mengirim pesan SMS ke daftar penerima, panggil send metode dari modul sms dengan beberapa nomor telepon penerima.

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber1>" "<toPhoneNumber2>" "<toPhoneNumber3>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>"

Buat penggantian ini dalam kode:

Ganti <fromPhoneNumber> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <toPhoneNumberN> dengan nomor telepon N'th yang ingin Anda kirimi pesan.
Ganti <yourConnectionString> dengan string koneksi Anda.

Warning

Berikan nomor telepon dalam format standar internasional E.164, seperti +14255550123. Nilai untuk <fromPhoneNumber> juga dapat berupa kode pendek, seperti 23456 atau ID pengirim alfanumerik, seperti CONTOSO.

Mengirim pesan SMS dengan DeliveryReport dan Tag

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>" --deliveryReport --tag "<yourCustomTag>"

Parameter deliveryReport adalah parameter opsional yang dapat Anda gunakan untuk mengonfigurasi pelaporan pengiriman. Gunakan fungsi ini jika Anda ingin memancarkan peristiwa saat pesan SMS dikirimkan. Lihat Menangani Peristiwa SMS untuk mengonfigurasi pelaporan pengiriman untuk pesan SMS Anda.

Parameter tag adalah parameter opsional yang dapat Anda gunakan untuk menerapkan tag ke laporan pengiriman.

Buat penggantian ini dalam kode:

Ganti <fromPhoneNumber> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <toPhoneNumber> dengan nomor telepon yang ingin Anda kirimi pesan.
Ganti <yourConnectionString> dengan string koneksi Anda.
Ganti <yourCustomTag> dengan tag kustom Anda.

Warning

Mulai Azure Communication Services dengan menggunakan Communication Services C# SMS SDK untuk mengirim pesan SMS.

Menyelesaikan artikel ini dikenakan biaya kecil beberapa sen USD atau kurang di akun Azure Anda.

Note

Lihat kode akhir di GitHub Sampel Azure Kirim pesan SMS menggunakan .NET.

Prerequisites

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Versi terbaru .NET Core SDK untuk sistem operasi Anda.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Layanan Komunikasi.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan dotnet perintah untuk memeriksa apakah .NET SDK telah diinstal.
Untuk melihat nomor telepon yang terkait dengan sumber daya Communication Services Anda, masuk ke portal Microsoft Azure dan temukan sumber daya Communication Services Anda. Di panel navigasi di sebelah kiri, pilih Nomor telepon.

Menyiapkan lingkungan aplikasi

Untuk menyiapkan lingkungan untuk mengirim pesan, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi C# baru

Di jendela konsol, seperti cmd, PowerShell, atau Azure CLI, gunakan perintah dotnet new untuk membuat aplikasi konsol baru bernama SmsQuickstart. Perintah ini membuat proyek C# "Halo Dunia" sederhana dengan satu file sumber, Program.cs.
```
dotnet new console -o SmsQuickstart
```
Ubah direktori Anda ke folder aplikasi yang baru dibuat dan gunakan perintah dotnet build untuk mengompilasi aplikasi Anda.
```
cd SmsQuickstart
dotnet build
```

Pasang paket

Saat masih berada di direktori aplikasi, instal azure Communication Services SMS SDK untuk paket .NET dengan menggunakan perintah berikut.
```
dotnet add package Azure.Communication.Sms --version 1.0.0
```

Tambahkan direktif using ke bagian atas Program.cs untuk menyertakan namespace Azure.Communication.


using System;
using System.Collections.Generic;

using Azure;
using Azure.Communication;
using Azure.Communication.Sms;

Model objek

Kelas serta antarmuka berikut menangani beberapa fitur utama SDK SMS Azure Communication Services untuk C#.

Name	Description
SmsClient	Kelas ini diperlukan untuk semua fungsionalitas SMS. Anda dapat memulainya dengan informasi langganan Anda, serta menggunakannya untuk mengirim pesan SMS.
SmsSendOptions	Kelas ini menyediakan opsi untuk mengonfigurasi pelaporan pengiriman. Jika enable_delivery_report diatur ke True, peristiwa akan dipancarkan saat pengiriman berhasil.
SmsSendResult	Kelas ini berisi hasil dari layanan SMS.

Mengautentikasi klien

Buka Program.cs di editor teks serta ganti isi metode Main dengan kode untuk menginisialisasi SmsClient dengan string koneksi Anda. Kode berikut mengambil string koneksi untuk sumber daya dari variabel lingkungan bernama COMMUNICATION_SERVICES_CONNECTION_STRING. Pelajari cara mengelola string koneksi sumber daya Anda.

// This code retrieves your connection string
// from an environment variable.
string connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

SmsClient smsClient = new SmsClient(connectionString);

Kirim pesan SMS 1:1

Untuk mengirim pesan SMS ke satu penerima, panggil fungsi Send atau SendAsync dari SmsClient. Tambahkan kode ini ke akhir Main metode di Program.cs:

SmsSendResult sendResult = smsClient.Send(
    from: "<from-phone-number>",
    to: "<to-phone-number>",
    message: "Hello World via SMS"
);

Console.WriteLine($"Sms id: {sendResult.MessageId}");

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <to-phone-number> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Berikan nomor telepon dalam format standar internasional E.164, seperti +14255550123. Nilai untuk <from-phone-number> juga dapat berupa kode pendek, seperti 23456 atau ID pengirim alfanumerik, seperti CONTOSO.

Kirim pesan SMS 1:N dengan opsi

Untuk mengirim pesan SMS ke daftar penerima, panggil Send fungsi atau SendAsync dari SmsClient dengan daftar nomor telepon penerima. Anda juga dapat menyediakan parameter opsional untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom.

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

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <to-phone-number-1> dan <to-phone-number-2> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Parameter enableDeliveryReport adalah parameter opsional yang dapat Anda gunakan untuk mengonfigurasi pelaporan pengiriman. Fungsionalitas ini berguna ketika Anda ingin memancarkan peristiwa saat pesan SMS dikirimkan. Lihat panduan cepat Menangani Peristiwa SMS untuk mengonfigurasi pelaporan pengiriman pesan SMS Anda.

Anda dapat menggunakan Tag parameter untuk menerapkan tag ke laporan pengiriman.

Mengirim SMS secara global dengan Messaging Connect

Important

Fitur Azure Communication Services ini saat ini dalam pratinjau. Fitur dalam pratinjau tersedia untuk umum dan dapat digunakan oleh semua pelanggan Microsoft baru dan yang sudah ada.

API pratinjau dan SDK disediakan tanpa perjanjian tingkat layanan. Kami merekomendasikan agar Anda tidak menggunakannya untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau kemampuan mungkin dibatasi.

Untuk informasi lebih lanjut, lihat Supplemental Terms of Use for Microsoft Azure Previews.

Jika Anda menggunakan nomor telepon yang disediakan melalui Messaging Connect, Anda dapat mengirim pesan SMS menggunakan SDK Azure Communication Services standar. Satu-satunya perbedaan adalah Anda harus menyertakan MessagingConnect objek untuk menentukan nama mitra dan kunci API.

Response<IReadOnlyList<SmsSendResult>> response = smsClient.Send(
    from: "<from-messaging-connect-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
        MessagingConnect = new MessagingConnectOptions("<partner-api-key>", "infobip")
    });

IEnumerable<SmsSendResult> results = response.Value;
foreach (SmsSendResult result in results)
{
    Console.WriteLine($"Sms id: {result.MessageId}");
    Console.WriteLine($"Send Result Successful: {result.Successful}");
}

Ganti nilai-nilai ini:

<from-messaging-connect-number>: Nomor telepon yang diperoleh melalui Messaging Connect dan ditautkan ke sumber daya ACS Anda.
<to-phone-number-1> dan <to-phone-number-2>: Nomor telepon penerima.
<partner-api-key>: Kunci API dari mitra Messaging Connect Anda (misalnya, Infobip).

Tip

Ingin mempelajari lebih lanjut tentang pesan global? Lihat halaman Messaging Connect

Warning

Nomor telepon harus mengikuti format standar internasional E.164 (misalnya, +14255550123). <rom-messaging-connect-number> harus berupa nomor Messaging Connect atau ID Pengirim Alfa Dinamis (misalnya, CONTOSO) yang sudah disediakan dan disinkronkan ke sumber daya ACS Anda.

Menjalankan kode

Menjalankan aplikasi dari direktori aplikasi Anda dengan perintah dotnet run.

dotnet run

Contoh kode

Unduh aplikasi sampel dari GitHub Sampel Azure Kirim pesan SMS menggunakan .NET.

Mulai menggunakan Azure Communication Services menggunakan SDK SMS JavaScript Communication Services untuk mengirim pesan SMS.

Menyelesaikan artikel ini dikenakan biaya kecil beberapa sen USD atau kurang di akun Azure Anda.

Note

Lihat kode akhir Azure Samples GitHub Kirim pesan SMS menggunakan JavaScript.

Prerequisites

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Node.js Versi LTS Aktif dan Pemeliharaan LTS (8.11.1 dan 10.14.1 direkomendasikan).
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Layanan Komunikasi.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan node --version untuk memeriksa apakah Node.js sudah dipasang.
Untuk melihat nomor telepon yang terkait dengan sumber daya Communication Services Anda, masuk ke portal Microsoft Azure dan temukan sumber daya Communication Services Anda. Di panel navigasi di sebelah kiri, pilih Nomor telepon.

Menyiapkan lingkungan aplikasi

Untuk menyiapkan lingkungan untuk mengirim pesan, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi Node.js baru

Buka terminal atau jendela perintah Anda, lalu jalankan perintah berikut untuk membuat direktori baru untuk aplikasi Anda dan navigasikan ke dalamnya.
```
mkdir sms-quickstart && cd sms-quickstart
```
Jalankan perintah berikut untuk membuat file package.json dengan pengaturan default.
```
npm init -y
```
Gunakan editor teks untuk membuat file yang disebut send-sms.js di direktori akar proyek.

Di bagian berikut, tambahkan semua kode sumber untuk mulai cepat ini ke file send-sms.js yang Anda buat.

Pasang paket

Gunakan perintah npm install untuk memasang Azure Communication Services Calling SDK untuk JavaScript.

npm install @azure/communication-sms --save

Opsi --save mencantumkan pustaka sebagai dependensi di file package.json Anda.

Model objek

Kelas dan antarmuka berikut menangani beberapa fitur utama SDK SMS Azure Communication Services untuk Node.js.

Name	Description
SmsClient	Kelas ini diperlukan untuk semua fungsionalitas SMS. Anda dapat memulainya dengan informasi langganan Anda, serta menggunakannya untuk mengirim pesan SMS.
SmsSendRequest	Antarmuka ini adalah model untuk membangun permintaan SMS. Anda menggunakannya untuk mengonfigurasi ke dan dari nomor telepon dan konten SMS.
SmsSendOptions	Antarmuka ini menyediakan opsi untuk mengonfigurasi pelaporan pengiriman. Jika `enableDeliveryReport` diatur ke `true`, peristiwa dipancarkan saat pengiriman berhasil.
SmsSendResult	Kelas ini berisi hasil dari layanan SMS.

Mengautentikasi klien

Untuk mengautentikasi klien, Anda mengimpor SmsClient dari SDK dan menginisialisasinya dengan string koneksi Anda. Anda dapat mengambil string koneksi untuk sumber daya dari variabel lingkungan. Misalnya, kode di bagian ini mengambil string koneksi dari COMMUNICATION_SERVICES_CONNECTION_STRING variabel lingkungan. Pelajari cara mengelola string koneksi sumber daya Anda.

Untuk mengimpor klien dan membuat instansnya:

Buat file bernama send-sms.js.
Tambahkan kode berikut ke send-sms.js.

const { SmsClient } = require('@azure/communication-sms');

// This code retrieves your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the SMS client.
const smsClient = new SmsClient(connectionString);

Kirim pesan SMS 1

Untuk mengirim pesan SMS ke daftar penerima, panggil send fungsi dari SmsClient dengan daftar nomor telepon penerima. Jika Anda ingin mengirim pesan ke satu penerima, sertakan hanya satu angka dalam daftar. Tambahkan kode ini ke akhir 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 the status.
  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();

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <to-phone-number-1> dan <to-phone-number-2> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123. Nilai untuk <from-phone-number> juga dapat berupa kode pendek, misalnya, 23456 atau ID pengirim alfanumerik, misalnya, CONTOSO.

Kirim pesan SMS 1:N dengan opsi

Anda juga dapat menyediakan objek opsi untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom.


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 the status.
  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();

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <to-phone-number-1> dan <to-phone-number-2> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Mengirim SMS secara global dengan Messaging Connect

Important

Fitur Azure Communication Services ini saat ini dalam pratinjau. Fitur dalam pratinjau tersedia untuk umum dan dapat digunakan oleh semua pelanggan Microsoft baru dan yang sudah ada.

Untuk informasi lebih lanjut, lihat Supplemental Terms of Use for Microsoft Azure Previews.

Jika Anda menggunakan nomor telepon yang disediakan melalui Messaging Connect, Anda dapat mengirim pesan SMS menggunakan SDK JavaScript Azure Communication Services standar. Satu-satunya perbedaan adalah Anda harus menyertakan messagingConnect objek untuk menentukan nama mitra dan kunci API.

async function main() {
  const sendResults = await smsClient.send({
    from: "<from-messaging-connect-number>",
    to: ["<to-phone-number-1>", "<to-phone-number-2>"],
    message: "Weekly Promotion!"
  }, {
    // Optional parameters
    enableDeliveryReport: true,
    tag: "marketing", // custom tag
    messagingConnect: {
      apiKey: "<partner-api-key>",
      partner: "infobip"
    }
  });

  for (const sendResult of sendResults) {
    if (sendResult.successful) {
      console.log("Success:", sendResult);
    } else {
      console.error("Failed to send message:", sendResult);
    }
  }
}

main();

Ganti nilai-nilai ini:

<from-messaging-connect-number>: Nomor telepon yang diperoleh melalui Messaging Connect dan ditautkan ke sumber daya ACS Anda.
<to-phone-number-1> dan <to-phone-number-2>: Nomor telepon penerima.
<partner-api-key>: Kunci API dari mitra Messaging Connect Anda (misalnya, Infobip).

Tip

Ingin mempelajari lebih lanjut tentang pesan global? Lihat halaman Messaging Connect

Warning

Nomor telepon harus mengikuti format standar internasional E.164 (misalnya, +14255550123). <from-messaging-connect-number> harus berupa nomor Messaging Connect atau ID Pengirim Alfa Dinamis (misalnya, CONTOSO) yang sudah disediakan dan disinkronkan ke sumber daya ACS Anda.

Parameter enableDeliveryReport memungkinkan Anda mengonfigurasi pelaporan pengiriman. Parameter tag bersifat opsional dan memungkinkan Anda menerapkan tag kustom ke laporan pengiriman. Untuk mengonfigurasi pelaporan pengiriman SMS, lihat panduan cepat Menangani Event SMS .

Menjalankan kode

node Gunakan perintah untuk menjalankan kode yang Anda tambahkan ke file send-sms.js.


node ./send-sms.js

Mulai menggunakan Azure Communication Services menggunakan Communication Services Python SMS SDK untuk mengirim pesan SMS.

Menyelesaikan panduan mulai cepat ini dikenakan biaya kecil berupa beberapa sen USD atau kurang di akun Azure Anda.

Note

Untuk kode yang diselesaikan untuk artikel ini, lihat GitHub Azure Samples Kelola nomor telepon menggunakan Python.

Prerequisites

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Python 3.7+.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Layanan Komunikasi.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan perintah python --version untuk memeriksa apakah Python dipasang.
Untuk melihat nomor telepon yang terkait dengan sumber daya Communication Services Anda, masuk ke portal Microsoft Azure dan temukan sumber daya Communication Services Anda. Di panel navigasi di sebelah kiri, pilih Nomor telepon.

Menyiapkan lingkungan aplikasi

Untuk menyiapkan lingkungan untuk mengirim pesan, selesaikan bagian berikut.

Membuat aplikasi Python baru

Buka jendela perintah atau terminal Anda. Gunakan perintah berikut untuk membuat direktori baru untuk aplikasi Anda dan navigasikan ke dalamnya.
```
mkdir sms-quickstart && cd sms-quickstart
```
Gunakan editor teks untuk membuat file yang disebut send-sms.py di direktori akar proyek dan tambahkan struktur untuk program, termasuk penanganan pengecualian dasar.
```
import os
from azure.communication.sms import SmsClient

try:
    # Quickstart code goes here.
except Exception as ex:
    print('Exception:')
    print(ex)
```

Di bagian berikut, tambahkan semua kode sumber untuk mulai cepat ini ke file send-sms.py yang Anda buat.

Pasang paket

Saat masih berada di direktori aplikasi, instal azure Communication Services SMS SDK untuk paket Python dengan menggunakan perintah berikut.

pip install azure-communication-sms

Model objek

Kelas dan antarmuka berikut menangani beberapa fitur utama Azure Communication Services SMS SDK for Python.

Name	Description
SmsClient	Kelas ini diperlukan untuk semua fungsionalitas SMS. Buat instance dengan informasi langganan Anda, dan gunakan untuk mengirim pesan SMS.
SmsSendResult	Kelas ini berisi hasil dari layanan SMS.

Mengautentikasi klien

Buat instance SmsClient dengan string koneksi Anda. Pelajari cara mengelola string koneksi sumber daya Anda.

# Create the SmsClient object that you use to send SMS messages.
sms_client = SmsClient.from_connection_string(<connection_string>)

Untuk kesederhanaan, panduan cepat ini menggunakan string koneksi, tetapi di lingkungan produksi, kami merekomendasikan penggunaan prinsipal layanan.

Kirim pesan SMS 1:1

Untuk mengirim pesan SMS ke satu penerima, panggil send metode dari SmsClient dengan satu nomor telepon penerima. Anda juga dapat menyediakan parameter opsional untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom. Tambahkan kode ini ke akhir try blok di send-sms.py:


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

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan layanan komunikasi Anda.
Ganti <to-phone-number> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Kirim pesan SMS 1

Untuk mengirim pesan SMS ke daftar penerima, panggil send metode dari SmsClient dengan daftar nomor telepon penerima. Anda juga dapat menyediakan parameter opsional untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom. Tambahkan kode ini ke akhir try blok di send-sms.py:


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

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan layanan komunikasi Anda.
Ganti <to-phone-number-1> dan <to-phone-number-2> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Parameter opsional

Parameter enable_delivery_report adalah parameter opsional yang dapat Anda gunakan untuk mengonfigurasi pelaporan pengiriman. Gunakan fungsi ini jika Anda ingin memancarkan peristiwa saat pesan SMS dikirimkan. Lihat Menangani Peristiwa SMS untuk mengonfigurasi pelaporan pengiriman untuk pesan SMS Anda.

Parameter tag adalah parameter opsional yang dapat Anda gunakan untuk menerapkan tag ke laporan pengiriman.

Menjalankan kode

Menjalankan aplikasi dari direktori aplikasi Anda dengan perintah python.

python send-sms.py

Skrip Python lengkap akan terlihat seperti kode berikut:


import os
from azure.communication.sms import SmsClient

try:
    # Create the SmsClient object that you use to send SMS messages.
    sms_client = SmsClient.from_connection_string("<connection string>")
    # Call 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)

Mulailah dengan Azure Communication Services dengan menggunakan Layanan Komunikasi Java SMS SDK untuk mengirim pesan SMS.

Menyelesaikan artikel ini dikenakan biaya kecil beberapa sen USD atau kurang di akun Azure Anda.

Note

Lihat kode akhir Azure Samples GitHub Kirim pesan SMS menggunakan Java.

Prerequisites

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Java Development Kit (JDK) versi 8 atau yang lebih baru.
Apache Maven.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Layanan Komunikasi.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan mvn -v untuk memeriksa apakah Maven diinstal.
Untuk melihat nomor telepon yang terkait dengan sumber daya Communication Services Anda, masuk ke portal Microsoft Azure dan temukan sumber daya Communication Services Anda. Di panel navigasi di sebelah kiri, pilih Nomor telepon.

Menyiapkan lingkungan aplikasi

Untuk menyiapkan lingkungan untuk mengirim pesan, selesaikan bagian berikut.

Membuat aplikasi Java baru

Buka terminal atau jendela perintah dan navigasikan ke direktori tempat Anda ingin membuat aplikasi Java. Untuk menghasilkan proyek Java dari templat maven-archetype-quickstart, jalankan perintah berikut.

Prompt Perintah

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

PowerShell

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

Tujuannya generate membuat direktori dengan nama artifactId yang sama dengan nilai . Di bawah direktori ini, direktori src/main/java berisi kode sumber proyek, direktori src/test/java berisi sumber pengujian, dan file pom.xml adalah Project Object Model (POM) proyek.

Pasang paket

Buka file pom.xml di editor teks Anda. Tambahkan elemen dependensi berikut ke grup dependensi.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-sms</artifactId>
    <version>1.0.1</version>
</dependency>

Menyiapkan kerangka kerja aplikasi

Buka /src/main/java/com/communication/quickstart/App.java di editor teks, tambahkan direktif impor, dan hapus System.out.println("Hello world!"); pernyataan:

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

Model objek

Kelas dan antarmuka berikut menangani beberapa fitur utama SDK SMS Azure Communication Services untuk Java.

Name	Description
SmsClientBuilder	Kelas ini membuat SmsClient. Anda menyediakannya dengan titik akhir, kredensial, dan klien HTTP.
SmsClient	Kelas ini diperlukan untuk semua fungsionalitas SMS. Anda menggunakannya untuk mengirim pesan SMS.
SmsSendOptions	Kelas ini menyediakan opsi untuk menambahkan tag khusus dan mengonfigurasi pelaporan pengiriman. Jika deliveryReportEnabled diatur ke true, peristiwa akan dipancarkan saat pengiriman berhasil.
SmsSendResult	Kelas ini berisi hasil dari layanan SMS.

Mengautentikasi klien

Untuk mengautentikasi klien, Anda membuat instans SmsClient dengan string koneksi Anda. Untuk kredensial, gunakan Key dari portal Azure. Pelajari cara mengelola string koneksi sumber daya Anda. Anda juga dapat menginisialisasi klien dengan klien HTTP kustom apa pun yang mengimplementasikan com.azure.core.http.HttpClient antarmuka.

Untuk membuat instans klien, tambahkan kode berikut ke main metode :

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

Anda juga dapat menyediakan seluruh string koneksi dengan menggunakan connectionString fungsi alih-alih menyediakan titik akhir dan kunci akses.

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

Kirim pesan SMS 1:1

Untuk mengirim pesan SMS ke satu penerima, hubung metode send dari SmsClient dengan satu nomor telepon penerima. Anda juga dapat menyediakan parameter opsional untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom.

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

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda.
Ganti <to-phone-number> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Kirim pesan SMS 1:N dengan opsi

Untuk mengirim pesan SMS ke daftar penerima, hubungi metode send dengan daftar nomor telepon penerima. Anda juga dapat menyediakan parameter opsional untuk menentukan apakah laporan pengiriman harus diaktifkan dan untuk mengatur tag kustom.

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

Buat penggantian ini dalam kode:

Ganti <from-phone-number> dengan nomor telepon dengan dukungan SMS yang terkait dengan sumber daya Communication Services Anda
Ganti <to-phone-number-1> dan <to-phone-number-2> dengan nomor telepon yang ingin Anda kirimi pesan.

Warning

Metode setDeliveryReportEnabled ini digunakan untuk mengonfigurasi pelaporan pengiriman. Fungsionalitas ini berguna ketika Anda ingin memancarkan peristiwa saat pesan SMS dikirimkan. Lihat panduan cepat Menangani Peristiwa SMS untuk mengonfigurasi pelaporan pengiriman pesan SMS Anda.

Untuk menerapkan tag ke laporan pengiriman, gunakan setTag metode .

Menjalankan kode

Navigasi ke direktori yang berisi file pom.xml dan kompilasi proyek menggunakan mvn perintah .
```
mvn compile
```
Buat paket.
```
mvn package
```

Jalankan perintah mvn berikut untuk menjalankan aplikasi.

Prompt Perintah


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

PowerShell

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

Gunakan konektor SMS Azure Communication Services dan Azure Logic Apps untuk membuat alur kerja otomatis yang dapat mengirim pesan SMS.

Artikel ini menjelaskan cara mengirim pesan teks secara otomatis sebagai respons terhadap peristiwa pemicu, yang merupakan langkah pertama dalam alur kerja aplikasi logika. Peristiwa pemicu dapat berupa pesan email masuk, jadwal pengulangan, peristiwa sumber daya Azure Event Grid , atau pemicu lain yang didukung oleh Azure Logic Apps.

Cuplikan layar yang memperlihatkan portal Microsoft Azure terbuka untuk Logic App Designer. Portal Microsoft Azure memperlihatkan contoh aplikasi logika yang menggunakan tindakan Kirim SMS untuk konektor Azure Communication Services.

Meskipun artikel ini berfokus pada penggunaan konektor untuk merespons pemicu, Anda juga dapat menggunakan konektor untuk merespons tindakan lain, yang merupakan langkah-langkah yang mengikuti pemicu dalam alur kerja. Jika Anda baru menggunakan Logic Apps, lihat Apa itu Azure Logic Apps sebelum Memulai.

Note

Menyelesaikan artikel ini dikenakan biaya kecil beberapa sen USD atau kurang di akun Azure Anda.

Prerequisites

Akun Azure dengan langganan aktif, atau buat akun Azure secara gratis.
Sumber daya Azure Communication Services aktif, atau buat sumber daya Communication Services.
Sumber daya Logic Apps yang aktif (aplikasi logika), atau buat aplikasi logika kosong tetapi dengan pemicu yang ingin Anda gunakan. Saat ini, konektor SMS Azure Communication Services hanya menyediakan tindakan, sehingga aplikasi logika Anda setidaknya memerlukan pemicu.

Panduan cepat ini memanfaatkan pemicu Saat email baru tiba, yang tersedia dengan konektor Office 365 Outlook.
Nomor telepon yang diaktifkan SMS, kode pendek, atau ID pengirim alfanumerik. Dapatkan nomor telepon.

Important

Kemampuan SMS dan PSTN bergantung pada nomor telepon yang Anda gunakan dan negara/wilayah tempat Anda beroperasi seperti yang ditentukan oleh alamat penagihan Azure Anda. Untuk informasi selengkapnya, kunjungi dokumentasi kelayakan Langganan .

Menambahkan tindakan SMS

Untuk menambahkan tindakan Kirim SMS sebagai langkah baru dalam alur kerja Anda dengan menggunakan konektor SMS Azure Communication Services, ikuti langkah-langkah ini di portal Microsoft Azure dengan alur kerja aplikasi logika Anda terbuka di Logic App Designer:

Pada perancang, di bawah langkah tempat Anda ingin menambahkan tindakan baru, pilih Langkah baru. Atau, untuk menambahkan tindakan baru di antara langkah-langkah, pindahkan penunjuk Anda ke panah di antara langkah-langkah tersebut, pilih tanda plus (+), dan pilih Tambahkan tindakan.
Di kotak pencarian Pilih operasi , masukkan Azure Communication Services. Dari daftar tindakan, pilih Kirim SMS.
Sekarang buat koneksi ke sumber daya Communication Services Anda.
1. Dalam langganan yang sama:
  1. Masukkan nama untuk koneksi.
  2. Pilih sumber daya Azure Communication Services Anda.
  3. Pilih Buat.
2. Menggunakan string koneksi dari sumber daya Communication Services Anda:
  1. Masukkan nama untuk koneksi.
  2. Pilih Autentikasi ConnectionString dari opsi dropdown.
  3. Masukkan string koneksi sumber daya Communication Services Anda.
  4. Pilih Buat.
3. Menggunakan Prinsipal Layanan (Lihat Pembuatan Prinsipal Layanan):
  1. Masukkan nama untuk koneksi.
  2. Pilih Autentikasi perwakilan layanan (aplikasi Microsoft Entra) dari opsi dropdown.
  3. Masukkan ID Penyewa, ID Klien & Rahasia Klien dari Perwakilan Layanan Anda.
  4. Masukkan nilai URL Titik Akhir Communication Services sumber daya Communication Services Anda.
  5. Pilih Buat.
Dalam tindakan Kirim SMS , berikan informasi berikut:
- Nomor telepon sumber dan tujuan. Untuk tujuan pengujian, Anda dapat menggunakan nomor telepon Anda sendiri sebagai nomor telepon tujuan.
- Konten pesan yang ingin Anda kirim, misalnya, "Halo dari Logic Apps!".
Berikut adalah tindakan Kirim SMS dengan informasi contoh:
Setelah selesai, pilih Simpan di toolbar alat perancang.

Selanjutnya, jalankan alur kerja Anda untuk pengujian.

Menguji alur kerja

Untuk memulai alur kerja Anda secara manual, pada toolbar perancang, pilih Jalankan. Atau, Anda dapat menunggu pemicu untuk mengaktifkan. Dalam kedua kasus, alur kerja harus mengirim pesan SMS ke nomor telepon tujuan yang Anda tentukan. Untuk informasi selengkapnya, tinjau cara menjalankan alur kerja Anda.

Membersihkan sumber daya alur kerja

Untuk membersihkan alur kerja aplikasi logika dan sumber daya terkait, tinjau cara membersihkan sumber daya Logic Apps.

Troubleshooting

Untuk memecahkan masalah yang terkait dengan pengiriman SMS, Anda dapat mengaktifkan pelaporan pengiriman dengan Event Grid untuk mengambil detail pengiriman.

Membersihkan sumber daya

Jika ingin membersihkan dan menghapus langganan Azure Communication Services, Anda bisa menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya. Pelajari selengkapnya tentang membersihkan sumber daya.

Verifikasi bebas ongkos

Untuk menggunakan nomor bebas telunjuk baru untuk mengirim pesan SMS, Anda harus menyelesaikan proses verifikasi bebas telunjuk. Untuk panduan tentang cara menyelesaikan verifikasi nomor bebas pulsa Anda, lihat Panduan pengajuan verifikasi nomor bebas pulsa. Hanya nomor bebas pulsa yang sepenuhnya diverifikasi yang berwenang untuk mengirim lalu lintas SMS. Setiap lalu lintas SMS dari nomor bebas angkutan yang belum diverifikasi yang diarahkan ke AS dan nomor telepon CA diblokir.

Langkah selanjutnya

Artikel ini menjelaskan cara mengirim pesan SMS menggunakan Azure Communication Services.

Menerima dan membalas SMS

Mengaktifkan analitik SMS

Jenis nomor telepon

Lihat informasi operator untuk nomor telepon

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-09-26

Bagikan melalui

Mengirim pesan SMS

Prerequisites

Pemeriksaan prasyarat

Persiapan

Menginstal modul komunikasi

Masuk ke Azure CLI

Pastikan Anda menggunakan langganan yang benar

(Opsional) Menggunakan operasi sms Azure CLI tanpa melewati string koneksi

Operations

Kirim pesan SMS 1:1

Kirim pesan SMS 1

Mengirim pesan SMS dengan DeliveryReport dan Tag

Prerequisites

Pemeriksaan prasyarat

Menyiapkan lingkungan aplikasi

Membuat aplikasi C# baru

Pasang paket

Model objek

Mengautentikasi klien

Kirim pesan SMS 1:1

Kirim pesan SMS 1:N dengan opsi

Mengirim SMS secara global dengan Messaging Connect

Menjalankan kode

Contoh kode

Prerequisites

Pemeriksaan prasyarat

Menyiapkan lingkungan aplikasi

Membuat aplikasi Node.js baru

Pasang paket

Model objek

Mengautentikasi klien

Kirim pesan SMS 1

Kirim pesan SMS 1:N dengan opsi

Mengirim SMS secara global dengan Messaging Connect

Menjalankan kode

Prerequisites

Pemeriksaan prasyarat

Menyiapkan lingkungan aplikasi

Membuat aplikasi Python baru

Pasang paket

Model objek

Mengautentikasi klien

Kirim pesan SMS 1:1

Kirim pesan SMS 1

Parameter opsional

Menjalankan kode

Prerequisites

Pemeriksaan prasyarat

Menyiapkan lingkungan aplikasi

Membuat aplikasi Java baru

Pasang paket

Menyiapkan kerangka kerja aplikasi

Model objek

Mengautentikasi klien

Kirim pesan SMS 1:1

Kirim pesan SMS 1:N dengan opsi

Menjalankan kode

Prerequisites

Menambahkan tindakan SMS

Menguji alur kerja

Membersihkan sumber daya alur kerja

Troubleshooting

Membersihkan sumber daya

Verifikasi bebas ongkos

Langkah selanjutnya

Saran dan Komentar

Sumber Daya Tambahan: