Перейти к основному содержанию
POST /send/interactive посылает сообщения WhatsApp native-flow через выбранное устройство. Используйте Basic Auth, X-Device-Id и JSON-тел. Эта конечная точка поддерживает немедленные REST отправки. Запланированные посылки и MCP не выявляют его.
Эта экспериментальная конечная точка использует неофициальный протокол WhatsApp. Отображение получателя зависит от клиента и может быть изменено без уведомления. Тестирование целевых клиентов перед использованием. Успешный ответ API подтверждает отправку подтверждения, не доставки или рендеринга.
Установите URL сервера и учетные данные перед запуском примера curl. Используйте публичный URL-адрес HTTPS для удаленного сервера и включите APP_BASE_PATH при настройке.

Отправка кнопок

phone принимает номер телефона или полный пользователь или группу JID. Для отправки сообщений группе требуется разрешение на членство и публикацию. Не поддерживается рассылка и получатели рассылки. Укажите на верхнем уровне либо buttons, либо cards. Если указаны оба поля или ни одного, проверка завершится ошибкой. Для выбора списка используйте следующие параметры:

Запросить местоположение

Отправить этот JSON в /send/interactive. Получатель должен выбрать для общего доступа местоположение. Конечная точка не получает местоположение без их действия.

Отправить изображение карусели

Замените заполнители изображений на стандартные base64, без префикса URL данных. Изображения являются необязательными для отдельных карт. GOWA размещает изображения на 1280 пикселей, преобразует их в JPEG, создает эскизы и загружает их в WhatsApp. Не принимаются URL-адреса изображений.

Ограничения запросов

Также применяется общий лимит HTTP-запросов сервера. Используйте маленькие изображения при отправке нескольких карт. Недопустимый выбор или размер возвращает ошибку проверки перед отправкой.

Обрабатывать ответы и квитанции

Успешно отправлены возвращают нормальный конверт успеха с помощью results.message_id и не верифицирован статус, в котором говорится, что рендеринг получателя. Используйте incoming webhooks для ответов и событий message.ack для чеков. Повтор после неоднозначного таймаута может дублировать сообщения. По проходящим тестам Android сообщалось о действиях рабочего ответа, URL, копирования, вызова, выбора, местоположения и карусели. Эти отчеты не позволяют установить совместимость между аккаунтами, iOS или WhatsApp Web. Индивидуальные карточки карусели могут отображать нерешенные значки, даже если родительское сообщение имеет флажки, и получатель может ответить. Эта проблема остается нерешенной. Конечная точка не регистрирует официальные шаблоны или поддерживает встроенные Flows, каталоги или родные платежи.