AnyLinga
RU
Войти Попробовать бесплатно

Центр помощи/ИИ-агент

Как ИИ-агенту отправить клиенту шаблон, фото или видео

Обновлено: 2026-11-11

Чтобы ваш ИИ-агент отправил клиенту фото, видео или файл, передайте в ответе на 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 для отправки.
Лимит — 30 запросов в минуту.

Передайте шаблоны в ответе агента

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 · Как агенту написать клиенту первым

Статья помогла?

Остались вопросы?

Ответим в рабочее время.

Уже пользуетесь AnyLinga?

Опишите вопрос — ответим в WhatsApp или по email.

Ещё нет аккаунта?

Попробуйте сами или подключим за вас при оплате первого месяца.

Обсудить подключение

Что нужно