Green API для WhatsApp?

GREEN-API: это шлюз WhatsApp API от стороннего разработчика. Он подключается к обычному аккаунту WhatsApp или WhatsApp Business и позволяет вашему коду отправлять и получать сообщения, файлы и уведомления.

С помощью GREEN-API подключают WhatsApp к CRM-системам, техподдержке, чат-ботам и no-code сценариям. Официальная платформа WhatsApp Business от Meta для этого не нужна.

Коротко: GREEN-API превращает один аккаунт WhatsApp в программируемый шлюз, который называется инстансом. Вы авторизуете инстанс по QR-коду или по коду привязки, а затем вызываете HTTP-методы или принимаете вебхуки. Один инстанс обслуживает один номер, поэтому для каждого нового аккаунта нужен отдельный инстанс и отдельный номер.

Как работает GREEN-API

В основе сервиса лежит инстанс: уникальный шлюз, привязанный ровно к одному аккаунту WhatsApp.

1. Создайте инстанс в личном кабинете (консоли) GREEN-API. Вы получите idInstance и apiTokenInstance. Эти параметры доступа передаются в каждом запросе.
2. Авторизуйте инстанс. Он подключается к аккаунту как связанное устройство. Отсканируйте QR-код в WhatsApp: «Связанные устройства» > «Привязка устройства». Другой вариант: запросите код для привязки по номеру телефона. QR-код обновляется каждые 20 секунд.
3. Отправляйте запросы в формате {apiUrl}/waInstance{idInstance}/{метод}/{apiTokenInstance}.
4. Получайте входящие уведомления. Забирайте их через HTTP API или настройте отправку на свой вебхук.

Сам аккаунт WhatsApp должен существовать заранее. Сначала зарегистрируйте его в официальном приложении WhatsApp или WhatsApp Business на номер, который может принять код подтверждения.

Функции GREEN-API

• Текст и медиа: отправка и получение текстовых сообщений, изображений, видео, документов и файлов до 100 МБ.
• Геолокация, контакты и опросы: отправка геопозиции, визитной карточки компании, опросов со статистикой. Также доступны сообщения с кнопками.
• Группы и статусы: создание групп, управление участниками, публикация статусов и сбор статистики их просмотра.
• Проверка номера: проверка наличия WhatsApp на номере телефона перед отправкой.
• Журналы: история отправленных и полученных сообщений за всё время.
• SDK: Python, Node.js, PHP, Go, Java, C++, 1С:Предприятие и HTML, а также gRPC-контракт.
• Интеграции: n8n, Make, Zapier, Slack, GoHighLevel, MS Excel и другие.
• GPT-чат-боты: готовые библиотеки для Python, Go и Node.js.

У компании есть и отдельные продукты: GREEN-API: WABA на официальном WhatsApp Business API, а также шлюзы для Telegram и MAX.

В каких сценариях нужен GREEN-API

• Интеграции с CRM: диалоги из WhatsApp попадают в систему, где уже работает команда.
• Техподдержка пользователей: обращения из WhatsApp обрабатываются в привычном интерфейсе.
• Чатботы и GPT: ответы на типовые вопросы приходят автоматически, в том числе через ИИ.
• Замена SMS: статусы заказов, напоминания и коды уходят в WhatsApp вместо SMS-рассылок.
• Каскадная отправка: WhatsApp становится одним из каналов в цепочке уведомлений.
• Несколько номеров: агентства и отделы поддержки работают по схеме «один инстанс на клиента или регион».

Ограничения, которые важно учесть

• Это не официальная платформа Meta. WhatsApp может ограничить номер за массовые или нежелательные рассылки. Поэтому GREEN-API публикует собственные советы по прогреву номера и рассылкам.
• Один инстанс, один номер. Десять номеров означают десять инстансов и десять оплаченных тарифов.
• Телефон по-прежнему важен. Аккаунт живёт в официальном приложении на телефоне. На большинстве тарифов документация советует держать телефон заряженным и подключённым к интернету.
• Нужен номер телефона. GREEN-API не выдаёт номера, вы подключаете свои.

Как вести WhatsApp-сторону в масштабе

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

Командам с большим количеством номеров удобно держать каждый аккаунт WhatsApp на отдельном облачном телефоне Multilogin для WhatsApp. Каждый облачный телефон: это реальное Android-устройство в облаке со своими данными приложений, местоположением и IP. Полка заряженных смартфонов не нужна.

Если нужно добавить номера, воспользуйтесь руководством о том, как создать несколько аккаунтов WhatsApp. Облачные телефоны Multilogin не принимают SMS и звонки. Код подтверждения должен прийти на номер, который вы контролируете: ваш телефон или внешний SMS-сервис.

Сетевые настройки тоже важны, особенно если номера относятся к разным регионам. Прокси для WhatsApp даёт каждому аккаунту собственный IP. В Multilogin уже встроены резидентные прокси: каждый профиль получает свой IP и соответствующую геолокацию.