Какие данные получает ваш сценарий n8n от AnyLinga
AnyLinga отправляет в ваш сценарий n8n JSON с сообщением клиента, переводом, данными медиа, языком и идентификаторами беседы и контакта. В запросе также есть correlation_id, который нужно вернуть в ответе, и callback_url — адрес для отправки ответа.
Как приходит запрос и что в нём
AnyLinga отправляет POST на URL вебхука n8n.
Заголовки запроса: Content-Type: application/json и X-AnyLinga-Signature.
При нажатии Проверить подключение приходит тестовое сообщение: текст AnyLinga Connect test, channel: test и дополнительное поле test: true.
| Поле | Что в нём |
|---|---|
message_text | Текст клиента на его языке; у медиа — подпись или метка вроде [Image]; у голосового — расшифровка. |
translated_text | Тот же текст на языке менеджеров кабинета. |
message_type | text, image, audio, document, video или sticker. |
media_url | Ссылка на файл или null. У WhatsApp Business API ссылка ведёт через AnyLinga и открывается без авторизации. |
caption | Подпись клиента к медиа или null. |
conversation_id | id беседы в AnyLinga; нужен, чтобы написать клиенту первым. |
message_id | id этого сообщения клиента в AnyLinga; по нему агент ставит реакцию. У тестового сообщения — null. |
channel | Канал, из которого пришло сообщение. |
contact_id | id контакта в amoCRM или null. |
ad | Объявление Meta, с которого клиент написал это сообщение, или null. |
lang | Язык клиента. |
agent_lang | Язык менеджеров кабинета. |
correlation_id | id этого запроса; его нужно вернуть в ответе. |
callback_url | Куда отправить ответ. |
Пример JSON
Так выглядит запрос с текстовым сообщением клиента на испанском и переводом на русский.
{
"message_text": "Hola, ¿tienen envío a Lima?",
"translated_text": "Здравствуйте, у вас есть доставка в Лиму?",
"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": "ru",
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"callback_url": "https://app.anylinga.com/api/connect/callback"
}
Как проверить подпись запроса
1. Возьмите секрет подписи
- На странице Подключите свой ИИ возьмите значение поля Секрет подписи (X-AnyLinga-Signature).
2. Рассчитайте подпись тела запроса
- Посчитайте HMAC-SHA256 от сырого тела запроса как оно есть, используя секрет в качестве ключа.
- Представьте результат в hex для сравнения с
X-AnyLinga-Signature.
3. Сравните подпись с заголовком
- Сравните рассчитанное значение со значением заголовка
X-AnyLinga-Signature. - Если значения не совпали, запрос не от AnyLinga — не обрабатывайте его.
Почему в запросе нет сделки
Сделка в запросе не передаётся — только contact_id, идентификатор контакта в amoCRM, или null. Если сценарию нужна сделка, её нужно найти по контакту через API amoCRM.
Связанные вопросы
Как подключить ИИ-агента через n8n, какие сообщения уходят агенту, почему ответ не доходит до клиента, реакции.
Остались вопросы?
Ответим в рабочее время.
Ещё нет аккаунта?
Попробуйте сами или подключим за вас при оплате первого месяца.