WhatsApp Cloud API - Упрощенный API для маркетинговых сообщений | Документация для разработчиков
WhatsApp Cloud API - Marketing Messages Lite API
Экземпляр для программы магистратуры (LLM)
Версия
Отправляйте маркетинговые сообщения по шаблону с автоматической оптимизацией доставки.
Доставляет актуальные и своевременные сообщения клиентам, наиболее склонным к взаимодействию
с улучшенной доставляемостью и анализом конверсий на последующих этапах воронки продаж.
Конечные точки
POST /{Version}/{Phone-Number-ID}/marketing_messages
Отправляйте маркетинговые сообщения, используя предварительно утвержденные шаблоны. Поддерживаются дополнительные параметры управления политикой продукта и настройки обмена информацией об активности в сообщениях.
Синтаксис запроса
Попробуйте!
Выберите язык
Выберите код состояния
Параметры заголовка
Строка User-Agent
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
Строка авторизации · обязательный
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Content-TypeОдин из "application/json", "application/x-www-form-urlencoded", "multipart/form-data"·обязательный
Параметры пути
Строка версии · обязательный
Версия API WhatsApp (например, v20.0)
Строка Phone-Number-ID · обязательный
Идентификатор бизнес-телефона WhatsApp
Необходимый
Тип содержимого: application/json
Схема: MarketingMessageRequestPayload
Показать дочерние атрибуты
MarketingMessageRequestPayload
messaging_product"whatsapp"·required
Используемый мессенджер. Обязательно WhatsApp
recipient_type"individual"·required
Тип получателя. Должен быть "индивидуальный"
встроку·обязательный
Идентификатор WhatsApp или номер телефона получателя сообщения
тип"шаблон"·обязательный
Тип сообщения. Для маркетинговых сообщений должен быть "шаблон"
шаблонныйобъект·обязательный
Показать дочерние атрибуты
строка имени · обязательный
Название шаблона.
языкLanguageObject·обязательный
Содержит
языковой объект. Указывает язык, на котором может быть отображен шаблон.компонентовTemplateComponent
Массив
-компонентов , содержащих параметры сообщения.Показать дочерние атрибуты
компоненты[]TemplateComponent
product_policyОдин из "CLOUD_API_FALLBACK", "STRICT"
Дополнительная настройка политики продукта
message_activity_sharingboolean
Дополнительный флаг для управления обменом сообщениями
Ответы
Отправляйте маркетинговые сообщения, используя предварительно утвержденные шаблоны. Поддерживаются дополнительные параметры управления политикой продукта и настройки обмена информацией об активности в сообщениях.
200
Маркетинговое сообщение успешно отправлено
Тип содержимого: application/json
Схема: MarketingMessageResponsePayload
Показать дочерние атрибуты
Маркетинговое сообщениеОтветПолезная нагрузка
контактовобъекта
Показать дочерние атрибуты
контакт[]объект
Показать дочерние атрибуты
входнаястрока
строка wa_id
сообщенийобъекта
Показать дочерние атрибуты
сообщения[]объект
Показать дочерние атрибуты
строка идентификатора
message_statusОдин из вариантов: "accepted", "held_for_quality_assessment", "paused"
Статус сообщения WhatsApp:
Принято: Сообщение принято WhatsApp и находится в обработке.held_for_quality_assessment: Сообщение задерживается для проверки качества перед доставкой.Приостановлено: Доставка сообщения приостановлена.messaging_productstring
400
Неверный запрос - Недопустимые параметры запроса
Тип содержимого: application/json
401
Несанкционированный доступ - Недействительный или отсутствующий токен доступа
Тип содержимого: application/json
403
Запрещено — Шаблон не одобрен или имеются недостаточные права доступа
Тип содержимого: application/json
Выберите язык
Выберите код состояния
Аутентификация
|
Схема |
Тип |
Расположение |
|
bearerAuth |
HTTP Bearer |
Заголовок: Авторизация |
Примеры использования
bearerAuth:
Включите
Authorization: Bearer your-token-here в заголовки запроса.Глобальные требования к аутентификации
Для работы всех конечных точек требуется:
bearerAuth
Комментарии отсутствуют
Комментарии отсутствуют