Whatsapp Business API

Конструктор поддерживает также и официальный Ватсап

Работа официального Whatsapp не отличается от работы "серого". То есть, созданный бот для "серого", будет работать аналогично в белом.

WABA не работает с клиентами из Крыма. То есть если вам напишет клиент с крымским номером телефона, бот не ответит.

Как приобрести Whatsapp Business API

Вы можете использовать WABA, купленный у реселлера https://360dialog.com/

Подробнее о регистрации через Dialog360

Для регистрации в Диалог360 необходимо создать бизнес-аккаунт в Facebook*. При регистрации организации необходимо указывать сайт и доменную почту организации. То есть, если адрес сайта www.example.ru, то почта должна иметь вид info@example.ru. Почта mail, yandex и прочие не будут пропущены при регистрации на сайте Диалог360 https://www.360dialog.com/ru

После создания и подтверждения аккаунта на Facebook*, необходимо пройти регистрацию в Диалог360. Номер телефона строго указывается тот, что указан в аккаунте Facebook*. После регистрации и модерации в Диалог360 необходимо будет сгенерировать API ключ.

*Принадлежит компании Meta, запрещенной в России и признанной экстремисткой.

Как подключить Whatsapp Business

В целях экономии рекомендуем работать с серым Whatsapp.

Для подключения WABA к проекту Вам необходимо перейти в раздел "Каналы" и выбрать пункт Whatsapp Business API.

В открывшемся окне необходимо ввести номер телефона, начиная с 7, и сгенерированный API ключ

​На этом настройка заканчивается. Вам не надо держать телефон всегда в сети, бот будет работать стабильно и автономно.

Шаблоны сообщений для Whatsapp Business Api

При использовании Whatsapp Business Api пользователи не могут писать клиентам в любое время суток и направлять неограниченное количество сообщений при создании бота, аналогично серому Whatsapp, за пределами 24-часового окна обслуживания клиентов.

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

Данный функционал используется в Whatsapp для предотвращения спам-рассылок, ограничивая количество допустимых сообщений в определенный временной интервал, а также с присвоением категории шаблонам.

Существуют следующие категории сообщений, установленные для Whatsapp Business Api компанией Meta*:

  1. Полезные шаблоны (содержат конкретную информацию о транзакциях, счетах, оплатах и пр.);

  2. Шаблоны для маркетинга (информация о компании, организации, стратегиях, рекламе и продвижению);

  3. Шаблоны для верификации и аутентификации.

Шаблоны, созданные для WABA, подвергаются модерации. Как создать шаблон для Whatsapp Business Api, читайте далее

*Деятельность компании признана экстремисткой и запрещена на территории Российской Федерации.

Как установить шаблоны сообщений

Внутри 24-часового окна отправка шаблонных сообщений бесплатна.

В качестве первого сообщения клиенту может быть отправлен только шаблон, прошедший модерацию в Facebook.

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

Шаблоны могут не проходить модерацию, если используются переменные в шаблоне. Как на кириллице так и на латинице.

В Salebot для создания шаблонов сообщений Whatsapp необходимо зайти в раздел "Каналы", "Whatsapp Business API" и выбрать пункт "Шаблоны сообщений"

Откроется страница создания шаблонов.​

​Необходимо нажать на кнопку "Создать шаблон"

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

По умолчанию контент шаблона берется из блока, но можно указать свой текст и кнопки.​

​После создания сообщение отправляется на модерацию. Использовать можно только одобренные шаблоны. Обычно модерация занимает около 8 часов. Максимальное время модерации 48 часов.

Тип шаблона

Доступно для выбора 3 типа шаблонов:

К шаблону MARKETING можно подкрепить изображение в форматах: svg, png, jpg и gif.

Как передавать переменные в шаблонах

Переменные в шаблонах передаются так же, как во всем Salebot, а не по правилам whatsapp. Мы адаптировали переменные под Salebot и не понимаем переменные в формате {{1}}!!!!!!

При необходимости использовать переменные в шаблонах сообщений возьмите за правило использовать написание названий переменных строго латинскими буквами, например, #{example} и после отправки убедиться в том, что переменные приняты, перейдя по ссылке https://business.facebook.com/wa/manage/message-templates/

