Как ИИ-агенту написать клиенту первым или напомнить о себе
Чтобы написать клиенту без нового входящего сообщения, отправьте из своего сценария POST /api/connect/send с сохранённым conversation_id и текстом сообщения. AnyLinga передаст сообщение клиенту от вашего ИИ.
Как работает отправка без входящего сообщения
Сценарий должен заранее сохранить conversation_id из входящего запроса. По этому идентификатору можно отправить напоминание в существующую беседу своего кабинета.
Доставка такая же, как у обычного ответа: reply_text переводится на язык клиента, сообщение появляется в чате amoCRM.
Как отправить сообщение из сценария
1. Сохраните идентификатор беседы
- Возьмите
conversation_idиз входящего запроса и сохраните его у себя в сценарии.
2. Настройте HTTP-запрос
- Используйте
POST /api/connect/sendна том же сервере, который указан в URL callback. Замените путь/api/connect/callbackна/api/connect/send. - Передайте тот же заголовок
Authorization: Bearer <Токен callback>.
3. Передайте тело запроса и отправьте его
- Укажите
conversation_idиreply_textи/илиtemplate_ids. - Для текстового напоминания используйте пример ниже. Если отправляете шаблоны, передайте в
template_idsдо 5 шаблонов.
{
"conversation_id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c4f12",
"reply_text": "Добрый день! Вы спрашивали о доставке — всё ещё актуально?"
}
Когда можно написать в WhatsApp
В WhatsApp и WhatsApp Business API сообщение можно отправить только в течение 24 часов после последнего сообщения клиента.
Позже запрос вернёт 409 с телом {"error": "outside_window"}. Ограничение касается и шаблонов. У других каналов этой проверки нет.
Коды ответа
| Код | Что значит |
|---|---|
200 | Отправлено. |
400 | Нет conversation_id или нет ни reply_text, ни template_ids. |
401 | Неверный токен. |
404 | Беседа не найдена или шаблон не найден. |
409 outside_window | Прошло больше 24 часов после последнего сообщения клиента в WhatsApp. |
500 / 502 | Не удалось доставить. |
Связанные вопросы
как отправить шаблон, фото или видео · какие поля получает сценарий · как подключить ИИ-агента через n8n
Остались вопросы?
Ответим в рабочее время.
Ещё нет аккаунта?
Попробуйте сами или подключим за вас при оплате первого месяца.