Yardım Merkezi/Yapay zeka asistanı
n8n senaryonuz AnyLinga'dan hangi verileri alır?
AnyLinga, n8n senaryonuza müşterinin mesajını, çevirisini, medya bilgilerini, dilini, konuşma ve kişi kimliklerini içeren bir JSON gönderir. İstekte ayrıca yanıtta geri göndermeniz gereken correlation_id ve yanıtı göndereceğiniz adres olan callback_url bulunur.
İstek nasıl gelir ve neler içerir?
AnyLinga, n8n webhook URL'sine bir POST isteği gönderir.
İstek başlıkları: Content-Type: application/json ve X-AnyLinga-Signature.
Bağlantıyı test et düğmesine tıkladığınızda bir test mesajı gelir: metin AnyLinga Connect test, channel: test ve ek alan test: true.
| Alan | İçeriği |
|---|---|
message_text | Müşterinin kendi dilindeki metni; medya için açıklama veya [Image] gibi bir etiket; sesli mesaj için yazıya dökülmüş metin. |
translated_text | Aynı metnin paneldeki temsilcilerin diline çevirisi. |
message_type | text, image, audio, document, video veya sticker. |
media_url | Dosya bağlantısı veya null. WhatsApp Business API'de bağlantı AnyLinga üzerinden geçer ve kimlik doğrulama olmadan açılır. |
caption | Müşterinin medyaya eklediği açıklama veya null. |
conversation_id | AnyLinga'daki konuşmanın kimliği; müşteriye ilk mesajı göndermek için gereklidir. |
message_id | Müşterinin bu mesajının AnyLinga'daki kimliği; ajan bu kimlikle mesaja tepki verir. Test mesajında null olur. |
channel | Mesajın geldiği kanal. |
contact_id | Kommo'daki kişinin kimliği veya null. |
ad | Müşterinin bu mesajı gönderirken geldiği Meta reklamı veya null. |
lang | Müşterinin dili. |
agent_lang | Paneldeki temsilcilerin dili. |
correlation_id | Bu isteğin kimliği; yanıtta geri gönderilmelidir. |
callback_url | Yanıtın gönderileceği adres. |
JSON örneği
Müşterinin İspanyolca metin mesajını ve Rusça çevirisini içeren bir istek şöyle görünür.
{
"message_text": "Hola, ¿tienen envío a Lima?",
"translated_text": "Merhaba, Lima'ya teslimat yapıyor musunuz?",
"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": "tr",
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"callback_url": "https://app.anylinga.com/api/connect/callback"
}
İsteğin imzası nasıl doğrulanır?
1. İmzalama gizli anahtarını alın
- Kendi yapay zekânı bağla sayfasındaki İmzalama gizli anahtarı (X-AnyLinga-Signature) alanının değerini alın.
2. İstek gövdesinin imzasını hesaplayın
- Gizli anahtarı anahtar olarak kullanıp ham istek gövdesini değiştirmeden HMAC-SHA256 değerini hesaplayın.
X-AnyLinga-Signatureile karşılaştırmak için sonucu onaltılık biçime dönüştürün.
3. İmzayı başlıkla karşılaştırın
- Hesaplanan değeri
X-AnyLinga-Signaturebaşlığının değeriyle karşılaştırın. - Değerler eşleşmiyorsa istek AnyLinga'dan gelmemiştir. İsteği işlemeyin.
İstekte neden satış fırsatı yok?
İstekte satış fırsatı gönderilmez. Yalnızca Kommo'daki kişinin kimliği olan contact_id veya null gönderilir. Senaryonun bir satış fırsatına ihtiyacı varsa bunu Kommo API'si üzerinden kişiye göre bulmalısınız.
İlgili sorular
n8n üzerinden yapay zekâ ajanı nasıl bağlanır?, ajana hangi mesajlar gönderilir?, yanıt neden müşteriye ulaşmaz?, tepkiler.
Sorunuz mu var?
Mesai saatlerinde yanıtlıyoruz.
Henüz hesabınız yok mu?
Kendiniz deneyin ya da ilk ayı ödediğinizde kurulumu biz yapalım.