1. Главная
  2. Помощь
  3. Использование сервиса
  4. Интеграции Notify.Events
  5. Интеграция Green API (WhatsApp API)
Помощь

Интеграция Green API (WhatsApp API)

Интеграция Green API дает возможность подписать на канал в качестве получателей пользователей WhatsApp. Вы сможете направлять коллегам и клиентам текстовые уведомления, изображения, ссылки и файлы из нужных источников через стабильный шлюз WhatsApp API.

Сообщения подписчикам будут поступать от лица вашего аккаунта WhatsApp, привязанного к Green API. Это позволит расширить возможности: например, брендировать уведомления и адаптировать сервис под нужды бизнеса.

Интеграция предназначена для отправки уведомлений на номера телефона, отличные от номера-отправителя, подключенного к Green API. Если вы настроите отправку на исходный номер (=самому себе), сообщения по-прежнему будут доставляться в WhatsApp, но без оповещения о новых сообщениях в чате. WhatsApp будет автоматически помечать такие сообщения прочитанными, так как номер отправителя и номер получателя совпадают.

Посмотреть подробную инструкцию, как настроить аккаунт Green API для уведомлений WhatsApp >>

Но чтобы все заработало, вам необходимо предварительно настроить интеграцию и разрешить подписку в свойствах нужного канала.

Если хотя бы один из этих пунктов не был настроен, на этапе подписки на канал вы увидите такое сообщение:

0 Настройка интеграции - интеграция не настроена.png

Шаг 1. Настройка интеграции

  1. Перейдите на экран Интеграции. Это можно сделать через выпадающее меню в верхнем правом углу экрана. Перед этим убедитесь, что вы залогинены в системе.
    2. 1. Интеграция.png
  2. Нажмите на кнопку Создать.
    3. 2. Создание интеграции.png
  3. Кликните по карточке Green API.
    4. 3. Выбор Green API.png
  4. При необходимости отредактируйте название интеграции, выберите API Version в зависимости от вашего тарифа в Green API: Base – для тарифов Разработчик Free и Бизнес, v1 – для тарифа ЧатБот).
  5. Заполните IdInstance и ApiTokenInstance данными вашего инстанса Green API.
  6. Поставьте галочку напротив Allow subscription over contact list, если хотите, чтобы на этапе подписки (Шаг 3) Notify.Events автоматически подгружал список ваших контактов WhatsApp, включая группы.
    7. 4. Настройка интеграции Green AP.png

    Чтобы посмотреть данные инстанса Green API, в вашей консоли Green API перейдите в Инстансы и провалитесь в нужный инстанс.

    5. Инстанс Green API.png

    Узнайте, как создать аккаунт Green API для отправки уведомлений в WhatsApp >>

  7. После нажатия на кнопку Сохранить созданная интеграция появится на экране Интеграции.
6. Готовая интеграция Green API.png

Шаг 2. Разрешение подписки

  1. Перейдите в свойства канала через кнопку Редактировать на главном экране Панели управления или на экране канала.
    2. 7. Редактирование канала.png
  2. Поставьте галочку напротив Green API в поле Разрешить подписку через интеграцию и нажмите кнопку Сохранить. Green API будет отображаться в этом поле только после успешного выполнения Шага 1.
8. Разрешение подписки через интеграцию Green API.png

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

Шаг 3. Добавление кастомной интеграции на канал

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

Для этого:

  1. На экране канала нажмите кнопку Подписаться в разделе Получатели.
    2. 9. Подписка на канал.png
  2. На экране Подписка на канал выберите Green API.
    3. 10. Подписка Green API.png
  3. Введите номер, на который необходимо отправлять уведомления, или выберите контакт / группу WhatsApp из списка (будет активно, если вы разрешили это действие в настройках интеграции Green API) и нажмите Подписаться. Чтобы добавить больше номеров, повторите предыдущие действия.
11. Добавление номера Green API.png

Готово! Теперь подписка появится в разделе Получатели на экране канала, и уведомления из ваших сервисов-источников начнут поступать подключенным пользователям WhatsApp.

12. Подписка Green API на канале.png

Настройка Green API для уведомлений WhatsApp

Как создать аккаунт Green API?

  1. Зарегистрируйтесь на сайте Green API.
    2. 1. Регистрация в Green API.png
  2. Создайте новый инстанс через кнопку Создать инстанс в правом верхнем углу консоли.
    3. 2. Создание нового инстанса в Green API.png
  3. Выберите подходящий тариф.
    4. 3. Выбор тарифа Green API.png
  4. После создания, вы автоматически попадете в карточку нового инстанса. Здесь вы найдете данные для настройки интеграции в Notify.Events: IdInstance и ApiTokenInstance.
4. Созданный инстанс Green API.png

Как привязать WhatsApp к Green API?

Для того чтобы инстанс заработал, нужно связать Green API с WhatsApp. Пока вы это не сделаете, статус инстанса будет отображаться как “Неавторизован”.

  1. Прокрутите экран инстанса ниже и нажмите кнопку Получить QR.
    2. 5. Авторизация инстанса Green API.png
  2. Отсканируйте сгенерированный QR-код через WhatsApp на вашем смартфоне: Настройки > Связанные устройства > Привязка устройства.
  3. Теперь статус инстанса изменится на “Авторизован” и связка с WhatsApp начнет работать.

Вы можете изменить настройки инстанса на том же экране с помощью кнопки Изменить.

Поздравляем, вы успешно подключили Green API! Теперь вы можете вернуться наверх к инструкции и настроить интеграцию для отправки уведомлений в WhatsApp.