Deskripsi panggilan API
Notifikasi Kerja adalah pesan yang dikirim ke karyawan atas nama sebuah aplikasi, misalnya ucapan ulang tahun atau pengingat onboarding. Anda dapat mengirim teks, suara, tautan, dan lainnya. Untuk tipe pesan dan contohnya, lihat Tipe notifikasi pesan.Jika panggilan API berhasil tetapi penerima tidak menerima pesan, panggil Dapatkan hasil pengiriman pesan secara asinkron ke perusahaan untuk mengecek hasilnya dan membandingkannya dengan kode error yang tercantum dalam dokumentasi.
Kasus penggunaan
Penting
- Skenario yang berlaku: Cocok untuk mengirim pesan berjenis notifikasi, kecuali tugas Persetujuan.
- Skenario yang tidak berlaku: Ketika Anda perlu mengirim pengingat notifikasi berjenis tugas kepada karyawan, seperti tugas Persetujuan, API ini tidak dapat memenuhi kebutuhan tersebut. Untuk skenario seperti itu, gunakan API Buat Tugas sebagai gantinya.
Batas laju
Setelah batas berikut terlampaui, API mengembalikan status berhasil, tetapi pengguna tidak dapat menerima pesan.
Untuk pembatasan detail, lihat Batas laju API.
- Aplikasi internal dapat mengirim pesan ke maksimal 5.000 penerima per panggilan, sedangkan aplikasi perusahaan pihak ketiga dapat mengirim pesan ke maksimal 1.000 penerima per panggilan.
- Hanya satu notifikasi pesan dengan konten yang sama yang dapat dikirim ke karyawan yang sama per hari.
- Aplikasi internal dapat mengirim hingga 500 notifikasi pesan per karyawan per hari, dan aplikasi perusahaan pihak ketiga dapat mengirim hingga 100.
- Ketika aplikasi internal atau aplikasi perusahaan pihak ketiga mengirim pesan, hingga 5.000 penerima dapat menerima pesan per menit.