Bagikan melalui

Gambaran umum pemberitahuan push

Azure Communication Services Chat SDK dan Calling SDK membuat saluran olahpesan real time yang memungkinkan pesan sinyal didorong ke klien yang terhubung dengan cara yang efisien dan andal. Kemampuan ini memungkinkan Anda membangun fungsionalitas komunikasi yang kaya dan real-time ke dalam aplikasi Anda tanpa perlu menerapkan logika polling HTTP yang rumit. Namun, pada aplikasi seluler, saluran sinyal ini hanya tetap terhubung ketika aplikasi Anda aktif di latar depan. Jika Anda ingin pengguna menerima panggilan masuk atau pesan obrolan saat aplikasi Anda berada di latar belakang, Anda harus menggunakan pemberitahuan push.

Pemberitahuan push memungkinkan Anda mengirim informasi dari aplikasi Anda ke perangkat seluler pengguna. Anda dapat menggunakan pemberitahuan push untuk menampilkan dialog, memutar suara, atau menampilkan antarmuka pengguna panggilan masuk. Azure Communication Services menyediakan integrasi dengan Azure Event Grid dan Azure Notification Hub yang memungkinkan Anda menambahkan pemberitahuan push ke aplikasi Anda.

Memicu pemberitahuan push melalui Azure Event Grid

Azure Communication Services terintegrasi dengan Azure Event Grid untuk memberikan pemberitahuan peristiwa real time dengan cara yang andal, dapat diskalakan, dan aman. Anda dapat menggunakan integrasi ini untuk membuat layanan pemberitahuan yang mengirimkan pemberitahuan push seluler kepada pengguna Anda dengan membuat langganan Event Grid yang memicu Azure Function atau webhook.

Diagram memperlihatkan bagaimana Communication Services terintegrasi dengan Grid Peristiwa.

Pelajari selengkapnya tentang penanganan peristiwa di Azure Communication Services.

Mengirimkan pemberitahuan push melalui Azure Notification Hubs

Penting

Azure Notification Hubs mengumumkan bahwa API warisan Firebase Cloud Messaging (FCM) tidak digunakan lagi pada Juli 2024. Ini memengaruhi semua aplikasi Panggilan dan Obrolan Azure Communication Services yang mengirim pemberitahuan push Android. Pelanggan yang terkena dampak perlu memigrasikan pendaftaran mereka dari warisan FCM ke FCM v1, dan dapat mulai melakukannya pada Maret 2024. Untuk informasi selengkapnya termasuk langkah-langkah migrasi, lihat Dokumentasi Notification Hub.

Anda dapat menyambungkan Azure Notification Hub ke sumber daya Communication Services Anda untuk mengirim pemberitahuan push secara otomatis ke perangkat seluler pengguna saat mereka menerima panggilan masuk atau untuk memberi tahu mereka tentang aktivitas obrolan yang terlewat. Anda harus menggunakan pemberitahuan push ini untuk membangunkan aplikasi Anda dari latar belakang dan menampilkan UI yang memungkinkan pengguna menerima atau menolak panggilan atau membaca pesan obrolan yang baru diterima.

Diagram memperlihatkan bagaimana communication services terintegrasi dengan Azure Notification Hubs.

Communication Services menggunakan Azure Notification Hub sebagai layanan pass-through untuk berkomunikasi dengan berbagai layanan pemberitahuan push khusus platform menggunakan API Direct Send. Fitur ini memungkinkan Anda menggunakan kembali sumber daya dan konfigurasi Azure Notification Hub yang ada untuk memberikan latensi rendah, pemberitahuan yang dapat diandalkan ke aplikasi Anda.

Catatan

Saat ini pemberitahuan push panggilan dan obrolan didukung untuk Android dan iOS.

Penyediaan Notification Hub

Untuk mengirimkan pemberitahuan push ke perangkat klien menggunakan Notification Hubs, buat Notification Hub di langganan yang sama dengan sumber daya Communication Services Anda. Anda harus mengonfigurasi Azure Notification Hub untuk Sistem Pemberitahuan Platform yang ingin Anda gunakan. Untuk mempelajari cara mendapatkan pemberitahuan push di aplikasi klien Anda dari Notification Hubs, lihat Mulai menggunakan Notification Hubs dan pilih platform klien target Anda dari daftar menurun di dekat bagian atas halaman.

Catatan

Platform APN dan FCM saat ini didukung.

Platform APN harus dikonfigurasi dengan mode autentikasi token. Mode autentikasi sertifikat tidak didukung sampai sekarang.

Setelah Notification hub dikonfigurasi, Anda dapat mengaitkannya ke sumber daya Communication Services dengan menyediakan string koneksi untuk hub menggunakan Azure Resource Manager Client atau melalui portal Microsoft Azure. String koneksi harus berisi izin Send. Sebaiknya buat kebijakan akses lain Send hanya dengan izin khusus untuk hub Anda. Pelajari selengkapnya tentang kebijakan keamanan dan akses Notification Hubs

Untuk masuk ke Azure Resource Manager, jalankan hal berikut dan masuk menggunakan informasi masuk Anda.

armclient login

Setelah berhasil masuk, jalankan hal berikut untuk menyediakan notification hub:

armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"

  1. Di portal, buka sumber daya Azure Communication Services Anda.

  2. Di dalam sumber daya Communication Services, pilih Pemberitahuan Push dari menu kiri halaman Communication Services, dan sambungkan Notification Hub yang Anda sediakan sebelumnya.

  3. Pilih Sambungkan notification hub. Anda melihat daftar hub pemberitahuan yang tersedia untuk dihubungkan.

  4. Pilih notification hub yang ingin Anda gunakan untuk sumber daya ini.

    • Jika Anda perlu membuat hub baru, pilih Buat notification hub baru untuk mendapatkan hub baru yang disediakan untuk sumber daya ini.

    Cuplikan layar memperlihatkan pengaturan Pemberitahuan Push di dalam portal Microsoft Azure.

Sekarang Anda melihat hub pemberitahuan yang telah Anda tautkan dalam keadaan tersambung.

Jika Anda ingin menggunakan hub lain untuk sumber daya, pilih Putuskan sambunagn, lalu ulangi langkah-langkah untuk menautkan notification hub yang berbeda.

Catatan

Setiap perubahan tentang bagaimana hub ditautkan tercermin dalam sarana data (yaitu, saat mengirim pemberitahuan) dalam periode maksimum 10 menit. Perilaku yang sama ini berlaku saat hub ditautkan untuk pertama kalinya, jika pemberitahuan dikirim sebelum perubahan.

Pendaftaran perangkat

Lihat mulai cepat panggilan suara dan mulai cepat obrolan untuk mempelajari cara mendaftarkan handel perangkat Anda dengan Communication Services.

Panduan pemecahan masalah untuk pemberitahuan push

Saat Anda tidak melihat pemberitahuan push di perangkat Anda, ada tiga tempat di mana pemberitahuan mungkin dihilangkan:

  • Azure Notification Hubs tidak menerima pemberitahuan dari Azure Communication Services
  • Sistem Pemberitahuan Platform (misalnya APN dan FCM) tidak menerima pemberitahuan dari Azure Notification Hubs
  • Sistem Pemberitahuan Platform tidak mengirimkan pemberitahuan ke perangkat.

Tempat pertama di mana pemberitahuan dapat dihilangkan (Azure Notification Hubs tidak menerima pemberitahuan dari Azure Communication Services) tercakup dalam deskripsi berikut. Untuk informasi selengkapnya, lihat Mendiagnosis pemberitahuan yang dihilangkan di Azure Notification Hubs.

Salah satu cara untuk melihat apakah sumber daya Communication Services Anda mengirim pemberitahuan ke Azure Notification Hubs adalah dengan melihat metrik incoming messages dari metrik Azure Notification Hubs yang ditautkan.

Berikut ini adalah beberapa kesalahan konfigurasi umum yang mungkin menjadi penyebab Azure Notification Hub tidak menerima pemberitahuan dari sumber daya Communication Services Anda.

Azure Notification Hub tidak ditautkan ke sumber daya Communication Services

Mungkin ada kasus bahwa Anda tidak menautkan Azure Notification Hub Anda ke sumber daya communication Services Anda. Anda dapat melihat di bagian Penyediaan Notification Hub untuk melihat cara menautkannya.

Azure Notification Hub yang ditautkan tidak dikonfigurasi

Anda harus mengonfigurasi Notification Hub yang ditautkan dengan informasi masuk Sistem Pemberitahuan Platform untuk platform (misalnya, iOS atau android) yang ingin Anda gunakan. Untuk detail selengkapnya tentang cara melakukannya, Anda dapat melihat di Menyiapkan pemberitahuan push di notification hub.

Azure Notification Hub yang ditautkan tidak ada

Azure Notification Hub yang ditautkan ke sumber daya Communication Services Anda tidak ada lagi. Periksa apakah Notification Hub yang ditautkan masih ada.

Platform APN Azure Notification Hub dikonfigurasi dengan mode autentikasi sertifikat

Jika Anda ingin menggunakan platform APN dengan mode autentikasi sertifikat, platform tersebut saat ini tidak didukung. Anda harus mengonfigurasi platform APN dengan mode autentikasi token seperti yang ditentukan di Menyiapkan pemberitahuan push di notification hub.

String koneksi yang ditautkan tidak memiliki izin Send

String koneksi yang Anda gunakan untuk menautkan Notification Hub ke sumber daya Communication Services Anda harus memiliki izin Send. Untuk detail selengkapnya tentang cara membuat string koneksi baru atau melihat string koneksi saat ini dari Azure Notification Hub Anda, lihat Kebijakan keamanan dan akses Notification Hubs

String koneksi tertaut atau resourceId Azure Notification Hub tidak valid

Pastikan Anda mengonfigurasi sumber daya Communication Services dengan string koneksi yang benar dan resourceId Azure Notification Hub

String koneksi yang ditautkan dibuat ulang

Jika Anda meregenerasi string koneksi dari Azure Notification Hub yang ditautkan, Anda perlu memperbarui string koneksi tersebut dengan string baru di sumber daya Communication Services Anda dengan menautkan kembali hub pemberitahuan tersebut.

Langkah berikutnya