Как ИИ-агенту отправить клиенту шаблон, фото или видео
Чтобы ваш ИИ-агент отправил клиенту фото, видео или файл, передайте в ответе на callback_url поле template_ids с id шаблонов AnyLinga. Можно указать до 5 id; поле reply_text при этом необязательно.
Как отправляются вложения
Шаблон — это текст и вложения, которые вы заранее сохранили в AnyLinga. Ваш агент выбирает нужные шаблоны, а AnyLinga отправляет их клиенту.
Получите список шаблонов
1. Запросите доступные шаблоны
- Выполните
GET /api/connect/templatesс тем же заголовкомAuthorization: Bearer <Токен callback>. - В ответе для каждого шаблона будут поля
id,name,category,provider,bodyи вложенияattachments. У шаблонов WhatsApp Business API также будет блокmeta. - Выберите нужные шаблоны и возьмите их
idдля отправки.
Передайте шаблоны в ответе агента
2. Добавьте template_ids в ответ
- В ответе на
callback_urlпередайте массивtemplate_ids— до 5 id шаблонов. - Добавьте
reply_text, если перед шаблонами нужно отправить отдельный текст. Если он не нужен, поле можно не передавать.
{
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"reply_text": "Вот наш каталог и видео о доставке.",
"template_ids": ["7d1f0c2a-4b3e-4a9d-8c61-2e5f9b0a7d34"]
}
В ответе AnyLinga вернёт список templates с результатом по каждому шаблону: ok, parts_sent или code ошибки. Если текста не было и не ушёл ни один шаблон, ответ будет 502.
Так же шаблоны можно передать в /api/connect/send, когда агент пишет клиенту первым.
Порядок отправки и ограничения
Сначала уходит reply_text с переводом, затем — шаблоны по очереди. Текст шаблона и вложения отправляются отдельными сообщениями. Видео уходит как видео.
Текст шаблона не переводится: клиент получит его так, как он написан в шаблоне.
Подходят только опубликованные шаблоны. Шаблоны WhatsApp Business API должны быть одобрены Meta. Иначе AnyLinga вернёт 404 с template_id этого шаблона.
Шаблоны проверяются до того, как ответ засчитан. Если в id ошибка, исправьте его и пришлите ответ ещё раз с тем же correlation_id.
Связанные вопросы
Шаблоны быстрых ответов · Шаблоны WhatsApp · Как агенту написать клиенту первым
Остались вопросы?
Ответим в рабочее время.
Ещё нет аккаунта?
Попробуйте сами или подключим за вас при оплате первого месяца.