Как подключить официальный WhatsApp бизнес API через Gupshup и интегрировать с Битрикс24

WhatsApp Business API
WhatsApp Business API

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

Отличительные особенности сервиса Gupshup

Сервис Gupshup
Сервис Gupshup
  • Можно подключать любые свои существующие номера телефонов (мобильные, стационарные, виртуальные). Количество подключаемых телефонных номеров не ограничено и не влияет на стоимость. То есть, можно организовать неограниченное количество каналов.
  • Нет ежемесячной абонентской платы и платы за подключение. В рамках 24 часового сессионного окна оплачиваются только сессионные входящие и исходящие сообщения по цене $0.001 (~7–8 коп.) за одно сообщение. Пополнение баланса сервиса от $10 любой банковской картой. Время использования средств на балансе не ограничено. Нет ограничений по количеству диалогов и клиентов.
  • Для возможности написать пользователю по истечению 24 часов с момента последнего сообщения от него, можно подготовить специальные шаблоны и получить их одобрение со стороны WhatsApp. Общая стоимость отправки шаблонного сообщения составит $0.001 (~7–8 коп.) + стоимость сообщения по тарифам WhatsApp (для России $0.0477 (~3–4 руб.)).
  • При регистрации в сервисе, на баланс бесплатно зачисляется $1. Эти деньги можно расходовать на полноценное использование сервиса в начале работы. Если к примеру отправлять и получать только сессионные сообщения, то хватит на 1000 сообщений. Время использования пробного баланса не ограничено.

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

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

1. Создание аккаунта в Facebook Business Manager

Если у Вас уже есть аккаунт в Facebook Business Manager, то пропустите этот пункт и переходите к следующему.

Войдем в свой личный аккаунт в Facebook и создадим аккаунт Business Manager, для чего перейдем по ссылке https://business.facebook.com/overview и нажмем кнопку “СОЗДАТЬ АККАУНТ”, откроется окно для ввода данных компании.

Создание аккаунта Business Manager в Facebook
Создание аккаунта Business Manager в Facebook

Согласно подсказкам над полями, вводим название компании, имя и фамилию, e-mail и нажимаем кнопку “Отправить”.

В следующем окне введем информацию о компании и нажмем кнопку “Отправить”.

Добавление информации о компании при создании аккаунта в Facebook Business Manager
Добавление информации о компании при создании аккаунта в Facebook Business Manager

После отправки появится сообщение, что аккаунт создан и необходимо подтвердить адрес электронной почты.

Необходимость подтверждения адреса электронной почты при создании аккаунта в Facebook Business Manager
Необходимость подтверждения адреса электронной почты при создании аккаунта в Facebook Business Manager

Зайдем в почту и нажмем на кнопку “Подтвердить” из письма.

Подтверждение адреса электронной почты при создании аккаунта в Facebook Business Manager
Подтверждение адреса электронной почты при создании аккаунта в Facebook Business Manager

2. Активация кнопки “Начать подтверждение” в Facebook Business Manager

Если у Вас эта кнопка уже активна или ваша компания уже подтверждена в Facebook Business Manager, то пропустите этот пункт и переходите к следующему.

По умолчанию, кнопка для начала подтверждения компании в Facebook Business Manager не активна. Для того, чтобы её сделать активной, нужно произвести описанные ниже действия.

Залогиньтесь в https://developers.facebook.com. Для этого нажмите в верхнем меню на пункт “Начало работы”.

Нажмите в верхнем меню на пункт “Начало работы”
Нажмите в верхнем меню на пункт “Начало работы”

В следующем окне нажмите кнопку “Продолжить”.

Нажмите кнопку “Продолжить”
Нажмите кнопку “Продолжить”

В следующем окне поставьте галочку и нажмите кнопку “Подтвердить электронный адрес”.

Нажмите кнопку “Подтвердить электронный адрес”
Нажмите кнопку “Подтвердить электронный адрес”

В следующем окне выберите “Разработчик” и нажмите кнопку “Завершить регистрацию”.

Нажмите кнопку “Завершить регистрацию”
Нажмите кнопку “Завершить регистрацию”

В следующем окне нажмите кнопку “Создать приложение”.

Нажмите кнопку “Создать приложение”
Нажмите кнопку “Создать приложение”

В следующем окне выберите “Управление бизнес-интеграциями” и нажмите кнопку “Продолжить”.

Нажмите кнопку “Продолжить”
Нажмите кнопку “Продолжить”

