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

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

При использовании «серых» схем (с использованием обычного аккаунта WhatsApp) номер будет заблокирован — WhatsApp активно борется со спамом. Официальная интеграция Геткурса и WhatsApp снимает этот риск.

Возможности WhatsApp Business API в Геткурс:

• Получать и отправлять сообщения через WhatsApp в разделе «Входящие» (ручная переписка).
• Отправлять сообщения через процесс (автоворонки, чат-бот или опросы через WhatsApp).
• Автоподтверждение номера телефона — после привязки мессенджера к профилю пользователя номер будет автоматически определен и подтвержден.

Важная информация!

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

Инициировать переписку с пользователем можно, используя шаблонные сообщения.

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

Содержание статьи:

• Принцип работы и тарификация
• Подключение официального WhatsApp Business API к аккаунту GetCourse
• Способы привязки WhatsApp к профилю пользователя
• Как отправить сообщения в рамках 24-часового окна
• Как инициировать переписку с пользователем с помощью шаблонного сообщения WhatsApp

При использовании WhatsApp Business API диалоги измеряются двумя временными окнами:

24-часовое окно переписки:

• Начинается, когда компания отправляет шаблонное сообщение клиенту и заканчивается через 24 часа.
• Время переписки нельзя продлить.
• После окончания 24-часового окна оплачивается новая переписка.
• В рамках одной переписки можно отправить любое количество сообщений.

24-часовое окно на обслуживание клиента:

• Начинается, когда первым написал клиент и с момента его последнего сообщения не прошло 24 часа.
• В этот период компания может отвечать сообщениями с произвольным текстом или шаблонами.

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

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

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

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

Для каждой учетной записи WhatsApp Business API (WABA) предусмотрено 1000 бесплатных переписок в месяц. Начиная с 1001 — переписки платные.

Обратите внимание: Количество бесплатных переписок привязано к учетной записи WABA и не зависит от количества подключенных номеров телефона.

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

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

Обратите внимание: платить не нужно только за первую переписку! Все последующие переписки с этим клиентом будут платными.

Выбор провайдера

На данный момент приобрести официальный WhatsApp Business API для интеграции с Геткурс можно у следующих провайдеров:

• SynergyBot
• TextBack

После приобретения WhatsApp Business API провайдер выдаст вам «Токен доступа к API».

Если бот приобретен в TextBack, то токен доступа к API необходимо сгенерировать самостоятельно в личном кабинете в разделе «Интеграция».

Настройка в аккаунте Геткурс

Для интеграции официального WhatsApp Business API к аккаунту необходимо:

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

2) Нажать кнопку «Добавить».

3) Заполнить параметры:

• название бота (отображается только в админке);
• токен доступа к API.

Провайдер SynergyBot предоставляет API token в виде ссылки. Её необходимо добавить в поле «Токен доступа к API».

Пример: https://ru1-w.channels.synergybot.com/api/1001/xxxcvcxvzvcxbfdyyybbzzzfdfg/

• ввести номер телефона, на который был зарегистрирован WhatsApp Business в формате 7xxxyyyyyyy в поле «Привязанный телефон». Для ввода доступны только цифры, остальные символы не сохраняются;
• выбрать вашего провайдера из списка;
• нажать кнопку «Сохранить».

Обратите внимание: ранее провайдер SynergyBot предоставлял API token следующего вида — "номер канала/токен": 1001/ff8e3578dd000001441624eb37d

Если интеграция с WhatsApp уже была успешно настроена, она продолжит корректно работать с прежним токеном — изменения не требуются.

Если интеграция настраивается повторно или впервые, то токен должен быть именно в виде ссылки.

4) Протестировать работу

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

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

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

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

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

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

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

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

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

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

После нажатия на такую ссылку с телефона или ПК, у клиента откроется приложение WhatsApp и диалог с ботом.

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

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

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

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

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

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

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

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

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

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

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

1. Условие по пользователям «Было входящее из WhatsApp» необходимо для проверки привязки мессенджера к пользователю.
2. Условие по пользователям «Можно отправить WhatsApp-сообщение сейчас» необходимо для проверки возможности отправки обычного (не шаблонного) сообщения в текущий момент. Данное условие автоматически определяет время, которое прошло с момента последнего сообщения от пользователя через мессенджер. Если прошло более 24 часов, то значение «Нет», если менее — «Да».

Блок «Операция» — «Отправить сообщение в WhatsApp» необходим для отправки сообщения в мессенджер.

Блок «Callback-операция» — «Отправить в WhatsApp сообщение и ожидать ответа» необходим для отправки сообщения в мессенджер и ожидания ответного сообщения от пользователя. Данный блок можно использовать, например, для создания опросов/автоворонок/чат-бота.

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

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

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

• с помощью рассылки
• операциями в процессе «Отправить сообщение в WhatsApp» и «Отправить в WhatsApp сообщение и ожидать ответа»
• действием «Отправить сообщение в WhatsApp» из карточки или массово по сегменту

— с помощью рассылки с транспортом «WhatsApp»:

— через процесс с помощью блока операции «Отправить сообщение в WhatsApp»
и callback-операции «Отправить в WhatsApp сообщение и ожидать ответа»:

— массовым действием по пользователям или из карточки пользователя «Отправить сообщение в WhatsApp»:

Параметры шаблона

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

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

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

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