В данной пошаговой инструкции мы подробно опишем весь процесс получения доступа к WhatsApp Business API через сервис Gupshup и подключения WhatsApp к Открытым линиям Битрикс24 CRM. Данный сервис мы нашли для себя, для своих бизнес задач и хотим этим поделиться с вами.

*Деятельность Meta Platforms Inc. (Facebook, Instagram) запрещена на территории Российской Федерации

Основным условием для подключения к WhatsApp Business API является наличие зарегистрированного юридического лица, например ООО или ИП, на физическое лицо доступ получить не получится.

Итак, начнем двигаться по шагам.

*Деятельность Meta Platforms Inc. (Facebook, Instagram) запрещена на территории Российской Федерации

Создайте аккаунт в Gupshup следуя этой инструкции: https://docs.gupshup.io/docs/overview

Создайте приложение в дашборде Gupshup следуя этой инструкции: https://docs.gupshup.io/docs/quickstart-create-and-configure-access-api

Подключите телефонный номер следуя этой инструкции: https://docs.gupshup.io/docs/onboarding-guide

Чтобы процесс Go-Live заработал, добавьте наш Partner ID 117 (ANWEB) в приложение Gupshup, а затем запустите процесс Go-Live.

Для того, чтобы начать получать и отправлять сообщения через ваш подключенный номер телефона к WhatsApp Business API Gupshup, подключим ваш аккаунт Gupshup к вашему порталу Битрикс24.

В Битрикс24 устанавливаем приложение WhatsApp Business API Gupshup из маркетплейса, для этого переходим по ссылке https://www.bitrix24.ru/apps/?app=aiappspro.whatsapp_business_api_gupshup_subscription и нажимаем на зеленую кнопку "УСТАНОВИТЬ".

Если Вы еще не залогинились в маркетплейсе Битрикс24, то откроется всплывающее окно с кнопкой "ВХОД". Нажмите ее для входа под вашей учетной записью Битрикс24.

Если у Вас еще нет Битрикс24, то перейдите по ссылке "СОЗДАЙТЕ ПРЯМО СЕЙЧАС" в этом же всплывающем окне и зарегистрируйте себе Битрикс24 на свой адрес электронной почты или используя один из своих аккаунтов предложенных социальных сетей.

После успешного входа в маркетплейс Битрикс24, в том же самом всплывающем окне, которое появилось после нажатия зеленой кнопки "УСТАНОВИТЬ", выбираем из списка ваш портал Битрикс24.

В новой вкладке вашего браузера откроется ваш Битрикс24 с предложением установить приложение WhatsApp Business API Gupshup. Нажимаем синюю кнопку "УСТАНОВИТЬ".

Ознакамливаемся с лицензионным соглашением и политикой конфиденциальности по ссылкам и ставим галочки в случае согласия с условиями. Нажимаем зеленую кнопку "УСТАНОВИТЬ".

После успешной установки, в вашем Битрикс24 автоматически будет создан чат 24/7 поддержки приложения, в который Вы сможете писать в любое время, если будут возникать любые вопросы по работе с приложением.

Итак приложение установлено, переходим к активации коннектора для WhatsApp Business API в Контакт-центре Битрикс24.

Закрываем слайд установки приложение, переходим в Контакт-центр Битрикс24 и там кликаем по установленному коннектору "WhatsApp Business API Gupshup".

В открывшемся слайдере настроек коннектора, кликните по кнопке "ПОДКЛЮЧИТЬ".

Если в вашем Битрикс24 создано несколько Открытых линий, то ниже необходимо будет выбрать нужную Открытую линию, к которой Вы хотите подключить WhatsApp, и уже после выбора нажать кнопку "ПОДКЛЮЧИТЬ".

В этом же самом слайдере откроется интерфейс настроек коннектора.

В новой вкладке браузера перейдите в ваш Дашборд Gupshup по ссылке https://www.gupshup.io/whatsapp/dashboard, кликните по иконке вашего профиля и во всплывающем окне скопируйте API Key.

Возвращаемся к окну настроек коннектора в Битрикс24 и в поле "Gupshup API key" вводим API Key, скопированный в вашем аккаунте Gupshup.

В новой вкладке браузера возвращаемся в ваш Дашборд Gupshup по ссылке https://www.gupshup.io/whatsapp/dashboard и копируем номер телефона для поля "Gupshup sender", для чего переходим по ссылке "Настройки" в списке приложений в вашем аккаунте Gupshup.

Откроется интерфейс настроек приложения в Gupshup, прокручиваем страницу вниз до раздела "Проверить API доступа и установить URL обратного вызова" и копируем телефонный номер из поля "Отправитель". Если ваш собственный номер телефона еще ожидает подтверждения, то в этом поле будет указан тестовый телефонный номер от Gupshup, который пока можно использовать для тестирования приложения.

Не закрываем пока это окно настроек приложения в Gupshup, оно нам еще пригодится ниже. Возвращаемся к окну настроек коннектора в Битрикс24 и в поле "Gupshup sender" вводим скопированный номер телефона отправителя.

Нажимаем кнопку "Подключить". После успешного подключения появятся сообщения "Коннектор успешно подключен" и "Скопируйте callback URL и введите его в настройках Gupshup". Копируем "Gupshup callback URL" нажатием кнопки "Копировать".

Возвращаемся в наше открытое окно настроек приложения в Gupshup, кликаем по вкладке "URL обратного вызова / Свяжите со своим ботом", переключаем ползунок в положение "ON".

Устанавливаем ниже все галочки в разделе "Выберите, какие события состояния сообщений вы хотите получать по URL-адресу обратного вызова". В поле "Введите URL обратного вызова" вводим скопированный в настройках коннектора в Битрикс24 "Gupshup callback URL" и нажимаем кнопку "Set" для применения настроек.

Коннектор "WhatsApp Business API Gupshup" готов к работе!

Если Вы еще ожидаете подтверждения вашего телефонного номера и хотите пока протестировать коннектор через тестовый телефонный номер от Gupshup, то прокрутите вверх страницу настроек приложения в Gupshup до раздела "Смарт-механизмы для регистрации и вовлечения пользователей" и кликните по иконке "Нажать на ссылку". В новой вкладке откроется кнопка для подтверждения согласия на прием тестовых сообщений. Установите галочку "I agree…" и нажмите кнопку "Send Message". Откроется приложение WhatsApp для отправки предустановленного сообщения "PROXY…" с вашего личного номера WhatsApp. Отправьте данное сообщение без изменения на тестовый номер Gupshup. Поступит ответ "Welcome! You're now chatting with…". Теперь Вы можете отправлять тестовые сообщения, которые будут поступать в Открытую линию Битрикс24.

Далее приведем примеры отправки и приема сообщений через рабочий номер телефона.

Отправьте сообщение, например с Вашего личного номера WhatsApp на ваш номер телефона WhatsApp Business API, одобренный через сервис Gupshup.

Примите сообщение в Открытой линии вашего Битрикс24 и напишите ответ.

Поддерживаются любые типы сообщений: текстовые сообщения, изображения, видео, голосовые сообщения, файлы, координаты местоположения. Обработка сообщений производится в соответствии с настройками открытой линии.

Для возможности написать пользователю по истечению 24 часов с момента последнего сообщения от него, необходимо подготовить специальные шаблоны и получить их одобрение со стороны WhatsApp. Сообщение не должно нести рекламный характер — WhatsApp одобряет только сервисные и транзакционные шаблоны. Шаблоны должны соответствовать правилам: Политика WhatsApp Business, Торговая политика WhatsApp.

Шаблоны нужно создавать в вашем аккаунте Gupshup. Для этого перейдите в Дашборд Gupshup по ссылке https://www.gupshup.io/whatsapp/dashboard, перейдите по ссылке "Настройки" в списке приложений Gupshup.

*Деятельность Meta Platforms Inc. (Facebook, Instagram) запрещена на территории Российской Федерации

Прокрутите открывшуюся страницу настроек вниз до раздела "Проверить API доступа и установить URL обратного вызова" и там перейдите по ссылке "Посмотреть шаблоны".

В новой вкладке браузера откроется страница "Список шаблонов". В открывшемся списке будут только шаблоны для отправки через тестовый номер Gupshup с пометкой "Разрешено к использованию на тестовом сервере". Для вашего номера их не получится использовать, нужно будет создать свои шаблоны.

Для добавления своего шаблона нажмите на кнопку "Добавить еще".

В открывшемся интерфейсе заполните все необходимые поля и нажмите кнопку "Предварительный просмотр и отправка". Ниже приводим пример заполнения полей для нашего одобренного шаблона.

Проверьте все данные и нажмите кнопку "Отправить".

После отправки, ожидаем 1–2 рабочих дня одобрения шаблона со стороны WhatsApp. Писем при этом никаких не приходит, проверять изменение статусов отправленных шаблонов нужно самим в своем аккаунте Gupshup. В фильтре выберите "Утверждено" и откроется список всех ваших одобренных шаблонов.

Ниже на скриншоте приводим пример отправки шаблонного сообщения из Битрикс24.

Во время установки в Битрикс24, приложение "WhatsApp Business API Gupshup" автоматически создает нового SMS-провайдера "[WhatsApp Business API Gupshup]", только при этом отправляются не SMS, а сообщения в WhatsApp.

Отправка осуществляется как вручную, так и автоматически из любого места CRM: из роботов, бизнес-процессов, SMS и Мессенджер рассылок из раздела CRM-маркетинг, таймлайна Лидов, Сделок, Контактов и Компаний.

Приводим примеры отправки таких сообщений ниже на скриншотах.

Мы с нуля, полностью настроили популярный и востребованный для бизнеса канал WhatsApp через официальный WhatsApp Business API.

По сравнению с неофициальными ("серыми") API, основными преимуществами официального подключения являются:

• высокая стабильность и безопасность;
• независимость от физического оборудования (нет необходимости держать постоянно включенным мобильный телефон с подключением к интернету);
• независимость от веб-интерфейса сообщений (не нужно сканировать QR-код и передавать его сторонним приложениям);
• широкие возможности по интеграции с внешними системами для автоматизации обработки сообщений.

Также, подключение WhatsApp Business API через официального партнера Facebook — сервис Gupshup позволяет в несколько раз снизить затраты на данный канал по сравнению с другими поставщиками официального WhatsApp Business API. И даже часто получается выгоднее по сравнению с затратами на "серые" схемы подключения. К примеру многие подобные сервисы предлагают только пакеты сообщений или диалогов с ежемесячной оплатой. И еще огромный плюс, подключать через Gupshup можно неограниченное количество своих телефонных номеров для WhatsApp Business API, и это не влияет на стоимость.

Для примера рассчитаем расходы на подобный сервис с оплатой 1000 руб. в месяц в которые входят до 100 диалогов в месяц. Предположим, в среднем диалоги состоят из 10 сообщений (на практике бывает даже меньше, так как переписка с клиентом это чаще всего сжатый диалог из нескольких сообщений, а не переписка с другом). Получается в этом случае мы заплатим по факту 1000 руб. за 1000 сессионных сообщений (в рамках 24-часового окна), то есть в итоге 1 руб. за одно сообщение.

Теперь посчитаем сколько мы заплатим за 1000 сообщений в Gupshup. Одно сессионное сообщение стоит $0.001, это примерно 7–8 копеек. И нет никакой обязательной ежемесячной оплаты, и нет никаких ограничений по времени, по количеству диалогов и клиентов, по количеству каналов. Получается мы заплатим всего $1, то есть всего 70–80 руб. И при этом нас никто не ограничивает по времени, в этом месяце возможно 1000 сообщений, в другом меньше, в третьем больше. За год вырисовывается просто невероятная экономия затрат для бизнеса. За те же 1000 руб. мы сможем принять и отправить через Gupshup более 12000 сессионных сообщений без каких-либо ограничений по времени, по количеству диалогов и клиентов и без ограничения по количеству каналов. Многие бизнесы и не генерируют столько за месяц.

Чтобы иметь возможность написать по истечению 24 часов с момента последнего сообщения от клиента, необходимы специальные шаблоны, стоимость их отправки во всех сервисах почти одинаковая, так как эту стоимость взимает сам WhatsApp. Для России на текущий момент она составляет $0.0477 (~3–4 руб.) за одно шаблонное сообщение. При отправке такого шаблонного сообщения через Gupshup его стоимость составит $0.001 + $0.0477 (7–8 копеек за сессионное сообщение + 3–4 руб. за шаблонное сообщение). После ответа клиента на шаблонное сообщение, все остальные сообщения в течении 24 часов с момента отправки клиентом последнего сообщения будут тарифицироваться только по $0.001 (7–8 копеек).

*Соцсеть Facebook запрещена в РФ. 21.03.2022 компания Meta признана в России экстремистской организацией.

*Деятельность Meta Platforms Inc. (Facebook, Instagram) запрещена на территории Российской Федерации