Autentikasi dan scope
Akses API dengan kredensial yang terikat pada satu workspace.
Bearer token
Authorization: Bearer YOUR_API_KEYHeader X-API-Key juga didukung. Gunakan HTTPS dan simpan kunci di backend aplikasi Anda, bukan pada bundle frontend atau repositori.
Scope operasi
- bots:read — membaca akun messenger.
- chats:read — membaca percakapan dan pesan.
- chats:write — memperbarui percakapan.
- messages:send — membuka percakapan dan mengantrekan pesan keluar.
- bots:write — mengelola koneksi dan pairing akun.
Pemisahan workspace
WORKSPACE_ID dalam URL harus cocok dengan workspace API key. Kunci tidak dapat berpindah workspace dengan header, cookie, atau parameter lain.
Rotasi dan pencabutan
Buat kunci baru, pindahkan integrasi Anda, lalu nonaktifkan kunci lama. Otorisasi diperiksa ulang sebelum pengiriman pesan sehingga antrean tidak memberi hak permanen kepada kunci yang telah dicabut.