В следующем окне введите любое “Отображаемое название приложения”, выберите “Назначение приложения” — “Вы или принадлежащая вам компания”, выберите ваш “Аккаунт Business Manager” и нажмите кнопку “Создание приложения”.

Нажмите кнопку “Создание приложения”
Нажмите кнопку “Создание приложения”

3. Подтверждение компании в Facebook Business Manager

Если ваша компания уже подтверждена в Facebook Business Manager, то пропустите этот пункт и переходите к следующему.

Перейдите в раздел “Центр безопасности” по ссылке https://business.facebook.com/settings/security. Кнопка “Начать подтверждение” стала активной. Нажмите ее для начала подтверждения.

Нажмите кнопку “Начать подтверждение”
Нажмите кнопку “Начать подтверждение”

С официальной информацией от Facebook о подтверждении компании можно ознакомиться по ссылке: https://www.facebook.com/business/help/2058515294227817?id=180505742745347.

На первом шаге подтверждения введем данные нашей компании:

Юридическое название компании — название компании, как в указано в документах на регистрацию компании.

Страна — страна регистрации компании.

Адрес (улица, № дома) — улица и номер дома юридического адреса компании, как в указано в документах на регистрацию компании.

Адрес 2/Населенный пункт — вводим, если имеется.

Город — город юридического адреса компании, как в указано в документах на регистрацию компании.

Штат/провинция/регион — регион юридического адреса компании, как в указано в документах на регистрацию компании.

Почтовый индекс — почтовый индекс юридического адреса компании, как в указано в документах на регистрацию компании.

Номер телефона компании — номер телефона, который принадлежит данному юридическому лицу (должны быть подтверждающие документы: договор, счета на оплату за телефон и т.п.).

Сайт — адрес веб-сайта компании (домен сайта должен совпадать с доменом электронного адреса компании).

Подтверждение компании в Facebook Business Manager. Шаг 1 — ввод данных компании.
Подтверждение компании в Facebook Business Manager. Шаг 1 — ввод данных компании.

На втором шаге подтверждения компании необходимо подтвердить юридическое название компании.

Для этого нужно загрузить документы из списка:

  • Лицензия на ведение коммерческой деятельности (если имеется);
  • Свидетельства о регистрации или учредительные договоры (ОГРН или учредительный договор);
  • Свидетельство о регистрации налогоплательщика (ИНН).

Мы, когда это делали для себя, загружали сканы ОГРН и ИНН компании.

Подтверждение компании в Facebook Business Manager. Шаг 2 — подтверждение юридического названия компании.
Подтверждение компании в Facebook Business Manager. Шаг 2 — подтверждение юридического названия компании.

На третьем шаге подтверждения компании необходимо подтвердить юридический адрес и номер телефона компании.

Для этого нужно загрузить документы из списка:

  • Счет за коммунальные услуги, например электроэнергию или телефон;
  • Справка из банка, на которой указан адрес;
  • Лицензия на ведение коммерческой деятельности с адресом или телефоном компании (если имеется).

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

Подтверждение компании в Facebook Business Manager. Шаг 3 — подтверждение юридического адреса и номера телефона компании.
Подтверждение компании в Facebook Business Manager. Шаг 3 — подтверждение юридического адреса и номера телефона компании.

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

Для этого нужно в разделе “Выберите, как с вами связаться” выбрать телефон и нажать кнопку “Позвоните мне”. Поле “Мой рабочий электронный адрес” оставляем пустым.

Подтверждение компании в Facebook Business Manager. Шаг 4 — получение кода подтверждения по телефону.
Подтверждение компании в Facebook Business Manager. Шаг 4 — получение кода подтверждения по телефону.

Позвонит робот и продиктует цифры, которые нужно ввести в поле ввода кода подтверждения.

Вводим цифры кода подтверждения и нажимаем кнопку “Отправить”.

Ждем подтверждения от Facebook, это может занять 2–7 рабочих дней.

Мы получили подтверждение компании от Facebook в течении 1-го рабочего дня.

Письмо от Facebook с уведомлением, что компания успешно подтверждена.
Письмо от Facebook с уведомлением, что компания успешно подтверждена.
Сообщение в Facebook Business Manager, что компания успешно подтверждена.
Сообщение в Facebook Business Manager, что компания успешно подтверждена.
Зеленая иконка в Центре безопасности в Facebook Business Manager, что компания подтверждена.
Зеленая иконка в Центре безопасности в Facebook Business Manager, что компания подтверждена.
Зеленая галочка в Информации о компании в Facebook Business Manager, что компания подтверждена.
Зеленая галочка в Информации о компании в Facebook Business Manager, что компания подтверждена.

