AnyLinga
ID
Masuk Coba gratis

Pusat Bantuan/Agen AI

Cara agen AI menambahkan reaksi dan menerima informasi reaksi klien

Diperbarui: 2026-11-13

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": "👍"
}
Batasnya 60 permintaan per menit.

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.

ResponsArtinya
200Reaksi terkirim ke klien; crm_mirrored menunjukkan apakah reaksi muncul di Kommo.
400message_id tidak sesuai format ID pesan atau emoji berisi lebih dari satu emoji.
401Token callback tidak valid.
404 message_not_foundPesan tidak ditemukan atau berasal dari akun lain.
422 reactions_not_supportedAnyLinga tidak mendukung penambahan reaksi di saluran ini.
422 no_messenger_idPesan tidak memiliki ID di aplikasi pesan, sehingga reaksi tidak dapat ditambahkan.
502 send_failedAplikasi 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.
Secara default, sakelar ini nonaktif. Sakelar ditampilkan untuk semua CRM.

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.

KolomIsinya
eventclient_reaction.
conversation_idPercakapan.
channelSaluran.
contact_idKontak di Kommo atau null.
message_idPesan yang diberi reaksi oleh klien: ID yang sama dengan yang ada dalam pesan masuk atau respons callback.
message_directioninbound jika reaksi diberikan pada pesan klien, outbound jika pada pesan bisnis.
emojiEmoji reaksi.
actionreact jika klien menambahkan reaksi, unreact jika menghapusnya.
tsWaktu.
Satu perubahan menghasilkan satu peristiwa: jika aplikasi pesan mengirim reaksi yang sama berulang kali, skenario hanya menerimanya sekali. Saat reaksi dihapus, unreact dikirim bersama emoji yang dihapus klien. Reaksi pada pesan lama yang tidak ada di AnyLinga tidak menghasilkan peristiwa.

Kolom apa saja yang diterima skenario, cara agen AI dan manajer bekerja dalam satu chat, cara menghubungkan agen AI melalui n8n.

Apakah artikel ini membantu?

Masih ada pertanyaan?

Kami membalas pada jam kerja.

Sudah memakai AnyLinga?

Tulis pertanyaan Anda, kami balas lewat WhatsApp atau email.

Belum punya akun?

Coba sendiri, atau kami siapkan untuk Anda saat membayar bulan pertama.

Diskusikan penyiapan

Kebutuhan Anda