Переменные шаблона WhatsApp: {{1}} или именованные параметры

{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}

{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}

Как передать параметры в вызове API?

Вы отправляете название шаблона, язык и массив components со значениями. Вот структура для позиционного шаблона:

{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}

Для именованного шаблона каждая запись дополнительно содержит parameter_name, который должен совпадать с заполнителем:

{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }

Как работают параметры медиазаголовка?

У медиазаголовка нет текстовой переменной. При создании заголовок содержит handle примера файла из процесса загрузки Meta, и этот пример проверяется вместе с шаблоном. При отправке вы передаёте сам файл, например изображение по идентификатору медиа:

{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }

Идентификатор выше взят из примера в документации Meta и не относится к реальному файлу.

Как это выглядит в API OmniChannels.ai?

Наш эндпоинт sendbulk принимает шаблон в виде полей формы, см. документацию WhatsApp API:

Пример: шаблон «заказ отправлен»

«Souq Rafiq» (вымышленный пример), ритейлер из ОАЭ, хочет отправлять уведомление об отправке с изображением товара и кнопкой отслеживания.

1. Напишите шаблон так, чтобы он не начинался и не заканчивался переменной: «Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it.»
2. Добавьте заголовок с изображением, нижний колонтитул обычным текстом и URL-кнопку https://shop.example/track/{{1}} с примером вроде OM-4821.
3. Отправьте на проверку с реалистичными примерами для каждой переменной и дождитесь статуса одобрения.
4. Отправляйте с тремя значениями тела, суффиксом для отслеживания и, если нужно переопределить, изображением заголовка.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821

Этот фрагмент показывает названия полей для одного значения. Если у каждого получателя несколько переменных тела, используйте персонализированную загрузку вместо повторения команды. Кодировку уточните у нашей команды перед первой кампанией.

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

Используйте одну строку на получателя и один столбец на переменную, затем загрузите файл при персонализированной отправке.

1. Поместите номер получателя в международном формате в первый столбец. См. формат номера E.164.
2. Добавьте по столбцу на каждую переменную и уточните структуру столбцов у нашей команды перед первой кампанией.
3. Сначала почистите данные: уберите лишние пробелы, исправьте регистр, приведите даты к одному формату и удалите пустые значения, ведь пустая переменная даёт испорченное сообщение или сбой отправки.
4. Просмотрите несколько строк в предпросмотре и сначала отправьте на свой номер.

Шаги по очистке данных описаны в статье массовая SMS-рассылка из Excel или CSV; к WhatsApp они применимы так же.

Как выбрать между позиционными и именованными?

Ориентируйтесь на то, сколько людей работает с шаблоном и сколько в нём переменных.

1. Одна-две переменные, один владелец: подойдёт позиционный формат, он и так используется по умолчанию.
2. Три и больше переменных или шаблоны правят несколько команд: выбирайте именованный, чтобы каждый заполнитель объяснял себя сам.
3. Один текст на нескольких языках: сохраняйте одинаковые имена или номера во всех версиях, чтобы одна процедура отправки заполняла любой язык.
4. Всегда ведите учёт, какой столбец источника питает какую переменную, чтобы позднее изменение шаблона не сместило данные.

Перед отправкой на проверку прочитайте готовое сообщение вслух с примерами значений. Если звучит неестественно, так же решат и проверяющие, и клиенты.

Какие ошибки встречаются чаще всего?

• Шаблон начинается или заканчивается переменной, что Meta называет причиной отклонения.
• Пропуск номеров или повтор номера не по порядку в позиционном шаблоне.
• Заглушки вместо примеров вроде «test», которые ничего не сообщают проверяющим.
• Спецсимволы вроде #, $ или % внутри переменных.
• Неверный порядок при отправке в позиционном шаблоне: верные данные попадают не туда.
• Несовпадающий parameter_name в именованном шаблоне.
• Переменная, скрывающая настоящую цель сообщения. Шаблон, категория которого не соответствует содержанию, могут отклонить или перекатегоризировать; см. руководство по категориям.
• Границы статьи: руководство передаёт то, что указано в документации Meta на момент написания. Решения по проверке остаются за Meta, а правила меняются, поэтому сверяйтесь со страницами по ссылкам.

Чем помогает OmniChannels.ai

BroadNet — официальный бизнес-провайдер решений Meta (Meta Business Solution Provider). В OmniChannels.ai вы можете создавать шаблоны WhatsApp с переменными, медиа и кнопками, просматривать их и отслеживать статус одобрения, а затем отправлять с персонализированными значениями через API или из загрузки Excel либо CSV в кампании. Фильтрация дубликатов и отчёты о доставке включены. См. страницу WhatsApp Business API и платформу кампаний.