Если в шаблоне есть переменная, а в боте значение ей не присвоено или она отсутствует, то сообщение не будет отправлено!

Как работают кнопки в шаблонах

Шаблоны сообщений поддерживают кнопки. В Salebot кнопки задаются аналогично синтаксису Facebook* API. Познакомиться с ним можно по ссылке:

https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates#interactive-message-template-request

Кнопки задаются в формате JSON-массива

Параметры создания кнопок:

ПараметрОбязательныйОписание

type

Да

Значения: PHONE_NUMBER, URL, and QUICK_REPLY

text

Да

Текст кнопки

url

Нет

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

phone_number

Нет

Телефонный номер, на который будет совершен звонок при нажатии на кнопку

example

Нет

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

Пример

Сообщение с двумя кнопками: [{"type":"QUICK_REPLY", "text": "Да, удобно"}, {"type":"QUICK_REPLY", "text": "Неудобно"}]

*Принадлежит компании Meta, запрещенной в России и признанной экстремисткой.

​Какие есть особенности кнопок в шаблонах

Существует два типа предустановленных кнопок в шаблонных сообщениях:

Call-To-Action — это ссылки или номер телефона (рядом с самим текстом кнопки будет иконка ссылки или телефонной трубки);

Quick reply — это обычные текстовые кнопки, ограничение — 20 символов.

Кнопок типа Quick Reply в одном шаблоне может быть 3 шт., Call-to-Action — 2 шт., при этом нельзя сделать две ссылки или два номера.

Кнопки не могут содержать переменные, абзацы, эмоджи или символы форматирования.

При нажатии на кнопку Quick Reply, отправляется ее текст ответным сообщением.

На кнопку Call-to-Action можно прикрепить ссылку на файл. Кнопка Call-to-Action со звонком переносит в стандартное меню звонка телефона, с десктопа появится окно о том, что нельзя делать звонки в WhatsApp Web.

Как проходит модерация шаблонов

Каждый шаблон после создания отправляется на модерацию. Обычно модерация занимает около 8 часов. Максимальное время модерации 48 часов.

Статус модерации отображается в списке шаблонов.

В случае отклонения шаблона, будет указана причина.

Шаблоны, которые с большой вероятностью пройдут модерацию:

Курсивный текст может меняться

Здравствуйте, мы не смогли до Вас дозвониться. Вам удобно будет продолжить общение здесь?

Здравствуйте, Вы оставили обращение на сайте и просили с Вами связаться.(может меняться)

Здравствуйте, Я Иванов Иван из Salebot ранее Вы обращались за созданием чатбота. Рады сообщить, что у нас Для вас есть новости.

Шаблоны, которые не пройдут модерацию:

любой рекламный текст

Как проверить попадание в 24-часовое окно

Вы можете узнать сколько дней прошло с момента последней реплики клиента. Для необходимо использовать в условии функцию days_from_last_message()

Пример проверка попадания в 24-часовое окно:

days_from_last_message() == 0

​Как используются кнопки без использования шаблонов

Кнопки без использования шаблонов могут быть двух видов: inline и reply. Настраиваются точно так же, как и в других мессенджерах.

В блоке может быть не более 3 reply кнопок​

Inline-кнопок можно создавать до 10 штук, и выглядят они так:​

​В кнопках без использования шаблонов может быть только текст. Ссылки не поддерживаются! Кнопки вне шаблонов могут выполнять функционал только по переводу клиента из блока в блок.

В кнопках без использования шаблонов может быть только текст. Ссылки не поддерживаются! Кнопки вне шаблонов могут выполнять функционал только по переводу клиента из блока в блок.

Ограничения неверифицированных аккаунтов

Для неверифицированных аккаунтов на Фейсбук* есть ограничения: 50 шаблонных сообщений/день(включены в ежемесячную плату). По входящему трафику ограничений нет.

Чтобы снять ограничения, необходимо пройти верификацию компании, которая длится от 2-3 недель.

Система оплаты: Стоимость входящих и исходящих сообщений для неверифицированных аккаунтов уточняйте у реселлера. Оплачивается напрямую в 360 диалог (компания европейская, закрывающие документы не предоставляют)

*Принадлежит компании Meta, запрещенной в России и признанной экстремисткой.

Last updated