Шаблоны сообщений

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

Требования

• Для начала переписки можно использовать только одобренные шаблоны сообщений. Подробнее.
• Чтобы с клиентом можно было начать переписку категории "Услуги", "Маркетинг" или "Аутентификация", этот клиент должен согласиться на получение сообщений от вашей компании. Подробнее…

Поддерживаемые категории шаблонов

См. Категории.

Переводы

При отправке шаблона сообщения укажите язык в поле language. Ответственность за используемые переводы несет компания.

Поддерживаемые языки

Языковые пакеты

Шаблоны сообщений хранятся в языковых пакетах. Языковой пакет — это набор элементов шаблона сообщения для определенного языка или региона. Если у компании есть хотя бы один перевод для определенного языка или региона, создается соответствующий языковой пакет.

Пространство имен шаблона сообщения — это набор языковых пакетов для определенной компании.

Параметры языковой политики

Если при отправке шаблона сообщения для поля language: policy установлено значение deterministic (значение по умолчанию), WhatsApp доставляет шаблон строго на указанном языке (или его версии для указанного региона). Затем устройство запрашивает на сервере языковой пакет для соответствующего языка.

При доставке этого сообщения на устройство реализуется следующий алгоритм:

• Проверка политики и кода. Есть ли на устройстве кэшированный пакет en для "policy": "deterministic" и "code": "en"?

  • Если да, переходим к проверке элемента.
  • Если нет, есть ли на сервере пакет en?

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

• Проверка элемента. Существует ли элемент "element": "hello_world"?

  • Если да, распаковываем параметры и отображаем сообщение на устройстве.
  • Если нет:

    • если языковой пакет взят из локального кэша, скачиваем последнюю версию пакета en с сервера и повторяем проверку элемента;
    • если языковой пакет был недавно скачан с сервера, регистрируем ошибку, сервер возвращает ошибку structure_unavailable через Webhook и на устройстве не отображаются никакие сообщения.

Настройки языка и региона на устройстве полностью игнорируются.

Проблема с политикой deterministic может возникнуть в ситуации, когда какой-либо из указанных объектов не существует. Убедитесь, что выполняются следующие условия:

• пространство имен указано правильно;
• название элемента указано правильно;
• для этого элемента существует перевод на указанный язык или для указанного региона;
• количество отправленных параметров соответствует их количеству в шаблоне сообщения.

Локализация

Шаблоны сообщений поддерживают встроенную локализацию в соответствии с языковыми настройками устройства.

Локализуемые параметры

Шаблоны содержат параметры, которые динамически подставляются в сообщения. Для примера, который используется в этом документе, шаблон сообщения выглядит так:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

Для пары параметров "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" и "element_name": "purchase_with_credit_card" первое из указанных вами значений заменяет в шаблоне переменную {{1}}, а второе — переменную {{2}}.

Некоторые из этих параметров (например, date_time и currency) являются локализуемыми и отображаются с учетом языковых и региональных настроек пользователя. Если устройству не удается локализовать параметр, оно использует значение fallback_value.

Чтобы указать значения валюты и даты (в дополнение к значению fallback_value), используются объекты currency и date_time. В результате клиент сможет локализовать соответствующие данные наилучшим образом, и лишь в случае невозможности использует вариант fallback_value.

Возможные локализуемые параметры localizable_params перечислены в таблице ниже.

Параметры

Объект currency

Клиент WhatsApp Business API пытается отображать валюту в выбранном формате локализации.

Пример

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

Объект date_time

Клиент WhatsApp Business API пытается отображать дату и время в выбранном формате локализации. В частности, поддерживаются перечисленные ниже форматы даты и времени.

• Штучное время — время состоит из единиц (день недели, месяц, час и т. д.). Указанное время не будет изменяться в зависимости от часового пояса клиента.
• Время Unix — отображаемое время зависит от часового пояса клиента.

DateTime

DateTimeComponent

Пример

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

Дальнейшие действия

Этот документ содержит справочную информацию о шаблонах сообщений. Инструкции по созданию и отправке шаблонов см. в статье Отправка шаблонов сообщений. Список всех параметров, которые можно использовать в шаблонах сообщений, см. в этом разделе.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager