Pemberitahuan Communication Services
SDK obrolan dan panggilan Azure Communication Services membuat saluran olahpesan real time yang memungkinkan sinyal pesan didorong ke klien yang terhubung dengan cara yang efisien dan andal. SDK ini memungkinkan Anda membangun fungsionalitas komunikasi yang kaya secara real time ke dalam aplikasi Anda tanpa harus 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 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 secara real-time dengan cara yang andal, dapat diskalakan, dan aman. Anda dapat memanfaatkan integrasi ini untuk membuat layanan pemberitahuan yang memberikan pemberitahuan push seluler kepada pengguna Anda dengan membuat langganan event grid yang memicu Azure Function atau webhook.
Pelajari selengkapnya tentang penanganan peristiwa di Azure Communication Services.
Mengirimkan pemberitahuan push melalui Azure Notification Hubs
Penting
Azure Notification Hubs telah mengumumkan bahwa API warisan Firebase Cloud Messaging (FCM) akan ditolak pada Juli 2024. Ini akan memengaruhi semua aplikasi Panggilan dan Obrolan Azure Communiation 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, silakan lihat dokumentasi Notifcation 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.
Communication Services menggunakan Azure Notification Hub sebagai layanan pass-through untuk berkomunikasi dengan berbagai layanan pemberitahuan push khusus platform menggunakan API Direct Send. Ini memungkinkan Anda menggunakan kembali sumber daya dan konfigurasi Azure Notification Hub yang ada untuk memberikan latensi rendah, pemberitahuan yang andal 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
Menggunakan klien Azure Resource Manager untuk menautkan Notification Hub Anda
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>'}"
Menggunakan portal Microsoft Azure untuk menautkan Notification Hub Anda
Di portal, buka sumber daya Azure Communication Services Anda.
Di dalam sumber daya Communication Services, pilih Pemberitahuan Push dari menu kiri halaman Communication Services, dan sambungkan Notification Hub yang Anda sediakan sebelumnya.
Pilih Sambungkan notification hub. Anda akan melihat daftar notification hub yang tersedia untuk disambungkan.
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.
Sekarang Anda akan melihat notification hub yang Anda tautkan dengan status 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 pemberitahuan bisa saja diletakkan:
- 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 pemberitahuan dapat dihapus (Azure Notification Hubs tidak menerima pemberitahuan dari Azure Communication Services) tercakup di bawah ini. Untuk dua tempat lainnya, lihat Mendiagnosis pemberitahuan yang dihapus 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 dapat melihat di kebijakan keamanan dan akses Notification Hub
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 membuat ulang string koneksi Azure Notification Hub yang ditautkan, Anda harus memperbarui string koneksi dengan yang baru di sumber daya Communication Services Anda dengan menautkan ulang Notification Hub.
Langkah berikutnya
- Untuk pengenalan Azure Event Grid, lihat Apa itu Event Grid?
- Untuk mempelajari selengkapnya tentang konsep Azure Notification Hub, lihat Dokumentasi Azure Notification Hub