Bagikan melalui


Mulai cepat: Menangani peristiwa SMS dan laporan pengiriman

Mulai menggunakan Azure Communication Services dengan menggunakan Azure Event Grid untuk menangani peristiwa SMS Communication Services. Setelah berlangganan peristiwa SMS seperti pesan masuk dan laporan pengiriman, Anda membuat dan menerima peristiwa ini. Menyelesaikan mulai cepat ini dikenakan sedikit biaya sekitar beberapa sen USD atau kurang di akun Azure Anda.

Penting

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

Prasyarat

Tentang Azure Event Grid

Event Grid adalah layanan peristiwa berbasis cloud. Dalam artikel ini, Anda akan mempelajari cara berlangganan peristiwa layanan komunikasi, dan memicu peristiwa untuk melihat hasilnya. Biasanya, Anda mengirim peristiwa ke titik akhir yang memproses data peristiwa dan mengambil tindakan. Di artikel ini, kami akan mengirim peristiwa ke aplikasi web yang mengumpulkan dan menampilkan pesan.

Menyiapkan lingkungan

Untuk menyiapkan lingkungan yang akan kita gunakan untuk menghasilkan dan menerima peristiwa, lakukan langkah-langkah di bagian berikut.

Mendaftarkan penyedia sumber daya Event Grid

Jika sebelumnya Anda belum menggunakan Event Grid di langganan Azure, Anda mungkin perlu mendaftarkan penyedia sumber daya Event Grid Anda. Untuk mendaftarkan penyedia, ikuti langkah-langkah berikut:

  1. Masuk ke portal Microsoft Azure.
  2. Di menu sebelah kiri, pilih Langganan.
  3. Pilih langganan yang Anda gunakan untuk Event Grid.
  4. Di menu sebelah kiri, di bawah Pengaturan, pilih Penyedia sumber daya.
  5. Cari Microsoft.EventGrid.
  6. Jika penyedia sumber daya Anda tidak terdaftar, pilih Daftar.

Mungkin perlu beberapa saat agar pendaftaran selesai. Pilih Refresh untuk memperbarui status. Saat Terdaftar muncul di bawah Status, Anda siap untuk melanjutkan.

Menyebarkan penampil Event Grid

Untuk mulai cepat ini, kita akan menggunakan penampil Event Grid untuk melihat acara mendekati real time. Penampil memberi pengguna pengalaman umpan real-time. Selain itu, payload setiap peristiwa harus tersedia untuk diperiksa.

Untuk menyiapkan penampil, ikuti langkah-langkah di Azure Event Grid Viewer.

Berlangganan peristiwa SMS dengan menggunakan webhook

Anda dapat berlangganan peristiwa tertentu untuk memberi Event Grid informasi tentang tempat mengirim peristiwa yang ingin Anda lacak.

  1. Di portal, buka sumber daya Communication Services yang Anda buat.

  2. Di dalam sumber daya Communication Services, di menu sebelah kiri halaman Communication Services , pilih Peristiwa.

  3. Pilih Tambahkan Langganan Peristiwa.

    Cuplikan layar yang memperlihatkan halaman Peristiwa dari sumber daya Azure Communication Services. Tombol Langganan Peristiwa dipanggil.

  4. Pada halaman Buat Langganan Peristiwa , masukkan nama untuk langganan peristiwa.

  5. Di bawah Jenis Peristiwa, pilih peristiwa yang ingin Anda berlangganan. Untuk SMS, Anda dapat memilih SMS Received dan SMS Delivery Report Received.

  6. Jika Anda diminta untuk memberikan Nama Topik Sistem, jangan ragu untuk memberikan string yang unik. Bidang ini tidak berdampak pada pengalaman Anda dan digunakan untuk keperluan telemetri internal.

    Cuplikan layar yang memperlihatkan dialog Buat Langganan Peristiwa. Di bawah Jenis Peristiwa, Laporan Pengiriman SMS yang Diterima dan SMS Diterima dipilih.

  7. Untuk Jenis titik akhir, pilih Web Hook.

    Cuplikan layar yang memperlihatkan detail dialog Buat Langganan Peristiwa. Di daftar Jenis Titik Akhir, Web Hook dipilih.

  8. Untuk Titik Akhir, pilih Pilih titik akhir, lalu masukkan URL aplikasi web Anda.

    Dalam hal ini, kita akan menggunakan URL dari penampil Event Grid yang kita siapkan sebelumnya di mulai cepat. URL untuk sampel memiliki format ini: https://{{site-name}}.azurewebsites.net/api/updates

  9. Pilih Konfirmasi Pilihan.

    Cuplikan layar yang memperlihatkan dialog Pilih Web Hook. Kotak Titik Akhir Pelanggan berisi U R L, dan tombol Konfirmasi Pilihan terlihat.

Melihat peristiwa SMS

Untuk membuat dan menerima peristiwa SMS, lakukan langkah-langkah di bagian berikut.

Memicu peristiwa SMS

Untuk melihat pemicu peristiwa, kita perlu menghasilkan beberapa peristiwa.

  • Peristiwa SMS Received dihasilkan ketika nomor telepon Communication Services menerima pesan teks. Untuk memicu peristiwa, kirim pesan dari telepon Anda ke nomor telepon yang dilampirkan ke sumber daya Communication Services Anda.
  • SMS Delivery Report Received peristiwa dihasilkan saat Anda mengirim SMS ke pengguna dengan menggunakan nomor telepon Communication Services. Untuk memicu peristiwa, Anda perlu mengaktifkan Delivery Report opsi SMS yang Anda kirim. Coba kirim pesan ke ponsel Anda dengan Delivery Report diaktifkan. Menyelesaikan tindakan ini dikenakan biaya ringan berupa beberapa sen USD atau lebih murah di akun Azure Anda.

Lihat daftar lengkap peristiwa yang didukung Communication Services.

Menerima peristiwa SMS

Setelah membuat peristiwa, Anda akan melihat bahwa SMS Received dan SMS Delivery Report Received peristiwa dikirim ke titik akhir Anda. Peristiwa ini muncul di penampil Event Grid yang kami siapkan di awal mulai cepat ini. Pilih ikon mata di samping peristiwa untuk melihat seluruh payload. Peristiwa akan terlihat mirip dengan data berikut:

Cuplikan layar penampil Azure Event Grid yang memperlihatkan skema Event Grid untuk peristiwa yang diterima SMS.

Cuplikan layar penampil Azure Event Grid yang memperlihatkan skema Event Grid untuk peristiwa laporan pengiriman SMS.

Pelajari lebih lanjut tentang skema peristiwa dan konsep peristiwa lainnya.

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 lebih lanjut cara membersihkan sumber daya.

Langkah berikutnya

Dalam mulai cepat ini, Anda belajar cara menggunakan peristiwa SMS. Anda dapat menerima pesan SMS dengan membuat langganan Event Grid.

Anda mungkin juga ingin: