Отправка шаблона с переменными
Переменные шаблона передаются по позиции, а не по имени. Для каждого компонента отправляется отдельный список параметров в нужном порядке, и его длина должна точно совпадать с определением шаблона. Ошибки при нарушении этого правила бывают трёх типов, и каждая указывает на свою причину.
Ошибка при несовпадении числа параметров с шаблоном.
Ошибка при несовпадении формата параметров.
Ошибка, когда имя и язык шаблона не распознаются.
Как сопоставляются параметры
По позиции, а не по имени. Первый параметр в списке тела заполняет первый заполнитель, второй заполняет второй и так далее. Назвать переменную нельзя: если поменять два параметра местами, сообщение успешно отправится, но значения окажутся не на своих местах.
Это самый опасный случай, потому что ничего не завершается ошибкой. Клиент получает подтверждение заказа, где дата стоит вместо суммы, и ни в одном журнале не появляется ошибка.
Компоненты используют разные списки
Переменная заголовка и переменная тела не входят в общий список. Каждый компонент содержит собственные параметры, а их объединение приводит к несовпадению количества.
- Параметры заголовка передаются в компоненте заголовка, и такой компонент может быть только один.
- Параметры тела передаются в компоненте тела, в заданном порядке.
- Параметры URL кнопки передаются в компоненте кнопки с индексом кнопки.
- Один общий список для всех компонентов возвращает ошибку 132000.
Как правильно указать язык
Шаблон определяется одновременно именем и языком, поэтому одинаковое имя на двух языках означает два разных шаблона. Если отправить en, хотя шаблон создан как en_US, автоматической подстановки не будет: запрос завершится ошибкой 132001, которая выглядит как отсутствие шаблона.
Получите список шаблонов для номера и скопируйте точную строку языка, не угадывая её формат. Это самая частая ошибка при работе с шаблонами и одна из наименее понятных.
Параметры с типом
Большинство параметров содержат обычный текст. Некоторые имеют тип, и передача их как текста завершается ошибкой 132012.
- Параметры валюты содержат сумму, код валюты и резервную строку.
- Параметры даты и времени содержат структурированный объект с резервным значением.
- Медиа-параметры заголовка содержат идентификатор медиафайла или ссылку, а не имя файла.
- Резервная строка показывается, если приложение получателя не может отформатировать значение.
Что означает каждая ошибка
Три ошибки можно различить. Если записывать их отдельно, а не объединять в одну ошибку шаблона, проверка занимает намного меньше времени.
Ошибка 132001 означает, что связка имени и языка не распознана, поэтому сначала проверьте язык. Ошибка 132000 означает неверное количество параметров, сравните его с определением шаблона. Ошибка 132012 означает неверный формат значения, обычно типизированный параметр был отправлен как обычная строка.
Распространённые ошибки
- Считать, что en автоматически заменяется на en_US. Это не так, и ошибка выглядит как отсутствие шаблона.
- Объединять параметры заголовка и тела в один список. Это разные компоненты.
- Отправлять валюту или дату как обычный текст. Для типизированных параметров задан отдельный формат.
EasyCoexistence показывает шаблоны с точными именами и кодами языков в панели управления и через MCP-коннектор. Поэтому при отправке используются значения, которые действительно сохранила Meta.
Часто задаваемые вопросы
У переменных шаблона есть имена?
Нет. Они передаются по позиции, поэтому порядок параметров определяет всё.
Почему мой шаблон не существует?
Обычно причина в коде языка. Шаблон определяется именем и языком вместе, автоматической подстановки нет.
Что будет, если отправить слишком много параметров?
Ошибка 132000. Лишние параметры обрабатываются так же, как и недостающие.
Как отправить сумму?
Как параметр валюты с суммой, кодом валюты и резервной строкой, а не как обычный текст.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на