Data yang diterima alur n8n Anda dari AnyLinga
AnyLinga mengirim JSON ke alur n8n Anda yang berisi pesan pelanggan, terjemahan, data media, bahasa, serta ID percakapan dan kontak. Permintaan ini juga menyertakan correlation_id, yang harus dikembalikan dalam respons, dan callback_url — alamat untuk mengirim balasan.
Cara permintaan dikirim dan isinya
AnyLinga mengirim POST ke URL webhook n8n.
Header permintaan: Content-Type: application/json dan X-AnyLinga-Signature.
Saat Anda mengeklik Uji koneksi, pesan uji akan dikirim: teks AnyLinga Connect test, channel: test, dan kolom tambahan test: true.
| Kolom | Isi |
|---|---|
message_text | Teks pelanggan dalam bahasanya; untuk media, berisi keterangan atau label seperti [Image]; untuk pesan suara, berisi transkripsi. |
translated_text | Teks yang sama dalam bahasa staf di akun. |
message_type | text, image, audio, document, video, atau sticker. |
media_url | Tautan ke file atau null. Untuk WhatsApp Business API, tautan melewati AnyLinga dan dapat dibuka tanpa autentikasi. |
caption | Keterangan media dari pelanggan atau null. |
conversation_id | ID percakapan di AnyLinga; diperlukan untuk mengirim pesan kepada pelanggan terlebih dahulu. |
message_id | ID pesan pelanggan ini di AnyLinga; agen menggunakannya untuk memberikan reaksi. Untuk pesan uji, nilainya null. |
channel | Saluran asal pesan. |
contact_id | ID kontak di Kommo atau null. |
ad | Iklan Meta yang menjadi asal pelanggan mengirim pesan ini, atau null. |
lang | Bahasa pelanggan. |
agent_lang | Bahasa staf di akun. |
correlation_id | ID permintaan ini; harus dikembalikan dalam respons. |
callback_url | Alamat untuk mengirim balasan. |
Contoh JSON
Berikut contoh permintaan dengan pesan teks pelanggan dalam bahasa Spanyol dan terjemahan dalam bahasa Indonesia.
{
"message_text": "Hola, ¿tienen envío a Lima?",
"translated_text": "Halo, apakah ada pengiriman ke Lima?",
"message_type": "text",
"media_url": null,
"caption": null,
"conversation_id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c4f12",
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"channel": "wa_business",
"contact_id": 12329727,
"ad": null,
"lang": "es",
"agent_lang": "id",
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"callback_url": "https://app.anylinga.com/api/connect/callback"
}
Cara memverifikasi tanda tangan permintaan
1. Ambil secret penandatanganan
- Di halaman Hubungkan AI Anda, ambil nilai kolom Secret penandatanganan (X-AnyLinga-Signature).
2. Hitung tanda tangan isi permintaan
- Hitung HMAC-SHA256 dari isi mentah permintaan tanpa perubahan, menggunakan secret sebagai kunci.
- Ubah hasilnya ke format hex untuk dibandingkan dengan
X-AnyLinga-Signature.
3. Bandingkan tanda tangan dengan header
- Bandingkan nilai yang dihitung dengan nilai header
X-AnyLinga-Signature. - Jika nilainya tidak cocok, permintaan bukan dari AnyLinga — jangan diproses.
Mengapa permintaan tidak menyertakan deal
Deal tidak disertakan dalam permintaan — hanya contact_id, yaitu ID kontak di Kommo, atau null. Jika alur memerlukan deal, cari berdasarkan kontak melalui API Kommo.
Pertanyaan terkait
Cara menghubungkan agen AI melalui n8n, pesan yang dikirim ke agen, mengapa balasan tidak sampai ke pelanggan, reaksi.
Masih ada pertanyaan?
Kami membalas pada jam kerja.