Работа с шаблонами WhatsApp Business API (WhatsApp 360dialog)

База знаний
Возможности
Шаблоны
Работа с шаблонами WhatsApp Business API
Работа с шаблонами WhatsApp Business API (WhatsApp 360dialog)

Как создать HSM-шаблон и отправить его через Chat2Desk

Содержание

Этап 1. Создание шаблона в личном кабинете 360dialog

Создание текстового HSM-шаблона

Создание медиа HSM-шаблона

Этап 2. Отправка шаблона из Chat2Desk

Примеры шаблонов

Старая разметка

Этап 1. Создание шаблона в личном кабинете 360dialog

Войдите в личный кабинет 360dialog по ссылке https://hub.360dialog.com/auth/login

Откройте вкладку WhatsApp Accounts. Перед вами окажутся все ваши аккаунты

Выберите нужный аккаунт и нажмите Manage templates. Вы попадете в раздел со всеми вашими шаблонами.

Нажмите + Add template. Перед вам откроется окно создания нового шаблона

Создание текстового HSM-шаблона

Введите название шаблона в поле Name. Можно использовать только латиницу. При необходимости, в качестве разделителей нужно использовать нижнее подчеркивание.
Выберите категорию.

Utility – услуги;
Marketing – маркетинговые;
Authentication – аутентификация пользователей;

Выберите язык.
Тип шаблона оставьте как есть – Standard (text only).
В разделе Body введите текст сообщения, максимум 1024 символа. Здесь в фигурных скобках указываются места, в которых будут стоять переменные. Переменные – это слова или числа, которые меняются в каждом новом сообщении и прописываются вручную. К ним относятся имена клиентов и операторов, номера заказов, время суток. Словом, любые изменяемые части.

Пример: Здравствуйте, {{1}}. На связи {{2}} из отдела продаж.

Значения переменных нужно будет вставить позже, уже в Chat2Desk.

Нажмите Preview and submit. Откроется окно предварительного просмотра

В полях Example values напишите примеры переменных и они отразятся в превью справа. Далее нажмите Submit. Так вы подтвердите шаблон, и он появится в личном кабинете сверху остальных шаблонов.

Затем шаблон автоматически отправится в Facebook* на верификацию. Как только он подтвердится, его можно будет отправлять клиентам в Chat2Desk. Как это делать, мы объясняем далее в статье.

Шаблон можно верифицировать принудительно. Для этого нажмите кнопку Synchronize with Facebook*.

Создание медиа HSM-шаблона

Укажите название шаблона – латиницей, с нижними подчеркиваниями.
Выберите категорию.
Выберите язык.
Выберите Template style > Media & Interactive.
Заполните блоки Header, Body, Footer, Buttons.
Нажмите Preview and submit.

Header – шапка шаблона. Сюда вставляется приветственный текст, изображение, видео или документ. Тут можно указать переменную, например Здравствуйте, {{1}}.

Выберите тип контента – Text, Image, Document, Video. Сами файлы прикрепляются позже, в шаге 5.

Body – основной текст с переменными

Пример:

Здравствуйте, {{1}}.

Меня зовут {{2}}, я из отдела продаж. Скажите, чем я могу вам помочь?

Footer – текст, который побуждает выполнить действие в кнопках

Пример: Выберите один из трех вариантов.

Buttons – кнопки, которые бывают двух видов.

Кнопки call-to-action. Здесь вы можете указать ссылку на сайт, YouTube-видео, или любой другой лендинг, а также номер телефона. Всего возможны две такие кнопки.
Быстрый ответ – укажите варианты ответа, чтобы клиент мог одним нажатием ответить вам в чат. Их может быть всего три.

Нажмите Preview and submit. Откроется окно предварительного просмотра.

Если у вас есть вложение, нужно указать прямую ссылку на файл в виде URL, например: https://somesite.com/some_place/some_file.png

При необходимости добавить документ, используйте PDF-файлы, поскольку DOC в шаблонах не поддерживается.

360dialog не загружают файл, а прикрепляют ссылку, поэтому доступ к нему должен быть постоянным.

Загрузка файлов с сервисов хранения, таких как Google Drive, Яндекс.Диск и т. п., не поддерживается.

Этап 2. Отправка шаблона из Chat2Desk

Для этого откройте диалог с клиентом и пропишите строчки шаблона из личного кабинета 360dialog вручную.

Шаблон состоит из нескольких строк:

@HSM@	Эта метка говорит сервису, что вы отправляете именно HSM-шаблон
имя_шаблона\|язык	Здесь указывается название шаблона, такое же как в 360dialog. С маленькой буквы и с нижними подчеркиваниями. Язык указывается в формате en/ru. Правильное сокращение для каждого языка есть в списке языков в конструкторе шаблона.
переменные шаблона	Здесь указываются переменные шаблона, если они есть. Переменные указываются в новой строчке, по последовательности, которая указана в шаблоне. Тип переменной прописывать не надо, только значение

В разметке не нужно указывать кнопки. Они уже прописаны и зашиты в шаблон. Если в шаблоне есть вложение, то его необходимо прикрепить к сообщению.

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

Текстовый HSM-шаблон без переменных

Текстовый HSM-шаблон с переменными

Медиа HSM-шаблон

Что нужно написать

@HSM@
first_template|ru

@HSM@
second_template|ru
Дмитрий
Артемий

@HSM@
third_template|ru
Дмитрий
Артемий

Что придет клиенту

Здравствуйте. На связи отдел продаж.

Здравствуйте, Дмитрий. На связи Артемий из отдела продаж.

Здравствуйте, Дмитрий.

*картинка*

Меня зовут Артемий, я из отдела продаж. Скажите, что я могу для вас сделать?

Перезвоните мне
Напишите мне
Ничего не надо

Для удобства сохраните каждый HSM-шаблон в шаблонах в Chat2Desk. На месте переменных укажите, что именно здесь нужно написать. Например:

@HSM@
greeting|ru
имя клиента
имя оператора

Так вам не придется каждый раз заново прописывать этот шаблон.

Сумма за HSM-шаблоны списывается с вашего депозита. Для того, чтобы узнать, сколько у вас осталось средств, откройте раздел Настройки > Аккаунты, выберите канал с WhatsApp Business API и нажмите на иконку карандаша.

Примеры шаблонов

Шаблон без переменных

Редактор шаблона

Превью шаблона

Отправка шаблона из Chat2Desk

Как сообщение выглядит в WhatsApp

Шаблон с переменными

Редактор шаблона

Переменные указаны в формате {{n}}, где n — порядковый номер переменной в блоке.

Превью шаблона

Отправка шаблона из Chat2Desk

Как сообщение выглядит в WhatsApp

Шаблон с кнопками

Редактор шаблона

Превью шаблона

Отправка шаблона из Chat2Desk

Как сообщение выглядит в WhatsApp

Отдельно указывать кнопки в разметке не требуется. Исключения составляют кнопки с переменной. На примере ниже, в кнопку типа «Призыв к действию» добавлена переменная.

Часть редактора шаблона

Превью шаблона

Отправка шаблона из Chat2Desk

Как сообщение выглядит в WhatsApp

В случае с этим примером, если клиент нажмет на Открыть ответ, то у него откроется эта статья.

Шаблон с переменными в нескольких блоках

Редактор шаблона

Превью шаблона

Отправка из Chat2Desk

Переменные необходимо указывать в том порядке, в каком они находятся в превью шаблона. Сперва указываются значения переменных в Header, после указываются переменные в Body, последними указываются переменные Buttons.

Как сообщение выглядит в WhatsApp

Шаблон с вложением

Редактор шаблона

Превью шаблона

Для вложения необходимо указать URL, по которому оно находится и может быть открыто.

Отправка из Chat2Desk

При отправке шаблона указывать его URL не нужно. Чтобы отправить шаблон необходимо прикрепить вложение к сообщению. В окне чата это делается через значок скрепки.

Как сообщение выглядит в WhatsApp

Старая разметка шаблонов

Ниже описана разметка, которая использовалась раньше. Шаблоны в этом формате будут продолжать работать, но не будут поддерживать переменные в header и button.

@HSM@	Эта метка говорит сервису, что вы отправляете именно HSM-шаблон
имя_шаблона\|язык	Здесь указывается название шаблона, такое же как в 360dialog. С маленькой буквы и с нижними подчеркиваниями. Язык указывается в формате en/ru. Правильное сокращение для каждого языка есть в списке языков в конструкторе шаблона.
header\|тип вложения	Здесь указывается тип вложения медиа-шаблона. Видео, фото, документ или текст. Строка нужна только для медиа-шаблона, если есть вложения.
body\|тип формата данных	Эта строчка отвечает за основной текст шаблона, который прописан в личном кабинете 360dialog. Здесь нужно указать тип формата данных, возможен только текст – text. После типа формата данных нужно указать переменные, через вертикальную черту \|.
footer\|тип контента	Эта строка отвечает за текст, который стоит перед кнопками.В качестве типа контента можно указать только текст — text. Если у вас не медиа-шаблон и кнопок нет, то строчку прописывать не надо