Настройка интеграции#
Zapier - это инструмент, который позволяет автоматизировать задачи, подключая веб-приложения (такие, как Discord, Slack, Gmail). Автоматизированные процессы, создаваемые в Zapier, называются Zaps (запами).
Zap (зап) - автоматизированный процесс, создаваемый в Zapier. Каждый зап состоит из триггера и действия. При срабатывании триггера в одном из приложений Zapier автоматически выполняет действие в другом.
В сервисе Zapier платформа Green-API имеет свое приложение, с его помощью Вы сможете отправлять сообщения в WhatsApp
Чтобы воспользоваться приложением Green API, нужно получить регистрационный токен и ID аккаунта в личном кабинете. Для тестирования нашего API рекомендуем воспользоваться бесплатным тарифом разработчика.
Авторизация#
Чтобы отправлять сообщения в WhatsApp необходимо авторизовать инстанс, аккаунт WhatsApp в приложении телефона должен быть в авторизованном состоянии, перейдите в личный кабинет и получите QR-код, в мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и отсканируйте полученный QR-код, инстанс перейдет в авторизованное состояние.
Описание методов приложения GREEN API#
Триггеры#
Incoming Message Hook Trigger - триггер срабатывает на получение нового входящего сообщения в WhatsApp. Триггер основан на веб-хуках. Время срабатывания триггера минимальное, но есть техническое ограничение, можно использовать этот триггер только для одной интеграции на один инстанс green-api.
Last Incoming Messages - триггер срабатывает на получение нового входящего сообщения в WhatsApp. Триггер основан на методе lastIncomingMessages. Время срабатывания триггера складывается из времени добавления сообщения в журнал и частоты запроса метода сервисом zapier (зависит от типа учетной записи zapier). Можно использовать этот триггер для разных интеграций на один инстанс green-api.
Настройка инстанса
- При использовании триггера Incoming Message Hook Trigger автоматически устанавливается настройка инстанса:
"webhookUrl": "вебхуксервер zapier",
"incomingWebhook": "yes"
- При использовании триггера Last Incoming Messages автоматически устанавливается настройка инстанса:
"incomingWebhook": "yes"
Настройка триггера#
Оба триггера реагируют на входящие сообщения WhatsApp для инстанса Green API. Триггеры настраиваются одним и тем же образом, при добавлении триггера вам необходимо выбрать получателя, на чьи сообщения должен срабатывать триггер или выбрать вариант ALL (оставить поле пустым) - тогда триггер будет реагировать на сообщения от любого контакта или чата.
Выбрать получателя можно либо из выпадающего списка контактов:
Действия#
Все действия повторяют методы Green API, подробнее о методах Green API можно прочитать в документации.
Send Message - отправка текстового сообщения.
Send Contact - отправка карточки контакта.
Send File by Url - отправка файла по URL.
Send Location - отправка геопозиции.
Настройка приложения Green API#
- Добавьте данные Вашего инстанса IdInstance и ApiTokenInstance (отправка и получение сообщений будет вестись с номера привязанного к этому инстансу).
Поле Short name of this account
Поле Short name of this account - можно использовать для названия добавляемого инстанса (например "рабочий номер", или "продажи").
Это позволит вам легко найти нужную вам учетную запись в списке доступных при создании интеграций.
Узнать IdInstance и ApiTokenInstance можно в личном кабинете. Убедитесь что инстанс находится в состоянии "Authorized".
- Проверьте соединение с добавленным инстансом
Если все сделано верно и Ваш инстанс авторизован, тест пройдет успешно
Теперь можно переходить к реализации Ваших сценариев автоматизации.