Интеграция с WhatsApp

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

• TextBack
• GetLoo
• Messenger

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

Диалоги через WhatsApp измеряются двумя временными окнами:

1. 24-часовое окно переписки:
   • начинается, когда компания отправляет шаблонное сообщение клиенту и заканчивается через 24 часа;
   • время переписки нельзя продлить;
   • после окончания 24-часового окна оплачивается новая переписка;
   • в рамках одной переписки можно отправить любое количество сообщений.
2. 24-часовое окно на обслуживание клиента:
   • начинается, когда первым написал клиент и с момента его последнего сообщения не прошло 24 часа;
   • в этот период компания может отвечать сообщениями с произвольным текстом или шаблонами.

Стоимость переписки зависит от ее типа:

• Ответ на входящее сообщение от пользователя — клиент написал первым и с момента его последнего сообщения не прошло 24 часа (время на обслуживание клиента). Ответы на входящие сообщения стоят дешевле.
• Исходящее сообщение, отправленное компанией — компания написала первой или с момента последнего сообщения от клиента прошло больше 24 часов (окно переписки). Сообщения стоят дороже.

Информацию о точных тарифах уточняйте у провайдера WhatsApp Business API.

Переписка начинается и считается оплаченной с момента, когда компания отправляет сообщение пользователю, например, 03 мая в 12:03. Сообщения, отправленные в течение следующих 24 часов, т.е. до 04 мая 12:03 — бесплатные.

По истечении 24-часового окна переписки вы можете оплатить и начать новую переписку.

Для каждой учетной записи предусмотрена 1000 бесплатных переписок в месяц. Начиная с 1001, переписки платные.

Бесплатной будет также первая переписка, если клиент начал ее:

• нажав на кнопку в рекламе с переходом в WhatsApp (кнопка «Отправить сообщение» в объявлении на Facebook* или в Instagram*);
• нажав на кнопку с призывом к действию на странице в Facebook*.

Зарегистрируйтесь и приобретите услугу предоставления WhatsApp в сервисе TextBack.

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