Шаблоны сообщений WhatsApp API: Основные термины и принципы работы

Ключевые моменты:

• Шаблоны — это активы аккаунта WhatsApp Business API, которые компании используют для отправки структурированных сообщений через WhatsApp API.
• Сообщения-шаблоны — это единственный тип сообщений, который можно отправлять пользователям WhatsApp вне окна обслуживания клиентов.
• Шаблоны часто используются для массовой рассылки, кампаний, уведомлений, напоминаний, OTP и последующих сообщений, когда окно обслуживания клиентов закрыто.

Создание шаблона

Откройте YCloud Console → WhatsApp Manager → Шаблон → Новый шаблон

• The категория указывает WhatsApp, является ли шаблон маркетинговым, служебным или для аутентификации.
• The компоненты определяют, что содержит шаблон, например, заголовок, тело, нижний колонтитул, кнопки, переменные или медиа.

Вы можете создать до 100 шаблонов на один аккаунт WhatsApp Business в час.

Общий синтаксис API

curl 'https://graph.facebook.com/v23.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "name": "<NAME>",
  "category": "<CATEGORY>",
  "language": "<LANGUAGE>",
  "parameter_format": "<PARAMETER_FORMAT>",
  "components": [<COMPONENTS>]
}'

Названия

• order_update для английского
• order_update для хинди
• order_update для испанского

Название шаблона может включать только:

• строчные буквы
• буквенно-цифровые символы
• знаки подчеркивания

• order_confirmation
• payment_reminder
• login_otp
• cart_recovery_offer

• Order Confirmation
• Payment-Reminder
• Login OTP!

Категории

• Маркетинг
• Утилита
• Аутентификация

• Маркетинг используется для продвижения, предложений, обновлений продуктов, ретаргетинга и повторного вовлечения клиентов.
• Утилита используется для непродвигаемых обновлений, таких как подтверждение заказов, напоминания об оплате, уведомления о доставке, обновления аккаунта и последующие действия по поддержке.
• Аутентификация используется для OTP, кодов входа, восстановления аккаунта и проверки личности.

Read this One-Stop Guide to WhatsApp API Message Template Categories to know about WhatsApp API Message Template in detail.

• Утверждение шаблона
• Ограничения сообщений
• Ценообразование
• Проверка категории
• Будущая перекатегоризация WhatsApp

Компоненты

• Заголовок — текст, изображение, видео, документ или местоположение, отображаемое в верхней части сообщения.
• Тело — основной текст сообщения. Здесь используются большинство переменных и деталей, специфичных для клиента.
• Нижний колонтитул — краткий вспомогательный текст, обычно используется для отказоответственности или дополнительного контекста.
• Кнопки — кликабельные действия, такие как переход на сайт, звонок по номеру, копирование одноразового пароля или быстрые ответы.

Языки

• en_US для английского
• hi для хинди
• es для испанского
• pt_BR для бразильского португальского

• order_update на английском
• order_update на хинди
• order_update на испанском

Форматы параметров

• Здесь {{first_name}} и {{order_number}} являются параметрами.

• Выбрать формат параметра: Именованный или Позиционный
• Добавить примеры значений для каждого параметра
• Передать реальные значения в данных отправки сообщения позже

Именованные параметры

• Должны быть уникальными
• Используйте строчные буквы и подчеркивания
• Обрамляются двойными фигурными скобками
• Значения можно передавать в любом порядке, так как каждый параметр имеет имя

Thank you, {{first_name}}! Your order number is {{order_number}}.

[
  {
    "type": "text",
    "parameter_name": "first_name",
    "text": "Jessica"
  },
  {
    "type": "text",
    "parameter_name": "order_number",
    "text": "SKBUP2-4CPIG9"
  }
]

Позиционные параметры

• Должны начинаться с {{1}}
• Должны следовать тому же порядку, что и в тексте шаблона
• Значения должны передаваться в той же последовательности

