WhatsApp API Шаблоны Сообщений: Ключевые Термины и Механика Объяснены

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

Создание

Откройте YCloud Console → WhatsApp Manager → Template → New Template

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

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

Общий синтаксис 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

Компоненты

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

Языки

• 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
• Билет или документ бронирования
• Превью видео

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

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

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 может получать от бизнесов.

Время жизни (TTL)

"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 БЕСПЛАТНО?

Подводя итоги!