4. Создание аккаунта в Gupshup и подключение своего телефонного номера к WhatsApp Business API

Чтобы создать аккаунт в Gupshup, достаточно просто войти в этот сервис через любой из ваших существующих аккаунтов в Google, Facebook или GitHub на странице https://www.gupshup.io/developer/whatsapp-api.

Залогиньтесь через любой из ваших существующих аккаунтов в Google, Facebook или GitHub
Залогиньтесь через любой из ваших существующих аккаунтов в Google, Facebook или GitHub

Сразу после входа, откроется Дашборд WhatsApp. Нажимаем там на кнопку “Создайте ваше первое приложение”.

Нажмите на кнопку “Создайте ваше первое приложение”
Нажмите на кнопку “Создайте ваше первое приложение”

Далее нажимаем на кнопку “API доступа”.

Нажите на кнопку “API доступа”
Нажите на кнопку “API доступа”

Вводим любое свободное имя приложения, например “TestApp555” и нажимаем кнопку “Отправить”.

Как подключить официальный WhatsApp бизнес API через Gupshup и интегрировать с Битрикс24
Нажмите на кнопку “Отправить”
Нажмите на кнопку “Отправить”

Откроется длинная страница, прокручиваем ее мышкой вниз и нажимаем внизу кнопку “Следующее”.

Нажмите на кнопку “Следующее”
Нажмите на кнопку “Следующее”

Далее ниже появится кнопка “Перейти в дашборд” нажимаем ее для перехода туда.

Нажмите на кнопку “Перейти в дашборд”
Нажмите на кнопку “Перейти в дашборд”

В дашборде https://www.gupshup.io/whatsapp/dashboard нажимаем на кнопку “Стать онлайн” в созданном приложении.

Нажмите на кнопку “Стать онлайн”
Нажмите на кнопку “Стать онлайн”

На следующем экране нажимаем на кнопку “Я готов(а)”.

Нажмите на кнопку “Я готов(а)”
Нажмите на кнопку “Я готов(а)”

На следующем экране выбираем свою страну из списка.

Выберите свою страну из списка
Выберите свою страну из списка

Затем прокручиваем фрейм вниз и нажимаем на кнопку “Следующее”.

Нажмите на кнопку “Следующее”
Нажмите на кнопку “Следующее”

На следующем экране заполняем форму данными о вашей компании согласно информации о вашей компании из Facebook Business Manager https://business.facebook.com/settings/info и нажимаем на кнопку “Следующее”.

Заполните форму и нажмите на кнопку “Следующее”
Заполните форму и нажмите на кнопку “Следующее”

На введеный в форму электронный адрес придет письмо от Gupshup с кнопкой для его подтверждения. Подтвердим этот email нажав кнопку “Verify Now” в тексте письма.

В письме нажмите на кнопку “Verify Now”
В письме нажмите на кнопку “Verify Now”

После успешного подтверждения откроется окно “Email Verification Complete”

Откроется окно “Email Verification Complete”
Откроется окно “Email Verification Complete”

и придет письмо, что email успешно верифицирован.

Письмо, что email успешно верифицирован
Письмо, что email успешно верифицирован

Возвращаемся к окну с формой в Gupshup. Проверяем всю введенную информацию и нажимаем кнопку “Подтвердить”.

Проверьте всю введенную информацию и нажмите кнопку “Подтвердить”
Проверьте всю введенную информацию и нажмите кнопку “Подтвердить”

На следующем экране вводим ID вашей верифицированной компании в Facebook Business Manager, который скопируем на странице https://business.facebook.com/settings/info, и нажимаем кнопку “Сохранить”.

Введите ID вашей верифицированной компании в Facebook Business Manager
Введите ID вашей верифицированной компании в Facebook Business Manager
Нажмите на кнопку “Сохранить”
Нажмите на кнопку “Сохранить”

Если ваша компания еще не верифицирована, то появится ошибка: “The Facebook Business Manager ID does not seem to be verified. Please try again with a verified ID.”

Если ошибка: “The Facebook Business Manager ID does not seem to be verified. Please try again with a verified ID.”
Если ошибка: “The Facebook Business Manager ID does not seem to be verified. Please try again with a verified ID.”

Если это так, то нужно будет сначала пройти верификацию вашей компании в Facebook Business Manager, и потом вернуться к данному шагу. Этот процесс подробно описан в 1–3 пунктах данной инструкции.

Если все в порядке и ваша компания подтверждена, то откроется следующий экран, где мы вводим свой номер телефона, который хотим использовать для WhatsApp Business API. Обязательно перед этим изучаем правила Facebook по выбору такого телефонного номера по ссылке http://developers.facebook.com/docs/whatsapp/guides/phone-number.

