Cara agen AI menambahkan reaksi dan menerima informasi reaksi klien
Untuk menambahkan atau menghapus reaksi oleh agen AI, kirim permintaan ke /api/connect/react dengan ID pesan dan emoji. Agar skenario n8n menerima informasi reaksi klien, aktifkan Beri tahu AI tentang reaksi klien di pengaturan Gateway AI.
Cara menambahkan atau menghapus reaksi
Kirim POST /api/connect/react dengan header Authorization: Bearer <token>. Token adalah nilai kolom Token callback di halaman Hubungkan AI Anda. Token ini sama dengan yang digunakan untuk membalas klien.
Sertakan message_id dan emoji dalam isi permintaan. Reaksi dapat ditambahkan pada pesan klien maupun pesan yang dikirim agen sendiri.
Untuk menghapus reaksi, kirim string kosong: "emoji": "".
POST https://app.anylinga.com/api/connect/react
Authorization: Bearer <Token callback>
Content-Type: application/json
{
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"emoji": "👍"
}
Cara mendapatkan message_id
message_id adalah ID pesan di AnyLinga. Untuk bereaksi pada pesan klien, ambil kolom message_id dari pesan masuk yang diterima skenario.
Untuk bereaksi pada teks agen, ambil kolom message_id dari respons AnyLinga terhadap callback atau /api/connect/send. Jika yang dikirim hanya templat tanpa teks, respons tidak menyertakan kolom message_id.
Saluran yang mendukung reaksi
Agen AI dapat menambahkan reaksi di WhatsApp yang terhubung melalui kode QR, WhatsApp Business API, dan bot Telegram.
Di saluran lainnya — Telegram pribadi, Instagram, Facebook, TikTok, MAX, LinkedIn, dan chat web — AnyLinga akan mengembalikan 422 reactions_not_supported. Di Telegram pribadi, bot bisnis Telegram tidak memiliki izin untuk menambahkan reaksi.
Manajer melihat reaksi agen di chat Kommo pada pesan yang sama, seperti reaksi dari staf. Jika reaksi berhasil disalin, responsnya adalah {"ok": true, "crm_mirrored": true}.
Jika reaksi gagal disalin ke Kommo, respons akan berisi "crm_mirrored": false. Reaksi tetap terkirim ke klien.
Arti respons API
Periksa kode respons dan nilai crm_mirrored untuk membedakan antara pengiriman reaksi ke klien dan tampilnya reaksi di Kommo.
| Respons | Artinya |
|---|---|
200 | Reaksi terkirim ke klien; crm_mirrored menunjukkan apakah reaksi muncul di Kommo. |
400 | message_id tidak sesuai format ID pesan atau emoji berisi lebih dari satu emoji. |
401 | Token callback tidak valid. |
404 message_not_found | Pesan tidak ditemukan atau berasal dari akun lain. |
422 reactions_not_supported | AnyLinga tidak mendukung penambahan reaksi di saluran ini. |
422 no_messenger_id | Pesan tidak memiliki ID di aplikasi pesan, sehingga reaksi tidak dapat ditambahkan. |
502 send_failed | Aplikasi pesan menolak reaksi, misalnya jika nilai emoji bukan emoji. |
Cara mengaktifkan notifikasi reaksi klien
Sebelum mengaktifkannya, pastikan skenario memeriksa kolom event: pesan biasa dari klien tidak memiliki kolom ini.
1. Buka pengaturan Gateway AI
- Buka Alat & pengaturan → Gateway AI, lalu halaman Hubungkan AI Anda.
2. Aktifkan notifikasi reaksi
- Di bawah sakelar Aktifkan gateway, temukan Beri tahu AI tentang reaksi klien, lalu aktifkan.
- Pengaturan langsung tersimpan saat diklik. Anda tidak perlu mengeklik Simpan.
Cara menangani peristiwa client_reaction
Saat klien menambahkan atau menghapus reaksi, peristiwa client_reaction dikirim ke URL webhook n8n yang sama dengan tanda tangan X-AnyLinga-Signature yang sama. Anda tidak perlu membalas melalui callback; webhook harus mengembalikan respons 2xx. Filter berdasarkan deal tidak diterapkan pada peristiwa ini.
Bedakan peristiwa dari pesan klien melalui kolom event. Gunakan message_id untuk menentukan pesan yang diberi reaksi oleh klien.
| Kolom | Isinya |
|---|---|
event | client_reaction. |
conversation_id | Percakapan. |
channel | Saluran. |
contact_id | Kontak di Kommo atau null. |
message_id | Pesan yang diberi reaksi oleh klien: ID yang sama dengan yang ada dalam pesan masuk atau respons callback. |
message_direction | inbound jika reaksi diberikan pada pesan klien, outbound jika pada pesan bisnis. |
emoji | Emoji reaksi. |
action | react jika klien menambahkan reaksi, unreact jika menghapusnya. |
ts | Waktu. |
unreact dikirim bersama emoji yang dihapus klien. Reaksi pada pesan lama yang tidak ada di AnyLinga tidak menghasilkan peristiwa.Pertanyaan terkait
Kolom apa saja yang diterima skenario, cara agen AI dan manajer bekerja dalam satu chat, cara menghubungkan agen AI melalui n8n.
Masih ada pertanyaan?
Kami membalas pada jam kerja.