Menu dokumentasiKirim pesan ke Kanal Aplikasi
Dokumentasi APIEnglish

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.

Kunci
kf_live_ / kf_test_… di header Authorization: Bearer. Dibuat di Pengaturan › API & Webhook › Buat kunci.
Izin kunci
app_channels:write
Fitur paket
API kirim WhatsApp, Live chat website

Parameter alamat

  • idintegerwajib

    Id Kanal Aplikasi, tampil di petunjuk sambungan kanal di Live Chat.

Body (JSON)

  • external_user_idstringwajib

    Id pengguna di aplikasi Anda: 1–120 huruf, angka, atau . _ : @ -. Satu pengguna = satu chat di Inbox.

  • textstringwajib

    Pesan pengguna, maksimal 4.000 karakter.

  • namestring

    Nama pengguna, tampil di Inbox.

  • phonestring

    Nomor dengan kode negara, 8–15 digit. Menyambungkan chat ke kontak dengan nomor yang sama.

  • emailstring

    Email. Menyambungkan chat ke kontak dengan email yang sama.

Error yang mungkin

Coba

Coba sekarang dengan kunci tes
Parameter alamat
/api/v2/app-channels/{id}/messages

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.

Mulai dengan paket Free. Ajak tim setelah ruang kerja siap.