Выбираем код страны и вводим номер телефона, нажимаем кнопку “Сохранить”.

Выберите код страны, введите номер телефона и нажмите кнопку “Сохранить”
Выберите код страны, введите номер телефона и нажмите кнопку “Сохранить”

Далее вводим отображаемое имя вашей компании в WhatsApp. Обязательно перед этим изучаем правила Facebook по выбору отображаемого имени по ссылке https://developers.facebook.com/docs/whatsapp/guides/display-name.

Вводим отображаемое имя и нажимаем кнопку “Сохранить”.

Введите отображаемое имя и нажмите на кнопку “Сохранить”
Введите отображаемое имя и нажмите на кнопку “Сохранить”

Далее, нужно будет подтвердить на вашей странице в Facebook Business Manager привязку к Gupshup, для этого в новой вкладке браузера переходим по ссылке https://business.facebook.com/settings/requests или в Facebook Business Manager в меню слева выбираем пункт “Запросы”. Во вкладке “Полученные” будет полученный от Gupshup запрос, нажимаем на кнопку “Одобрить”.

Нажмите на кнопку “Одобрить”
Нажмите на кнопку “Одобрить”

Возвращаемся к окну Gupshup и нажимаем кнопку “Одобрил”.

Нажмите на кнопку “Одобрил”
Нажмите на кнопку “Одобрил”

Откроется окно с информацией о том, что Ваш запрос отправлен и ожидается его одобрение со стороны WhatsApp. Сообщается, что это займет от 2 до 7 рабочих дней. Часто все происходит быстрее, и возможно Вы получите ответ на ваш email уже в течении суток. Нажимаем на кнопку “Перейти в Дашборд”.

Нажмите на кнопку “Перейти в Дашборд”
Нажмите на кнопку “Перейти в Дашборд”

Откроется основная страница Дашборда и в списке приложений в синей кнопке мы увидим текущий статус “Ожидание подтверждения”.

Текущий статус “Ожидание подтверждения”
Текущий статус “Ожидание подтверждения”

После подтверждения, получим на email соответствующее письмо от Gupshup и статус в синей кнопке изменится на “Завершить верификацию”.

Далее нужно будет подтвердить ваш номер телефона с помощью SMS или голосового вызова. Для этого нажимаем на кнопку “Завершить верификацию”.

Нажмите на кнопку “Завершить верификацию”
Нажмите на кнопку “Завершить верификацию”

В открывшемся окне нажимаем на кнопку “Запросить код по СМС”, если номер телефона мобильный, или “Запросить код через голосовой вызов”, если номер телефона не мобильный.

Нажмите на кнопку “Запросить код по СМС”, если номер телефона мобильный, или “Запросить код через голосовой вызов”, если номер телефона не мобильный.
Нажмите на кнопку “Запросить код по СМС”, если номер телефона мобильный, или “Запросить код через голосовой вызов”, если номер телефона не мобильный.

Ждем автоматического обновления экрана и отправки кода подтверждения на ваш номер.

Ожидание отправки кода подтверждения
Ожидание отправки кода подтверждения
Ожидание отправки кода подтверждения
Ожидание отправки кода подтверждения

После отправки кода на ваш номер, автоматически откроется следующий экран, где мы вводим полученный код и нажимаем кнопку “Отправить”.

Введите код подтверждения и нажмите на кнопку “Отправить”
Введите код подтверждения и нажмите на кнопку “Отправить”

После успешной отправки откроется следующее окно с сообщением, что данные вашей учетной записи одобрены и верификация пройдена успешно. Нажимаем на кнопку “Перейти в Дашборд”.

Нажмите на кнопку “Перейти в Дашборд”
Нажмите на кнопку “Перейти в Дашборд”

Откроется основная страница Дашборда и в списке приложений мы увидим текущий зеленый статус “LIVE”. Теперь можно использовать ваш номер телефона в WhatsApp Business API.

Также можем настроить профиль вашей компании в WhatsApp, например загрузить изображение профиля и внести другую информацию о вашей компании. Для этого переходим по ссылке “Настройки профиля” в списке приложений для редактирования профиля.

Перейдите по ссылке “Настройки профиля”
Перейдите по ссылке “Настройки профиля”

Откроется окно для редактирования профиля, вводим там всю нужную информацию.

Введите данные профиля и нажмите на кнопку “Сохранить изменения”
Введите данные профиля и нажмите на кнопку “Сохранить изменения”

