Как ИИ-агенту ставить реакции и узнавать о реакциях клиента
Чтобы ИИ-агент поставил или снял реакцию, отправьте запрос на /api/connect/react с id сообщения и эмодзи. Чтобы сценарий n8n узнавал о реакциях клиента, включите Сообщать ИИ о реакциях клиента в настройках ИИ-шлюза.
Как поставить или снять реакцию
Отправьте POST /api/connect/react с заголовком Authorization: Bearer <токен>. Токен — значение поля Токен callback на странице Подключите свой ИИ. Это тот же токен, который используется для ответа клиенту.
В теле передайте message_id и emoji. Реагировать можно как на сообщение клиента, так и на сообщение, которое отправил сам агент.
Чтобы снять реакцию, передайте пустую строку: "emoji": "".
POST https://app.anylinga.com/api/connect/react
Authorization: Bearer <Токен callback>
Content-Type: application/json
{
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"emoji": "👍"
}
Где взять message_id
message_id — id сообщения в AnyLinga. Для реакции на сообщение клиента возьмите поле message_id из входящего сообщения, которое получил сценарий.
Для реакции на текст агента возьмите поле message_id из ответа AnyLinga на callback или на /api/connect/send. Если отправлены только шаблоны, без текста, поля message_id в ответе нет.
В каких каналах работают реакции
ИИ-агент может поставить реакцию в WhatsApp с подключением по QR-коду, WhatsApp Business API и Telegram-боте.
В остальных каналах — личном Telegram, Instagram, Facebook, TikTok, MAX, LinkedIn и веб-чате — AnyLinga вернёт 422 reactions_not_supported. В личном Telegram у бизнес-ботов Telegram нет права ставить реакции.
Менеджер видит реакцию агента в чате amoCRM на том же сообщении, как реакцию сотрудника. При успешном дублировании ответ будет {"ok": true, "crm_mirrored": true}.
Если продублировать реакцию в amoCRM не удалось, в ответе будет "crm_mirrored": false. Клиенту реакция при этом всё равно ушла.
Что означают ответы API
Проверяйте код ответа и значение crm_mirrored, чтобы отличить отправку реакции клиенту от её отображения в amoCRM.
| Ответ | Что значит |
|---|---|
200 | Реакция ушла клиенту; crm_mirrored показывает, появилась ли она в amoCRM. |
400 | message_id не похож на id сообщения или в emoji больше одного эмодзи. |
401 | Неверный Токен callback. |
404 message_not_found | Такого сообщения нет или оно из другого кабинета. |
422 reactions_not_supported | В этом канале AnyLinga реакции не ставит. |
422 no_messenger_id | У сообщения нет id в мессенджере, реакцию поставить не на что. |
502 send_failed | Мессенджер не принял реакцию, например, если в emoji не эмодзи. |
Как включить уведомления о реакциях клиента
Перед включением убедитесь, что сценарий проверяет поле event: у обычного сообщения клиента этого поля нет.
1. Откройте настройки ИИ-шлюза
- Перейдите в Инструменты и настройки → ИИ-шлюз на страницу Подключите свой ИИ.
2. Включите уведомления о реакциях
- Под переключателем Включить шлюз найдите Сообщать ИИ о реакциях клиента и включите его.
- Настройка сохраняется сразу при нажатии. Нажимать Сохранить не нужно.
Как обработать событие client_reaction
Когда клиент ставит или снимает реакцию, событие client_reaction приходит на тот же URL вебхука n8n с той же подписью X-AnyLinga-Signature. Отвечать через callback не нужно; вебхук должен ответить 2xx. Фильтры по сделкам к событию не применяются.
Отличайте событие от сообщения клиента по полю event. Используйте message_id, чтобы определить, на какое сообщение отреагировал клиент.
| Поле | Что в нём |
|---|---|
event | client_reaction. |
conversation_id | Беседа. |
channel | Канал. |
contact_id | Контакт в amoCRM или null. |
message_id | Сообщение, на которое клиент отреагировал: тот же id, что во входящем сообщении или в ответе callback. |
message_direction | inbound, если реакция на сообщение клиента, outbound — на сообщение бизнеса. |
emoji | Эмодзи реакции. |
action | react, если клиент поставил реакцию, unreact — если снял. |
ts | Время. |
unreact с тем эмодзи, которое клиент снял. Реакция на старое сообщение, которого нет в AnyLinga, события не даёт.Связанные вопросы
Какие поля получает сценарий, как ИИ-агент и менеджер работают в одном чате, как подключить ИИ-агента через n8n.
Остались вопросы?
Ответим в рабочее время.
Ещё нет аккаунта?
Попробуйте сами или подключим за вас при оплате первого месяца.