Hi {{1}}! Your order number is {{2}}. Thank you.

[
  {
    "type": "text",
    "text": "Jessica"
  },
  {
    "type": "text",
    "text": "SKBUP2-4CPIG9"
  }
]

Именованные vs Позиционные параметры

Медиа

• Изображение товара
• Баннер предложения
• PDF-счет
• Билет или документ бронирования
• Превью видео

Проверка шаблона

Во время проверки WhatsApp проверяет такие аспекты, как:

• Правильность выбранной категории
• Соответствие сообщения рекомендациям по шаблонам
• Понятность переменных и примеров
• Соответствие контента бизнес-кейсу
• Корректность медиа, кнопок и компонентов

Know How WhatsApp Assigns a Category During Template Creation

Статус шаблона

Распространенные значения статусов шаблонов:

• Подтверждено — шаблон прошел проверку и может использоваться.
• На рассмотрении — шаблон все еще находится на проверке.
• Отклонено — шаблон не прошел проверку и не может использоваться.
• Приостановлено — шаблон временно остановлен из-за проблем с качеством.
• Отключено — шаблон больше не может использоваться.

Пример запроса

curl 'https://graph.facebook.com/<API_VERSION>/<TEMPLATE_ID>?fields=status' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Пример ответа

{
  "status": "APPROVED",
  "id": "1259544702043867"
}

WhatsApp Manager

Далее рассмотрим ограничения на шаблоны и сколько шаблонов WhatsApp API Message Templates может создать ваш бизнес.

Ограничения на шаблоны

• Лимиты на сообщения — контролируют количество шаблонных сообщений, которые можно отправить за пределами окна обслуживания клиентов.
• Регулировка скорости шаблонов — замедляет доставку, чтобы пользователи WhatsApp могли оставить отзыв перед дальнейшим масштабированием шаблона.
• Приостановка шаблонов — временно останавливает шаблоны, которые получают плохие отзывы или низкую вовлеченность.
• Архивация шаблонов — архивирует и удаляет шаблоны, неактивные в течение 12 месяцев или болееАрхивные шаблоны удаляются через 28 дней если не восстановлены.
• Лимиты маркетинговых шаблонов на пользователя — ограничивают количество маркетинговых шаблонных сообщений, которые пользователь WhatsApp может получать от бизнесов.

Time-to-Live

"message_send_ttl_seconds": 900

"message_send_ttl_seconds": -1

Что происходит при истечении TTL?

TTL и обновления категорий

Рейтинг качества

Пример запроса

curl 'https://graph.facebook.com/v25.0/<TEMPLATE_ID>?fields=quality_score' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Пример ответа

{
  "quality_score": {
    "score": "GREEN",
    "date": 1758754645
  },
  "id": "1387372356726668"
}

Последовательность доставки нескольких сообщений

1. Заказ подтверждён
2. Оплата получена
3. Доставка запланирована

• OTP-потоки
• Платежные процессы
• Обновления заказов
• Пошаговая адаптация
• Многоканальные кампании
• Автоматизация поддержки клиентов

Управление шаблонами

• Только одобренные, отклоненные или приостановленные шаблоны можно редактировать.
• Одобренные шаблоны можно редактировать до 10 раз за 30 дней или один раз в 24 часа.
• Вы не можете редактировать отдельные компоненты. При редактировании компонентов весь набор компонентов будет заменен.
• Если вы удалите утвержденный шаблон, вы не сможете создать другой шаблон с тем же именем в течение 30 дней.
• Шаблоны, неактивные 12 месяцев и более могут быть архивированы и запланированы к удалению через 28 дней.

Создавайте шаблоны WhatsApp API быстрее с YCloud AI

• Акций
• Обновлений заказов
• Напоминаний об оплате
• OTP
• Последующих действий поддержки
• Кампании по повторному вовлечению

Как получить YCloud?

Как получить YCloud БЕСПЛАТНО?

Подведем итоги!