После ввода данных профиля, нажимаем на кнопку “Сохранить изменения”.

5. Подключение WhatsApp Business API Gupshup к Битрикс24

Для того, чтобы начать получать и отправлять сообщения через ваш подключенный номер телефона к 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, в том же самом всплывающем окне, которое появилось после нажатия зеленой кнопки “УСТАНОВИТЬ”, выбираем из списка ваш портал Битрикс24.

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

Нажмите на кнопку “УСТАНОВИТЬ”
Нажмите на кнопку “УСТАНОВИТЬ”

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

Установите галочки и нажмите на кнопку “УСТАНОВИТЬ”
Установите галочки и нажмите на кнопку “УСТАНОВИТЬ”

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

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

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

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

Как подключить официальный WhatsApp бизнес API через Gupshup и интегрировать с Битрикс24

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

Нажмите на кнопку “ПОДКЛЮЧИТЬ”
Нажмите на кнопку “ПОДКЛЮЧИТЬ”

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

Выберите нужную Открытую линию из списка
Выберите нужную Открытую линию из списка

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

Интерфейс настроек коннектора
Интерфейс настроек коннектора

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

Скопируйте API Key
Скопируйте API Key

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

Введите Gupshup API key
Введите Gupshup API key

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

Перейдите по ссылке “Настройки”
Перейдите по ссылке “Настройки”

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

Скопируйте телефонный номер из поля “Отправитель”
Скопируйте телефонный номер из поля “Отправитель”

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

Введите скопированный номер телефона в поле “Gupshup sender”
Введите скопированный номер телефона в поле “Gupshup sender”

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

Нажмите на кнопку “Копировать”
Нажмите на кнопку “Копировать”

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

Переключите ползунок в положение “ON”
Переключите ползунок в положение “ON”

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

Введите скопированный в настройках коннектора в Битрикс24 “Gupshup callback URL” и нажмите кнопку “Set”
Введите скопированный в настройках коннектора в Битрикс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.

Отправьте сообщение в WhatsApp
Отправьте сообщение в WhatsApp

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

Примите сообщение в Открытой линии Битрикс24
Примите сообщение в Открытой линии Битрикс24

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

6. Создание шаблонов исходящих сообщений

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

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

Перейдите по ссылке “Настройки”
Перейдите по ссылке “Настройки”

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

Перейдите по ссылке “Посмотреть шаблоны”
Перейдите по ссылке “Посмотреть шаблоны”

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

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

Нажмите на кнопку “Добавить еще”
Нажмите на кнопку “Добавить еще”

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

Заполните все необходимые поля и нажмите кнопку “Предварительный просмотр и отправка”
Заполните все необходимые поля и нажмите кнопку “Предварительный просмотр и отправка”

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

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

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

В фильтре выберите “Утверждено” и откроется список всех ваших одобренных шаблонов
В фильтре выберите “Утверждено” и откроется список всех ваших одобренных шаблонов

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

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

7. Отправка автоматических сообщений в WhatsApp из Битрикс24

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

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

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

Отправка сообщения из таймлайна сделки
Отправка сообщения из таймлайна сделки
Отправка сообщения из бизнес-процесса
Отправка сообщения из бизнес-процесса
Отправка сообщения из роботов CRM
Отправка сообщения из роботов CRM
Список отправленных сообщений в истории сделки
Список отправленных сообщений в истории сделки
Отправка сообщения из SMS рассылки
Отправка сообщения из SMS рассылки
Отправка сообщения из Мессенджер рассылки
Отправка сообщения из Мессенджер рассылки

Итог

Мы с нуля, полностью настроили популярный и востребованный для бизнеса канал 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 копеек).

66
19 комментариев

Спасибо большое за подробную инструкцию! Это круто, что есть люди, которые не жалеют своего времени и делают жизнь других проще))

1
Ответить
Комментарий удалён модератором

Дарья, спасибо большое за теплые слова!  :-)

Ответить

Комментарий недоступен

1
Ответить

Да, Илья, на практике все очень выгодно получается)

Ответить

Я правильно понимаю, что сервис, который для своей работы хочет юрлицо с кучей сопутствующих документов, принимает оплаты только с банковских карт? А смысл? Если я юрлицо, я хочу работать по договору, оплачивать услуги по счету и получать закрывающие документы. В противном случае мне не важно какой там api, это все равно левая шарага.

Ответить

Вячеслав, мы связались с представительством Gupshup в России, и нам ответили, что в этом году они планируют организовать оплату по счету с закрывающими документами.

1
Ответить