Платформа WhatsApp Business отправляет сообщения через Cloud API (размещённый Meta) или устаревший On-Premises API. Сообщения, инициированные бизнесом, должны использовать заранее утверждённые шаблоны определённой категории (marketing, utility, authentication); произвольные сессионные сообщения допускаются только в пределах 24-часового окна клиентского обслуживания, открытого последним сообщением пользователя. Получение согласия (opt-in) обязательно.
Cloud API против On-Premises API
Платформа WhatsApp Business предоставляет два API с одинаковой моделью обмена сообщениями, но разным хостингом. Cloud API размещается Meta: бизнес (или его провайдер решений) вызывает REST-эндпоинт в стиле Graph, привязанный к идентификатору номера телефона, без локального клиента для запуска. On-Premises API — это контейнеризированный клиент, который бизнес размещает сам, исторически использовавшийся из соображений резидентности данных или задержек; Meta назначила его к выводу из эксплуатации в пользу Cloud API. Оба регулируются одними и теми же правилами — шаблоны, 24-часовое окно, категории, качество и opt-in, — поэтому выбор носит операционный характер (кто размещает), а не функциональный.
| Свойство | Cloud API | On-Premises API |
|---|---|---|
| Хостинг | Размещается Meta, клиент запускать не нужно | Контейнеризованный клиент, размещаемый компанией |
| Конечная точка | Graph REST по идентификатору телефонного номера | Локальная REST-конечная точка клиента |
| Обновления | Управляется Meta | Компания сопровождает версии клиента |
| Статус | Рекомендовано, активно развивается | Запланировано к выводу из эксплуатации |
| Правила (шаблоны/окно/качество) | Идентичный | Идентичный |
Шаблонные (HSM) сообщения против сессионных
WhatsApp разделяет два направления бизнес-обмена сообщениями. Бизнес не может «холодно» написать пользователю произвольным контентом: любое инициированное бизнесом сообщение должно быть шаблоном сообщения — исторически называвшимся Highly Structured Message (HSM), — который был заранее отправлен на утверждение и одобрен WhatsApp, с именованными переменными-заполнителями и объявленной категорией. После того как пользователь отвечает, открывается 24-часовое окно клиентского обслуживания, в котором бизнес может отправлять произвольные сессионные сообщения (текст, медиа, интерактивные) без шаблона. Вне этого окна бизнес снова должен начать с утверждённого шаблона. Это правило «сначала шаблон» — основное ограничение платформы.
POST https://graph.facebook.com/v20.0/{phone-number-id}/messages
Authorization: Bearer {access-token}
{
"messaging_product": "whatsapp",
"to": "15551234567",
"type": "template",
"template": {
"name": "order_shipped",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [ { "type": "text", "text": "4021" } ] }
]
}
}24-часовое окно клиентского обслуживания
24-часовое окно — это механизм, регулирующий произвольный обмен сообщениями. Оно открывается (или переоткрывается) каждый раз, когда пользователь отправляет сообщение бизнесу, и длится 24 часа с момента этого последнего сообщения пользователя. Внутри окна бизнес может отвечать любым допустимым типом сообщения — простым текстом, медиа, интерактивными кнопками или списками — без использования шаблона. Когда окно закрывается, произвольные отправки отклоняются, и бизнес должен повторно вовлечь пользователя утверждённым шаблоном (с учётом категории и, для marketing, ограничений на пользователя). И сессионная тарификация, и более новая тарификация за сообщение зависят от того, попадает ли отправка внутрь или за пределы этого окна.
Категории сообщений: marketing, utility, authentication
Каждому шаблону назначается категория, которая определяет, как он может использоваться и как тарифицируется. Шаблоны utility относятся к конкретной согласованной транзакции или событию по счёту (обновления заказа, напоминания о записи, выписки). Шаблоны authentication доставляют одноразовые коды и верификацию в ограниченном формате. Шаблоны marketing несут акции, предложения и повторное вовлечение и регулируются наиболее строго — с учётом согласия пользователя, сигналов качества и ограничений частоты. WhatsApp при одобрении проверяет содержимое шаблона на соответствие объявленной категории и может переклассифицировать его; отправка маркетингового контента под меткой utility — частая причина отклонения или ущерба качеству.
| Категория | Назначение | Примечания |
|---|---|---|
| Утилита | Обновления транзакций/счета, которые ожидает пользователь | Связано с конкретным действием или соглашением |
| Аутентификация | Одноразовые пароли, верификация | Ограниченный формат; ориентирован на OTP |
| Маркетинг | Акции, предложения, повторное вовлечение | Строгое управление opt-in, качеством и частотой |
| Услуга (сессия) | Ответы в свободной форме в пределах 24-часового окна | Шаблон не требуется; не инициировано бизнесом |
Webhook: входящие сообщения и статус доставки
Платформа асинхронна и управляется обратными вызовами. Бизнес настраивает webhook-URL, на который WhatsApp отправляет два вида событий: входящие сообщения (ответы пользователя, медиа, нажатия кнопок, местоположение) и уведомления о статусе исходящих сообщений, которые проходят стадии sent, delivered, read и — при сбое — failed с кодом ошибки. Отчёты о прочтении и жизненный цикл сообщения отражаются здесь, и именно поступление события о входящем сообщении открывает или обновляет 24-часовое окно. Надёжная интеграция быстро подтверждает webhook и сверяет статус доставки с собственным хранилищем сообщений — во многом так же, как SMS-платформа сверяет DLR.
{
"entry": [{ "changes": [{ "value": {
"messaging_product": "whatsapp",
"messages": [{
"from": "15551234567", "id": "wamid.HBg...",
"timestamp": "1752796800",
"type": "text", "text": { "body": "Where is my order?" }
}]
} }] }]
}Качество номера, уровни и opt-in
Каждый бизнес-номер имеет рейтинг качества (отображаемый как высокий/средний/низкий, часто цветами зелёный/жёлтый/красный), выведенный из того, как пользователи реагируют на его сообщения, — блокировки и жалобы снижают его. Качество определяет уровень лимита сообщений, который ограничивает, скольким уникальным пользователям номер может инициировать диалоги за скользящие 24 часа; уровни повышаются (например, 250, 1K, 10K, 100K, затем без ограничений) по мере устойчивого качества и объёма и снижаются, если качество падает. В основе всего лежит opt-in: WhatsApp требует, чтобы бизнес получал и фиксировал явное согласие пользователя, собранное по любому каналу, до отправки. Плохая практика получения согласия быстро проявляется как блокировки, ухудшение качества и урезанный уровень.
| Signal | Значение | Эффект |
|---|---|---|
| Качество: высокое (зелёный) | Мало блокировок/жалоб | Может перейти на более высокий уровень |
| Качество: среднее (жёлтый) | Некоторые негативные отзывы | Находится под наблюдением; масштабирование приостановлено |
| Качество: низкое (красный) | Много блокировок/жалоб | Риск понижения уровня или пометки |
| Уровень (250 / 1K / 10K / 100K / ∞) | Уникальные пользователи, с которыми начат диалог за 24 ч | Повышается при устойчивом качестве + объёме |
| Opt-in | Зарегистрированное согласие пользователя | Обязательно перед любой отправкой, инициированной компанией |
Часто задаваемые вопросы
В чём разница между Cloud API и On-Premises API?
Оба используют одну и ту же модель обмена сообщениями WhatsApp, но Cloud API размещается Meta (вы вызываете REST-эндпоинт, ничего не нужно запускать), тогда как On-Premises API — это контейнеризированный клиент, который вы размещаете сами. Meta назначила On-Premises API к выводу из эксплуатации в пользу Cloud API. Шаблоны, 24-часовое окно, категории и правила качества применяются к обоим одинаково.
Что такое шаблон сообщения WhatsApp (HSM)?
Шаблон — исторически Highly Structured Message — это заранее утверждённый контент с именованными переменными-заполнителями и объявленной категорией. Любое инициированное бизнесом сообщение WhatsApp должно быть шаблоном; произвольный контент допускается только внутри 24-часового окна клиентского обслуживания, открытого ответом пользователя.
Что такое 24-часовое окно клиентского обслуживания?
Это период длительностью 24 часа с момента последнего сообщения пользователя бизнесу, в течение которого бизнес может отправлять произвольные сессионные сообщения без шаблона. Когда он закрывается, произвольные отправки отклоняются, и бизнес должен повторно вовлечь пользователя утверждённым шаблоном. Входящие webhook-события открывают или обновляют окно.
Какие есть категории сообщений WhatsApp?
Шаблоны классифицируются как utility (ожидаемые пользователем обновления транзакций/счёта), authentication (одноразовые коды и верификация) или marketing (акции и повторное вовлечение, регулируемые наиболее строго). Произвольные ответы внутри окна — это сервисные сообщения. Категория определяет допустимое использование и тарификацию, и WhatsApp проверяет содержимое на соответствие объявленной категории.
Что определяет лимит сообщений номера WhatsApp?
Уровень отправки ограничивает, скольким уникальным пользователям номер может инициировать диалоги за скользящие 24 часа (например, 250, 1K, 10K, 100K, затем без ограничений). Уровни растут при устойчивом качестве и объёме и падают, если качество снижается. Качество — это рейтинг высокий/средний/низкий, определяемый блокировками и жалобами пользователей.
Нужно ли согласие (opt-in) для отправки сообщений пользователям в WhatsApp?
Да. WhatsApp требует явного зафиксированного согласия пользователя — которое может быть собрано по любому каналу — до того, как бизнес отправит сообщения. Слабый opt-in быстро проявляется как блокировки и жалобы, которые снижают рейтинг качества номера и могут урезать или понизить его уровень отправки.
Технические характеристики источника
На этой странице представлены опубликованные стандарты, на которых они основаны. (Открывается в новой вкладке)