Как настроить интеграцию с 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, признанной экстремистской организацией и запрещенной в Российской Федерации.