Настройка интеграции Make и WhatsApp#

В сервисе Make платформа Green-API имеет свое приложение, с его помощью Вы сможете отправлять сообщения в WhatsApp.

Альтеранативные ссылки на приложение

Если при установке приложения по указанным ссылкам в Make возникает ошибка, рекомендуем указать в ссылке поддомен, в котором производилась авторизация на сайте.
От поддомена зависит доступность сайта по ссылке.
Примеры доступных доменов: eu1, eu2, us1, us2.

Чтобы воспользоваться приложением GREEN-API, нужно получить регистрационный токен и ID инстанса в личном кабинете. Для тестирования нашего API рекомендуем воспользоваться бесплатным тарифом разработчика.

Порядок настройки интеграции:

1. Настройка приложения Make
2. Настройка приложения GREEN-API
3. Создание сценария
4. Настройка получения входящих сообщений
   • New Message Webhook
   • Last Incoming Messages
   • Настройка триггера
5. Отправка сообщения пользователю
   • Действия
   • Настройка действия

1. Настройка приложения Make#

1. Войдите или зарегистрируйте учетную запись в Make
2. Установите приложение Green-API в Make по ссылке

3. Нажмите кнопку Install
   

   

4. Выберите организацию куда будет устанавливаться приложение Green-API и нажмите кнопку Install
   

   

5. На странице Installed Apps можете проверить доступность приложения в Вашей организации
   

   

2. Настройка приложения Green-API#

Чтобы воспользоваться приложением Green-API, нужно получить регистрационный токен и ID инстанса в личном кабинете. Для тестирования нашего API рекомендуем воспользоваться бесплатным тарифом разработчика (Developer).

1. Войдите или зарегистрируйте учетную запись в GREEN-API

2. Создайте инстанс на бесплатном тарифе "Developer". Для этого в личном кабинете нажмите кнопку Создать инстанс и выберите тариф
   

   
   

3. Авторизуйте инстанс. Для этого:

   • Можно отсканировать QR-код на странице настройки инстанса.
     В мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и отсканируйте полученный QR-код.
     

     

   • Или запросить шестизначный код авторизации для привязки по номеру телефона.
     В мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и нажмите Связать по номеру телефона.
     

     

   После успешной авторизации, инстанс должен получить статус Авторизован.
   Проверить статус инстанса вы можете используя метод GetStateInstance

4. Скопируйте значения idInstance и apiTokenInstance для работы со сценариями Make
   

   

3. Создание сценария#

Scenario (сценарий) - автоматизированный процесс, создаваемый в Make. Каждый сценарии состоит из триггера и действия. При срабатывании триггера в одном из приложений Make автоматически выполняет действие в другом.

Алгоритм создания сценария:

• Войдите или зарегистрируйте учетную запись в Make
• В боковом меню нажмите кнопку Scenarios

• На странице сценариев нажмите Create a new scenario, чтобы создать новый сценарий

Сценарий успешно создан!

4. Настройка получения входящих сообщений#

Для получения сообщении в Make требуется настроить триггер.

Триггер - это событие, которое запускает ваш сценарий. Например, это может быть новое сообщение в WhatsApp, новая запись в Google Sheets, или что-то ещё.

Для получения сообщении в приложении GREEN-API реализованы два вида триггера:

• New Message Webhook

• Last Incoming Messages

Выберите триггер, который соответствует вашим потребностям.

New Message Webhook#

New Message Webhook - триггер срабатывает на получение нового входящего сообщения в WhatsApp. Триггер основан на веб-хуках.

Плюсы:
+ Минимальное время срабатывания триггера
+ Более подробная информация о входящем сообщении

Минусы:
- Триггер можно использовать только для одной интеграции на один инстанс Green-api
- Если настройки инстанса поменять вручную, триггер может реагировать и на другие уведомления кроме входящих сообщении

"webhookUrl": "вебхуксервер make",
"incomingWebhook": "yes"

