Как настроить интеграцию с WhatsApp Business API через сервис TextBack

Чтобы общаться с клиентами в WhatsApp напрямую из аккаунта GetCourse, нужно настроить интеграцию с данным мессенджером.

В этой статье расскажем об интеграции с WhatsApp через TextBack. О том, как подключить WhatsApp через другие провайдеры, читайте в следующей статье.

При подключении WhatsApp Business API инициировать переписку с пользователем можно только через шаблонные сообщения, которые предварительно одобрены Meta* (признана экстремистской организацией и запрещена на территории РФ).

Отправить обычное (не шаблонное) сообщение можно только при наличии двух условий:

1. Пользователь сам отправил вам сообщение из WhatsApp;
2. Прошло не более 24 часов с момента получения последнего сообщения от пользователя.

Если эти условия не соблюдены, то отправка обычных сообщений пользователю будет запрещена. В том числе нельзя будет отправить сообщение через личный диалог (раздел «Входящие» или «Общение с пользователем»). При этом если пользователь повторно напишет вам через мессенджер, то возможность отправки сообщения возобновится на 24 часа.

Шаблоны WhatsApp делятся на 3 категории (маркетинговые, транзакционные, аутентификация) и оплачиваются по-разному. Подробнее о шаблонах можно узнать из статьи Textback.

Зарегистрируйтесь на платформе TextBack и подключите официальный WhatsApp Business API.

После этого вам нужно сгенерировать токен доступа к API в личном кабинете в разделе «Интеграция».

Настроить интеграцию с WhatsApp могут:

• владелец аккаунта,
• администратор.

Для этого:

1. Перейдите в раздел «Сообщения» — «WhatsApp».

2. Нажмите «Добавить».

3. Заполните параметры:
   • название бота (отображается только в админке);
   • токен доступа к API;
   • привязанный телефон — зарегистрированный у провайдера номер телефона в формате 7xxxyyyyyyy (для ввода доступны только цифры, остальные символы не сохраняются).
4. Выберите провайдер «Textback bot».
5. Нажмите «Сохранить».

6. Протестируйте работу.

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

Сообщение должно быть отправлено с номера обычного пользователя, т.к. сообщения от сотрудников и администраторов не обрабатываются. Если бот подключен корректно, то в раздел «Сообщения» — «Входящие» придет отправленное сообщение.

• Через блок «Вход через соцсети» в конструкторе страниц
• С помощью ссылки
• Отправив сообщение на номер бота напрямую

Когда пользователь нажимает на кнопку «Войти через Whatsapp», в раздел «Сообщения — Входящие» вашего аккаунта Getcourse приходит стартовое сообщение. Текст сообщения можно задать в настройках блока «Кнопки входа через соцсети». Можно сделать так, чтобы стартовое сообщение не отображалось во «Входящих» аккаунта.

По умолчанию в текст добавляется переменная {auth_code}. Этот код авторизации позволяет сопоставить авторизованного пользователя с WhatsApp и добавить к текущему пользователю номер телефона. Если убрать данную переменную, то в случае, когда у пользователя не будет такого же номера в профиле, как в мессенджере, будет создан новый пользователь.

Опция «Показывать QR-код на десктопе» позволит отобразить на ПК QR-код при нажатии на кнопку. Это побуждает пользователя воспользоваться смартфоном. После сканирования QR-кода камерой на смартфоне пользователя откроется мессенджер и диалог с ботом.

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

Ссылка должна иметь вид:

https://api.whatsapp.com/send?phone=номербота&text=любой_текст

где «phone» — номер бота, «text» — текст сообщения, которое автоматически подставится в начало диалога для отправки.

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

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

GetCourse при получении сообщения из WhatsApp ищет пользователя по коду авторизации или по номеру телефона. Если существующий пользователь не находится, то создается новый пользователь с именем и номером телефона, полученным от WhatsApp.

Привязка WhatsApp происходит после первого сообщения от пользователя WhatsApp-боту. Статус WhatsApp отображается в карточке пользователя. Номер телефона будет добавлен в карточку, если его нет, и подтвержден, потому что сообщение, отправленное через мессенджер гарантирует, что номер существует.

Ответы на входящие сообщения клиента в течение 24 часов бесплатны. Поэтому важно оперативно реагировать и отправлять сообщения прямо:

• из раздела «Входящие» или «Общение с пользователем»,
• из карточки пользователя,
• из процесса.

Если пользователь пишет сообщения боту, то они отображаются в разделе «Сообщения» — «Входящие» и «Общение с пользователем» с пометкой мессенджера.

Красная пометка в поле выбора транспорта подскажет вам, что время для ответа с помощью обычного (не шаблонного) сообщения истекло. В этом случае вы можете или отправить пользователю шаблонное сообщение, или связаться с ним другим транспортом.

В карточке по кнопке «Действия» — «Отправить сообщение в WhatsApp» администратор может отправить сообщение пользователю. Оно будет доставлено только в том случае, если не прошло более 24 часов с момента последнего сообщения от этого пользователя.

В процессах вы можете отправлять сообщения пользователям в WhatsApp, прикреплять к ним видео или изображения, а также создавать чат-боты и опросы.

Для этого используйте:

• операцию «Отправить сообщение в WhatsApp»;
• callback-операцию «Отправить в WhatsApp сообщение и ожидать ответа».

Требования к изображениям:

• формат jpg или png,
• размер не более 5 мб.

Требования к видео:

• формат mp4,
• размер не более 16 мб.

Чтобы удалить прикрепленный к письму файл:

1. Поставьте напротив файла галочку в колонке «Удалить».
2. Сохраните настройки.

Шаблонное сообщение WhatsApp:

• Позволяет писать первым в WhatsApp по известному номеру телефона пользователя (наличие привязки WhatsApp в профиле не требуется).
• Бесплатное, если отправляется в рамках уже оплаченного 24-часового окна переписки (исключение — маркетинговый шаблон, он всегда платный).
• Текст не может быть любым — он должен соответствовать шаблону! Шаблон заранее должен быть одобрен у провайдера WhatsApp. Шаблон содержит места для подстановки значений (например имени, номера заказа, названия мероприятия, даты и т.п.).

Отправить шаблонное сообщение в WhatsApp можно следующими способами:

• с помощью рассылки,
• операциями в процессе,
• действием из карточки пользователя.

Создать рассылку можно в разделе «Сообщения» — «Рассылки».

Подробнее в статье → «Как отправлять сообщения по рассылкам на GetCourse».

Отправить шаблонное сообщение можно с помощью операции «Отправить сообщение в WhatsApp» и callback-операции «Отправить в WhatsApp сообщение и ожидать ответа».

Подробнее в отдельной статье → «Как использовать разные типы блоков в процессе».

Для отправки шаблонного сообщения используйте в разделе «Пользователи» или в карточке пользователя действие «Отправить сообщение в WhatsApp», выбрав необходимый шаблон.

В параметрах шаблона ({{v1}}, {{v2}} и т.д.) для подстановки значений можно использовать обычный текст, ссылки или переменные, указав их в фигурных скобках.

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

Для создания шаблона сообщения необходимо обратиться к вашему провайдеру.

Согласование шаблона с WhatsApp провайдер выполняет самостоятельно. Когда шаблон будет согласован и добавлен в систему провайдером, он автоматически станет доступен для выбора в блоках процесса в вашем аккаунте GetCourse.

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