Mulai cepat: Menangani peristiwa Email

Mulai menggunakan Azure Communication Services dengan menggunakan Azure Event Grid untuk menangani peristiwa Email Communication Services. Setelah berlangganan peristiwa Email seperti laporan pengiriman dan laporan keterlibatan, Anda membuat dan menerima peristiwa ini. Menyelesaikan panduan mulai cepat ini dikenakan biaya kecil berupa beberapa sen USD atau kurang di akun Azure Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Sumber daya Communication Services. Untuk informasi mendetail, lihat Membuat sumber daya Azure Communication Services.
• Sumber daya Email dengan domain yang disediakan. Buat Sumber Daya Email.

Tentang Event Grid

Event Grid adalah layanan eventing 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. Buka 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.

Sebarkan penampil Event Grid

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

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

Berlangganan peristiwa Email dengan menggunakan web hook

Anda dapat berlangganan peristiwa tertentu untuk memberikan 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.

   

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

5. Di bawah Jenis Peristiwa, pilih peristiwa yang ingin Anda berlangganan. Untuk Email, Anda dapat memilih Email Delivery Report Received dan Email Engagement Tracking 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.

   

7. Untuk Jenis titik akhir, pilih Web Hook.

   

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.

   

Menampilkan peristiwa Email

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

Memicu peristiwa Email

Untuk melihat pemicu peristiwa, kita perlu menghasilkan beberapa peristiwa. Untuk memicu peristiwa, kirim email menggunakan sumber daya domain Email yang dilampirkan ke sumber daya Communication Services.

• Email Delivery Report Received peristiwa dihasilkan ketika status Email dalam status terminal, seperti Terkirim, Gagal, FilteredSpam, Dikarantina.

• Email Engagement Tracking Report Received peristiwa dihasilkan ketika email yang dikirim dibuka atau tautan dalam email diklik. Untuk memicu peristiwa, Anda perlu mengaktifkan User Interaction Tracking opsi pada sumber daya domain Email

Lihat daftar lengkap peristiwa yang didukung Communication Services.

Menerima peristiwa Email

Setelah membuat peristiwa, Anda akan melihat bahwa Email Delivery Report Received dan Email Engagement Tracking 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:

• EngagementContext mengacu pada tautan yang diklik ketika engagementType adalah Click.
• UserAgent mengacu pada Agen Pengguna tempat peristiwa keterlibatan email ini berasal. Mis. Jika pengguna berinteraksi di Edge menggunakan mesin Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, seperti Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
• EngagementType mengacu pada jenis keterlibatan, nilai yang mungkin adalah 'Lihat' atau 'Klik'.

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 selengkapnya tentang membersihkan sumber daya.

Langkah berikutnya

Dalam mulai cepat ini, Anda mempelajari cara menggunakan peristiwa Email. Anda dapat menerima peristiwa Email dengan membuat langganan Event Grid.

Kirim Email

Untuk informasi skema dan contoh peristiwa, lihat Azure Communication Services - Peristiwa email.

Anda mungkin juga ingin melihat artikel berikut:

• Mempelajari tentang konsep penanganan peristiwa
• Mempelajari tentang Event Grid