Назад к глоссарию

Green API для WhatsApp?

Что такое 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 и соответствующую геолокацию.

Люди также спрашивают

GREEN-API: это официальный API WhatsApp?

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

GREEN-API можно использовать бесплатно?

Да, на тарифе «Разработчик»: 3 чата и 100 проверок наличия WhatsApp. Платные тарифы начинаются от 690 руб/мес ($12) за инстанс

Может ли один инстанс обслуживать несколько номеров?

Нет. Один инстанс работает с одним аккаунтом WhatsApp. Для каждого дополнительного номера нужен свой инстанс.

Ведите неограниченное число аккаунтов без банов

Ведите соцсети на облачных телефонах и в веб-браузерах

Начать бесплатно