AnyLinga
ID
Masuk Coba gratis

Pusat Bantuan/Agen AI

Data yang diterima alur n8n Anda dari AnyLinga

Diperbarui: 2026-11-13

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.

KolomIsi
message_textTeks pelanggan dalam bahasanya; untuk media, berisi keterangan atau label seperti [Image]; untuk pesan suara, berisi transkripsi.
translated_textTeks yang sama dalam bahasa staf di akun.
message_typetext, image, audio, document, video, atau sticker.
media_urlTautan ke file atau null. Untuk WhatsApp Business API, tautan melewati AnyLinga dan dapat dibuka tanpa autentikasi.
captionKeterangan media dari pelanggan atau null.
conversation_idID percakapan di AnyLinga; diperlukan untuk mengirim pesan kepada pelanggan terlebih dahulu.
message_idID pesan pelanggan ini di AnyLinga; agen menggunakannya untuk memberikan reaksi. Untuk pesan uji, nilainya null.
channelSaluran asal pesan.
contact_idID kontak di Kommo atau null.
adIklan Meta yang menjadi asal pelanggan mengirim pesan ini, atau null.
langBahasa pelanggan.
agent_langBahasa staf di akun.
correlation_idID permintaan ini; harus dikembalikan dalam respons.
callback_urlAlamat 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.
Templat awal n8n (Unduh .json) tidak memverifikasi tanda tangan. Anda perlu menambahkan verifikasi sendiri ke alur.

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.

Cara menghubungkan agen AI melalui n8n, pesan yang dikirim ke agen, mengapa balasan tidak sampai ke pelanggan, reaksi.

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