Как создать шаблон WhatsApp в Multi API

Q: Черновик

Единственный внутренний статус системы. Шаблон сохранён в системе, но не отправлен в WhatsApp на одобрение.

Q: Отклонённый

Шаблон отклонён. Причина — в поле rejection_reason.

Коротко: шаблон WhatsApp — это предварительно одобренное сообщение. Создаётся в разделе «Активы» → «Шаблоны WhatsApp».

Кому подходит

Роль: Клиент, Разработчик
Уровень: Опытный

Что это

Шаблон WhatsApp — статично определённое содержимое, которое регистрируется в WhatsApp и проходит процесс одобрения. Свободные сообщения (без шаблона) можно отправлять только как ответ в 24-часовом окне.

В Multi API шаблоны WhatsApp:

Создаются в личном кабинете — Активы → Шаблоны WhatsApp.
Отправляются через API — параметр template.id.
Проверяются через API — GET /wa_templates.

Возможности шаблона WhatsApp

#	Возможность	Что даёт
1	Неограниченное количество	Для каждого имени отправителя — без ограничений по количеству
2	Три категории	Marketing, Utility, Authentication
3	Разные типы	Карточка, Карусель, Код купона, Ограниченное предложение, Каталог, Аутентификация
4	Числовые переменные	Персонализация через `{{1}}`, `{{2}}`
5	Локализуемые переменные	Currency (валюта) и Date Time (дата и время)
6	Предварительно одобренные шаблоны	Готовые из библиотеки — быстро получают статус Одобренный
7	Zero-Tap и One-Tap	Автоматическая подстановка кода для Authentication
8	Рейтинг качества	Оценка на основе отзывов и активности
9	Синхронизация	Ручная синхронизация со статусами WhatsApp
10	Отправка через API	Параметр `template.id` в OMNI API

Перед началом

У вас есть имя отправителя WhatsApp со статусом Активно.
Вы работаете в разделе Активы → Шаблоны WhatsApp.
Вы определили категорию шаблона: Marketing, Utility или Authentication.

Как создать шаблон

Нажмите «Добавить шаблон WhatsApp»

Кнопка в правом верхнем углу раздела Активы → Шаблоны WhatsApp.

Доступны два варианта:

Общий — создать шаблон с нуля.
Предварительно одобрено — выбрать из библиотеки готовых шаблонов.

Укажите имя отправителя

В поле Отправитель выберите имя со статусом Активно.

Введите название шаблона

Название — внутреннее имя, получатели его не увидят.

Только строчные латинские буквы, цифры и подчёркивания. Без пробелов, заглавных букв и дефисов.

Пример: discount_50_percent_march

Выберите категорию

Категория	Для чего
Marketing	Рекламные предложения, анонсы, коммерческие сообщения
Utility	Транзакции, уведомления, выписки
Authentication	Коды аутентификации

Выберите тип шаблона

Тип зависит от категории:

Marketing:

Карточка.
Карусель.
Код купона.
Ограниченное предложение.
Каталог.

Utility:

Карточка.

Authentication:

Аутентификация.

Выберите язык

Укажите язык шаблона — получатель увидит текст на этом языке.

Настройте период действия сообщения

Период — время, в течение которого WhatsApp пытается доставить сообщение.

Категория	Период по умолчанию
Marketing	30 дней
Utility	30 дней
Authentication	10 минут

Настройте содержимое

Содержимое зависит от типа шаблона.

Для Карточки — заголовок, текст, кнопки.
Для Карусели — от 2 до 10 карточек одного формата.
Для Аутентификации — предустановленный текст, кнопки Копировать код, Zero-Tap или One-Tap.

Подробнее о настройке каждого типа:

Сохраните

Доступны три действия:

Сохранить в черновик — шаблон остаётся в системе, не отправляется на одобрение.
Сохранить — шаблон сохраняется и отправляется на одобрение в WhatsApp.
Отменить — отмена.

Категории и типы

Категория	Типы
Marketing	Карточка, Карусель, Код купона, Ограниченное предложение, Каталог
Utility	Карточка
Authentication	Аутентификация

Полное описание типов — в статьях канала:

Переменные

Переменные в шаблонах WhatsApp должны быть числовыми и заключены в двойные фигурные скобки — например, {{1}}, {{2}}.

Под каждым текстовым полем, где есть переменная, появится поле для описания. Заполните его — это помогает ускорить одобрение.

Пример:

Что	Что указать
Текст шаблона	`Здравствуйте, {{1}}! Ваш заказ {{2}} готов.`
Описание `{{1}}`	Имя клиента
Описание `{{2}}`	Номер заказа

Локализуемые переменные — Currency и Date Time — также поддерживаются. Они автоматически адаптируются под язык и регион получателя.

Форматы payload по каналам →

Ограничения

Что	Ограничение
Название шаблона	Только строчные латинские буквы, цифры, подчёркивания
Текст шаблона	Зависит от типа — например, для Карточки: заголовок до 50, текст до 550, подпись до 60
Кнопки	До 10 кнопок, из них максимум 2 — типа URL
URL-адреса кнопок	Должны быть уникальными
Тексты кнопок	Должны быть уникальными
Переменные	Все должны быть заполнены при отправке
Формат заголовков в карусели	Должен быть одинаковым для всех карточек

