POST/api/v2/app-channels/{id}/messages
Kirim pesan ke Kanal Aplikasi
Teruskan satu pesan pengguna aplikasi Anda ke Inbox; balasan AI Agent dan otomasi ikut di jawaban.
Pesan masuk Inbox sebagai chat berlabel Aplikasi, satu chat per external_user_id. Otomasi "Pesan masuk" dan AI Agent kanal itu menjawab seperti live chat website, dan balasannya ada di replies. Semua yang dikirim di chat itu sesudahnya (balasan tim, file, balasan saat dioper) dikirim ke aplikasi lewat webhook message.sent. Bila AI menjawab, permintaan butuh beberapa detik, jadi beri batas waktu 60 detik. Panggil dari server aplikasi Anda saja, dengan Idempotency-Key: pesan dengan kunci yang sama tidak disimpan dua kali (jawaban 200 bila pesan itu sudah tersimpan). Lihat panduan Kanal Aplikasi.
Kirim header Idempotency-Key (misalnya UUID baru per permintaan). Ulangan dengan kunci yang sama dalam 24 jam mendapat jawaban pertama lagi, jadi tidak terkirim dua kali.
Bila chat belum punya kontak, name, phone, atau email menyambungkannya ke kontak dengan nomor atau email yang sama, atau membuat kontak baru. Tanpa ketiganya, chat tetap tanpa kontak seperti live chat anonim.
Balasan AI dan otomasi ada di replies dan juga dikirim lewat message.sent; pakai message_id agar tidak tampil dua kali.
Parameter alamat
idintegerwajibId Kanal Aplikasi, tampil di petunjuk sambungan kanal di Live Chat.
Body (JSON)
external_user_idstringwajibId pengguna di aplikasi Anda: 1–120 huruf, angka, atau
. _ : @ -. Satu pengguna = satu chat di Inbox.textstringwajibPesan pengguna, maksimal 4.000 karakter.
namestringNama pengguna, tampil di Inbox.
phonestringNomor dengan kode negara, 8–15 digit. Menyambungkan chat ke kontak dengan nomor yang sama.
emailstringEmail. Menyambungkan chat ke kontak dengan email yang sama.
Error yang mungkin
- 400
invalid_jsonBody bukan JSON yang sah - 400
idempotency_key_invalidIdempotency-Key tidak sah - 401
missing_keyKunci API belum dikirim - 401
key_invalidKunci API tidak dikenal - 401
key_revokedKunci API sudah dicabut - 401
key_expiredKunci API kedaluwarsa - 401
member_inactivePembuat kunci bukan anggota lagi - 403
ip_not_allowedIP server tidak ada di daftar kunci - 403
plan_no_apiPaket belum memuat API untuk kunci live - 403
tenant_blockedAkses bisnis ditangguhkan - 403
scope_missingKunci tidak punya izin ini - 403
permission_missingRole pembuat kunci tidak punya izin ini - 403
live_key_requiredButuh kunci live - 403
app_channel_pausedKanal Aplikasi dijeda atau di luar paket - 404
not_foundTidak ditemukan - 409
idempotency_conflictIdempotency-Key dipakai untuk isi lain - 409
request_in_progressPermintaan yang sama masih diproses - 422
invalid_requestField tidak sah - 422
invalid_phoneNomor tujuan tidak sah - 422
message_too_longPesan terlalu panjang - 429
rate_limitedTerlalu banyak permintaan per menit - 500
internal_errorGangguan di Klik Flow
Coba
Coba sekarang dengan kunci tes
/api/v2/app-channels/{id}/messages