Last Incoming Messages#

Last Incoming Messages - триггер срабатывает на получение нового входящего сообщения в WhatsApp. Триггер основан на методе lastIncomingMessages.

Плюсы:
+ Можно использовать этот триггер для разных интеграций на один инстанс Green-api
+ Триггер реагирует только на входящие сообщения

Минусы:
- Время срабатывания триггера складывается из времени добавления сообщения в журнал и частоты запроса метода сервисом Make (зависит от типа учетной записи Make)

"incomingWebhook": "yes"

Настройка триггера#

Порядок настройки триггера:

• Создайте новый сценарий
• Нажмите на знак плюс, в списке приложении найдите GREEN-API

• Выберите один из методов получения сообщении

• Нажмите add чтобы добавить адрес, с которого будут приходить вебхуки.

• На окне Create a webhook нажмите add чтобы добавить подключение.

• Вставьте значения Вашего инстанса idInstance и apiTokenInstance (Получение сообщений будет вестись с номера привязанного к этому инстансу)

• В окне Create a connection нажмите Save, чтобы сохранить
• Соединение с добавленным инстансом будет успешным, если Make отобразит ваш номер в формате phoneNumber@c.us в списке "Connection" (подключении).

• Чтобы триггер реагировал на сообщения любого контакта или чата в поле "Only From Specify Chat" выберите вариант No.

Определенный контакт

Чтобы триггер реагировал на сообщения от определенного контакта в поле "Only From Specify Chat" выберите вариант Yes.

• Выберите вариант Manual, чтобы ввести номер вручную:

При заполнении номера вручную, требуется вводить в формате phoneNumber@c.us. Например: 0100123456789@c.us.

phoneNumber — полный номер телефона в международном формате. Не используйте плюс, нули, скобки или дефисы при вводе номера телефона в международном формате..

• Выберите вариант From Contact List, чтобы выбрать номер из списка контактов:

• В окне Create a webhook нажмите Save, чтобы сохранить. После нажмите OK

• Сделайте тест, нажав кнопку Run once. Если в выбранном чате есть входящие сообщения, и тест успешен, нажмите на лупу, чтобы увидеть какие поля будут доступны при настройке действия.

Готово! Триггер настроен, готов к использованию!

5. Отправка сообщения пользователю#

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

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

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

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

Действия#

Все действия повторяют методы GREEN-API, подробнее о методах GREEN-API можно прочитать в документации.

Методы отправки сообщения:

• Send Message - отправка текстового сообщения.

• Send Contact - отправка карточки контакта.

• Send File by Url - отправка файла по URL.

• Send Location Message - отправка геопозиции.

Настройка действия#

Порядок настройки действия:

• Чтобы добавить действие нажмите на полукруг рядом с триггером. После появится пустой серый круг со знаком плюс (добавление приложения).

• Выберите приложение для исполнения действия, для этого в списке приложении найдите GREEN-API.
  

  

• Выберите один из методов отправки сообщения. Например, метод SendMessage

  

• Из списка Connection выберите готовое подключение или добавьте подключение, нажав кнопку add.

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

• В поле Chat ID source выберите удобный вам вариант внесения номера чата. Вариант Manual - введение номера вручную. Вариант From Contact List - выбирать номер из списка контактов.

• Поле Chat Id заполните вручную или выберите из списка контактов. При заполнении вручную номер надо вводить в формате phoneNumber@c.us. Поле Message сформируйте из полей триггера, которую запустили во время теста. После нажмите OK.

• Сделайте тест, нажав кнопку Run once. Если тест успешен, нажмите на лупу, чтобы увидеть детали результата действия.

Готово! Действие настроено, готово к использованию!

Примеры использования приложения GREEN-API#

Как сделать обмен сообщениями между WhatsApp и Slack

Как сделать обмен сообщениями между WhatsApp и Discord

Как использовать Google Sheets для организации рассылок в Make