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

В сервисе Make платформа Green-API имеет свое приложение.

Для его использования достаточно найти модуль GREEN-API for Whatsapp на странице сценария:

1. Откройте или создайте сценарий
2. Нажмите на +
3. Введите в поисковую строку GREEN-API

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

1. Настройка приложения GREEN-API
2. Создание сценария
3. Настройка получения входящих сообщений
4. Настройка действия
   • Доступные действия
   • Отправка сообщения
5. Примеры использования приложения GREEN-API

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

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

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

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

   
   

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

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

     

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

     

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

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

   

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

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

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

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

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

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

После создания сценария на странице Make появится знак плюс (добавление модуля).

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

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

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

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

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

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

• Выберите в начале списка триггер Watch webhooks

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

• Нажмите Create a webhook чтобы добавить вебхук

• Нажмите Create a connection чтобы добавить подключение к инстансу

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

Поле Connection name можно использовать для названия добавляемого инстанса (например "рабочий номер" или "продажи").
Это позволит вам легко найти нужную учётную запись в списке доступных при создании интеграций.

• Нажмите Save для сохранения значений

По умолчанию сценарий запускается при получении сообщения от любого написавшего номера.
Для запуска сценария при получении сообщения от определённого номера (или нескольких конкретных номеров), используйте параметр chatIds

chatIds

• Номер можно выбрать из списка контактов, нажав на значок выпадающего списка:

• Номер можно добавить вручную, введя его в поле ChatId:

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

Для добавления нескольких номеров, добавьте желаемое количество полей, нажав на Add item

• Нажмите Save, чтобы сохранить настройки

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

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

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

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

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

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

Доступные действия#

Все действия повторяют методы GREEN-API.

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

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

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

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

• Upload a File - загрузка файла в облачное хранилище.

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

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

• Send a Poll - отправка опроса.

• Forward Messages - пересылка сообщений в другой чат.

Отправка сообщения#

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

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

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

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

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

• В поле Chat ID source выберите удобный вам вариант внесения номера чата:

  • Вариант Manual - ввести номер вручную
  • Вариант From Contact List - выбрать номер из списка контактов
  

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

Автоматическое форматирование номера

Для номеров РФ, Казахстана* и Израиля доступно автоматическое форматирование номера.
Для включения выберите yes в параметре Number format и выберите Format Country.
Параметр автоматически добавляет к номеру телефона @c.us

*Номера Казахстана форматируются аналогично номерам РФ

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

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

  Номер форматируется автоматически.

• Для отправки ответа на номер, с которого поступило входящее сообщение, нажмите на поле ввода Chat Id.
  Справа откроется окно с данными, полученными через триггер.
  Укажите в качестве Chat Id переменную sender из объекта senderData.

  Номер форматируется автоматически.

Введите текст отправляемого сообщения в поле Message.
Можете указать в нём универсальный текст или сформировать его из переменных полученного в триггере уведомления.

Как в ответе процитировать входящее сообщение?

Для добавления цитирования в отправляемом сообщении заполните поле quotedMessageId, указав в него переменную ID Message

После нажмите OK.

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

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

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

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

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

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