По кнопкам — ограничения для каждого типа шаблона:

Карточка — до 10 кнопок, максимум 2 из них URL.
Карусель — до 10 кнопок на каждую карточку.
Код купона — обязательна одна кнопка «Копировать код».
Ограниченное предложение — минимум одна кнопка «Переход по ссылке».
Аутентификация — обязательна кнопка «Копировать код».

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

Единственный внутренний статус системы. Шаблон сохранён в системе, но не отправлен в WhatsApp на одобрение.

Шаблон отправлен на одобрение в WhatsApp.

WhatsApp рассматривает шаблон.

Шаблон одобрен, можно использовать.

Шаблон отклонён. Причина — в поле rejection_reason.

Подана апелляция на отклонение.

Запрошено удаление шаблона.

Шаблон удалён.

Шаблон отключён WhatsApp.

Шаблон приостановлен WhatsApp.

Превышен лимит по шаблону.

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

WhatsApp оценивает шаблон на основе отзывов, жалоб и активности получателей.

Рейтинг	Что означает
Высокое качество	Хорошая репутация
Среднее качество	Средняя репутация
Низкое качество	Плохая репутация
Не определено	Рейтинг ещё не рассчитан

Рейтинг отображается после обработки 1 000 или более заявок. До этого WhatsApp возвращает статус Не определено.

Как использовать шаблон через API

Для отправки сообщения по шаблону WhatsApp используйте параметр template вместо payload.

Пример curl:

curl --location 'https://web.multiapi.ru/api/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <ваш-ключ>' \
  --data-raw '{
    "contact": "79123456789",
    "channel": 4,
    "senderId": "<senderID>",
    "template": {
      "id": <templateID>,
      "params": {
        "attribute.name": "Александр",
        "attribute.code": "1234"
      }
    }
  }'

Проверить список шаблонов WhatsApp:

curl --location 'https://web.multiapi.ru/api/v1/wa_templates' \
  --header 'X-API-Key: <ваш-ключ>'

Поля ответа GET /wa_templates:

Поле	Что означает
`id`	ID шаблона
`template_name`	Имя шаблона
`category`	MARKETING, UTILITY, AUTHENTICATION
`language`, `language_name_en`	Язык
`sender_id`, `sender_display_name`	Отправитель
`status`	Статус одобрения
`rejection_reason`	Причина отклонения
`content`	Содержимое в виде JSON-строки
`last_synced_at`	Когда синхронизировано
`status_updated_at`	Когда изменился статус

Справочные эндпоинты →

Синхронизация с WhatsApp

В интерфейсе Активы → Шаблоны WhatsApp доступна иконка синхронизации. Она получает актуальные статусы из WhatsApp по всем вашим шаблонам.

Когда использовать:

После отправки шаблона на одобрение — проверить смену статуса.
Периодически — для актуализации данных.
После изменений на стороне WhatsApp.

Предварительно одобренные шаблоны

В разделе Активы → Шаблоны WhatsApp доступна библиотека предварительно одобренных шаблонов WhatsApp.

Что это даёт:

Быстрое создание шаблона на основе готового.
Такие шаблоны быстро получают статус Одобренный.
Не требуют повторного согласования.

Как использовать:

Нажмите Добавить шаблон WhatsApp → Предварительно одобрено.
Выберите отправителя.
Примените фильтры — по сценарию, отрасли, теме, языку.
Выберите шаблон из библиотеки.
Введите своё название.
Сохраните.

Предварительно одобренные шаблоны →

Результат

Шаблон WhatsApp создан и отправлен на одобрение. После получения статуса Одобренный его можно использовать в рассылках и через API.

Частые проблемы

Причина: шаблон не соответствует правилам WhatsApp.

Решение: проверьте содержимое и отправьте снова.

Обзор шаблонов WhatsApp →

Причина: два одинаковых URL среди кнопок.

Решение: сделайте URL-адреса уникальными — каждая кнопка ведёт на свой адрес.

Причина: при отправке не заполнены все переменные.

Решение: заполните все переменные, которые есть в шаблоне.

Причина: в шаблоне больше 2 кнопок типа URL.

Решение: максимум 2 URL-кнопки. Остальные замените на «Ответное действие» или удалите.

Причина: форматы заголовков карточек отличаются.

Решение: приведите все заголовки к одному формату — изображение, видео, документ или локация.

Причина: WhatsApp обрабатывает шаблон.

Решение: подождите 24–48 часов. Проверьте статус через синхронизацию.

Контакты поддержки →

Причина: в названии есть заглавные буквы, пробелы или дефисы.

Решение: используйте только строчные латинские буквы, цифры и символ подчёркивания. Пример: discount_50_percent_march.

См. также

Обзор шаблонов WhatsApp

Категории, статусы, рейтинг качества

Как создать шаблон

Общий шаблон или из библиотеки

Шаблон «Карточка»

Изображение, текст, кнопки

Шаблон «Аутентификация»

Коды с поддержкой Zero-Tap

Справочные эндпоинты

Получить список шаблонов WhatsApp

Настройка WhatsApp

Возможности канала

Нужна помощь?

Multi API: support@multiapi.ru