Неофициальный WhatsApp* API: что это и как пользоваться безопасно

Что такое неофициальный WhatsApp* API

Неофициальный WhatsApp* API — это шлюз стороннего разработчика. Он подключается к WhatsApp* так же, как WhatsApp* Web: ваш номер привязывается как ещё одно устройство. Шлюз превращает это подключение в REST API, которым может пользоваться ваша программа. Meta такие шлюзы не создаёт, не продаёт и не поддерживает. Работают они с обычным аккаунтом WhatsApp* или WhatsApp* Business.

«Неофициальный» значит «сделан не Meta», а не «взломанный». Шлюз не меняет приложение WhatsApp* и не использует модифицированные сборки. Он работает через тот же механизм привязанных устройств, что и WhatsApp* Web на компьютере.

Два термина, без которых дальше не обойтись:

• Привязанное устройство (linked device) — устройство, на котором открыт ваш аккаунт WhatsApp*, кроме телефона. Например, компьютер с WhatsApp* Web. Шлюз тоже становится таким устройством.
• Инстанс (instance) — подключение одного номера WhatsApp* к API. У каждого инстанса свой идентификатор и свой токен для запросов.

Как работает неофициальный шлюз

Работа со шлюзом состоит из трёх шагов.

1. Создайте инстанс. В консоли провайдера появится новый инстанс, а вместе с ним — идентификатор и токен для запросов.
2. Привяжите номер. Отсканируйте QR-код телефоном, на котором установлен WhatsApp*. После этого номер становится привязанным устройством шлюза. Многие провайдеры позволяют вместо QR-кода привязать номер по коду из консоли.
3. Обменивайтесь сообщениями по HTTP. Ваша программа отправляет сообщения HTTP-запросами. Входящие сообщения приходят на ваш сервер вебхуками: на каждое событие инстанса формируется отдельное уведомление. Если своего сервера для вебхуков нет, уведомления можно забирать из API по запросу.

Работает ли подключение, проверяют отдельным запросом к API: шлюз возвращает состояние инстанса, и у рабочего инстанса оно «авторизован».

Чем неофициальный шлюз отличается от официального API

Официальный WhatsApp* Business API даёт Meta через провайдеров. Для него нужны верификация компании, отдельный номер и одобренные шаблоны сообщений. Неофициальному шлюзу нужны только телефон с WhatsApp* и сканирование QR-кода. У каждого пути своя цена и свои правила.

Вывод: официальный путь подходит компаниям с большими объёмами и маркетинговыми рассылками. Неофициальный шлюз подходит для старта, уведомлений и переписки с клиентами, которые сами вам пишут.

Как подключить официальный API

Официальный API подключают через Meta напрямую или через провайдера. Понадобятся аккаунт Meta Business, отдельный номер и подтверждение компании. Сообщения, которые компания отправляет первой, проходят только по шаблонам, которые одобрила Meta. С 1 июля 2025 года Meta берёт плату за каждое доставленное шаблонное сообщение, цена зависит от страны и категории шаблона: marketing, utility или authentication. Требования к подключению описаны в документации Meta о WhatsApp* Business Platform. У GREEN-API есть официальный WhatsApp* Business API отдельным продуктом.

Законно ли и безопасно ли пользоваться шлюзом

В правилах переписки WhatsApp* неофициальные клиенты прямо названы среди нарушений, если ими пользуются во вред сервису или его пользователям.

На практике это значит, что WhatsApp* может заблокировать номер за спам, за жалобы клиентов или за резкий рост числа сообщений. Гарантировать, что этого не случится, не может ни один провайдер. Снизить риск помогают пять правил:

• Пишите только тем, кто согласился получать сообщения. Сообщения людям, которые вас не ждали, — главная причина жалоб и блокировок.
• Давайте простой способ отписаться. Например, предложите клиенту ответить словом «Стоп», если он больше не хочет получать сообщения, и сразу удаляйте его из списка.
• Прогревайте новый номер. Начинайте с небольшого числа сообщений тем, кто отвечает, и увеличивайте объём постепенно. Подробнее — в материале о том, как прогреть новый номер WhatsApp*.
• Делайте паузы между сообщениями. Не отправляйте весь список за минуту. Ориентир — темп живого оператора.
• Пишите по делу. Статус заказа или напоминание о записи вызывают меньше жалоб, чем реклама.

Что можно получить бесплатно

Бесплатные варианты бывают двух видов. Проекты с открытым кодом можно скачать бесплатно, но платить придётся за сервер, обновления и время разработчика. Бесплатные тарифы провайдеров ничего не стоят в месяц, но ограничивают число чатов, сообщений или проверок номеров. В официальном API Meta берёт плату за шаблонные сообщения, поэтому полностью бесплатной схемы для бизнеса с большими объёмами нет.

Проекты с открытым кодом на GitHub

• whatsapp-web.js — библиотека для Node.js, которая управляет WhatsApp* Web через браузер.
• Baileys — библиотека для Node.js, которая подключается к WhatsApp* без браузера.
• WAHA Core — готовый HTTP API в Docker-контейнере. Основная версия бесплатна, расширенная доступна по подписке.

Сам код бесплатен, но сервер, обновления после изменений в WhatsApp* и поддержка остаются на вас. Авторы WAHA сами предупреждают, что WhatsApp* не разрешает ботов и неофициальные клиенты, поэтому такой способ нельзя считать полностью безопасным.

Бесплатные тарифы провайдеров

Облачные провайдеры обычно дают бесплатный тариф или пробный период. Например, у GREEN-API есть бесплатный тариф Developer: $0 в месяц, один инстанс, переписка с тремя чатами, 100 проверок номеров и 10 статусов в месяц. Платные тарифы: Business — $12 в месяц за инстанс, Chatbot — $24 в месяц, Partner — $0,40 в день за инстанс.

Цены и лимиты актуальны на октябрь 2026 года.

Как выбрать провайдера

Сравнивайте провайдеров по шести признакам: как привязывается номер, какие есть методы, какой предельный размер файла, как устроены вебхуки, есть ли публичная страница статуса и сколько стоит работа при вашем объёме.

Данные на октябрь 2026 года. Перед выбором сверьтесь с сайтами провайдеров.

Свой сервер или облако

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

Как отправить первое сообщение через GREEN-API

1. Создайте инстанс. Зарегистрируйтесь в консоли GREEN-API и создайте инстанс на бесплатном тарифе Developer.
2. Привяжите номер. Нажмите Get QR и отсканируйте код телефоном, на котором установлен WhatsApp*.
3. Скопируйте параметры. Для запросов нужны три значения из карточки инстанса: apiUrl, idInstance и apiTokenInstance.
4. Отправьте сообщение. Это один POST-запрос с номером получателя и текстом. В GREEN-API для этого есть метод SendMessage.

Скриншот консоли, октябрь 2026 года.

Пример запроса:

curl --location '{{apiUrl}}/waInstance{{idInstance}}/sendMessage/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data '{
"chatId": "79876543210@c.us",
"message": "Здравствуйте! Ваш заказ №1042 готов к выдаче."
}'

chatId — это номер получателя в международном формате с @c.us в конце, без знака «плюс». В ответ приходит idMessage — идентификатор отправленного сообщения. Статус доставки придёт отдельным вебхуком.

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

Тот же запрос на Python с библиотекой requests:

import os
import requests
api_url = os.environ["GREEN_API_URL"]
id_instance = os.environ["GREEN_API_ID_INSTANCE"]
api_token = os.environ["GREEN_API_TOKEN"]
url = f"{api_url}/waInstance{id_instance}/sendMessage/{api_token}"
payload = {
"chatId": "79876543210@c.us",
"message": "Здравствуйте! Ваш заказ №1042 готов к выдаче.",
}
response = requests.post(url, json=payload)
print(response.json())

Идентификатор инстанса и токен лучше хранить в переменных окружения, а не в коде. У GREEN-API есть готовые библиотеки для Python, Node.js, PHP, Java, Go и других языков.

Создайте бесплатный инстанс Developer и отправьте первое сообщение сегодня. Регистрация — в консоли GREEN-API, состав тарифа — на странице бесплатного тарифа Developer и его ограничений.

Как отправить 10 000 сообщений в WhatsApp*

Большие объёмы через API отправить можно, но не за один раз. Новый номер, который в первый же день отправляет тысячи сообщений, быстро блокируют.

1. Проверьте базу. Оставьте только тех, кто согласился получать сообщения, и уберите номера без аккаунта WhatsApp*. В GREEN-API для проверки номеров есть метод CheckWhatsapp.
2. Прогрейте номер. Первые дни пишите немного и тем, кто отвечает.
3. Разбейте список на части. Отправляйте сообщения партиями в течение нескольких дней, а не всю базу сразу.
4. Задайте паузу между сообщениями. В GREEN-API интервал отправки задаётся в настройках инстанса, а сообщения ждут своей очереди на стороне сервиса.
5. Следите за очередью. Методы GetMessagesCount и ShowMessagesQueue показывают, сколько сообщений ждут отправки, а ClearMessagesQueue очищает очередь, если рассылку нужно остановить.

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

Что бизнес делает с помощью шлюза

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

• Уведомления вместо SMS. Статус заказа, доставка, напоминание о записи или оплате.
• Чат-боты. Бот отвечает на частые вопросы и передаёт сложные обращения менеджеру.
• Переписка в CRM. Менеджеры видят чаты WhatsApp* в карточке клиента и отвечают оттуда.
• Кнопка WhatsApp* на сайте. Клиент пишет с сайта, а сообщение попадает к оператору или боту.

Для многих задач не нужно писать код: у GREEN-API есть готовые интеграции с Make, Zapier и n8n, а также с популярными CRM.

Чат на сайте

На сайте обычно ставят кнопку или форму, которая открывает чат с компанией. Когда клиент пишет, шлюз присылает вебхук на ваш сервер, а бот или оператор отвечает через API. Например, интернет-магазин может подтверждать заказ в WhatsApp* сразу после оформления на сайте.

Какие ограничения учесть

Неофициальный шлюз работает в рамках возможностей обычного аккаунта WhatsApp*. Вот ограничения GREEN-API, которые стоит учесть заранее:

• Размер файла — до 100 МБ для методов SendFileByUrl и SendFileByUpload.
• Скорость — сообщения уходят через очередь с интервалом, который задаётся в настройках инстанса.
• История сообщений — методы LastIncomingMessages и LastOutgoingMessages по умолчанию возвращают сообщения за последние 24 часа и не больше 10 000 сообщений.
• Проверка номеров — метод CheckWhatsapp: 100 проверок в месяц на тарифе Developer и 30 000 на тарифе Business.
• Статистика статусов WhatsApp* — метод GetStatusStatistic хранит данные 30 дней.

Чего не будет совсем: шаблонов сообщений, подтверждённого профиля компании и отчётов по рекламе Meta с кнопкой перехода в чат. Это возможности официального WhatsApp* Business API.

Лимиты актуальны на октябрь 2026 года.

Что делать, если шлюз перестал работать

В большинстве случаев причина одна из трёх.

1. Номер отвязался от шлюза. Такое бывает, если на телефоне удалили привязанное устройство или WhatsApp* долго не был в сети. Проверьте состояние инстанса методом GetStateInstance. Если он не авторизован, отсканируйте QR-код заново.
2. Инстанс завис. Состояние нормальное, но сообщения не уходят. Перезапустите инстанс методом Reboot. Если не помогло, выйдите из аккаунта методом Logout и привяжите номер заново.
3. Ваш сервер не принимает вебхуки. Тогда входящие уведомления копятся в очереди. Сколько их там, покажет метод GetWebhooksCount, а очистить очередь можно методом ClearWebhooksQueue. Затем проверьте журналы своего сервера.

Если проблема на стороне сервиса, это видно на нашей публичной странице статуса.

Частые вопросы

Есть ли у WhatsApp* API?

Да. У WhatsApp* есть официальный Business API от Meta, а ещё есть шлюзы сторонних разработчиков, которые подключают обычный аккаунт как привязанное устройство. Для официального пути нужны верификация компании и одобренные шаблоны. Для шлюза — номер телефона и сканирование QR-кода. Оба способа позволяют отправлять и принимать сообщения из вашей программы. Выбирайте по объёму, бюджету и тому, какой риск для номера вы готовы принять.

Бесплатен ли WhatsApp* API для личного пользования?

У некоторых шлюзов есть бесплатный тариф для тестов. Обычно он ограничивает число чатов и сообщений, поэтому подходит для проверки идеи, а не для рабочей нагрузки. Например, тариф Developer в GREEN-API даёт переписку с тремя чатами. Проекты с открытым кодом устанавливаются бесплатно, но за сервер придётся платить. Официальный Business API предназначен для компаний, а не для личной переписки, и Meta берёт плату за каждое шаблонное сообщение.

Есть ли у WhatsApp* открытый API?

Нет. WhatsApp* не публикует открытый API, которым может пользоваться кто угодно. Для компаний Meta предлагает WhatsApp* Business Platform. Сторонние шлюзы строят свой REST API на том же подключении, которое использует WhatsApp* Web. Поэтому их и называют неофициальными: Meta их не создаёт, не продаёт и не поддерживает.

Как получить ключ WhatsApp* API?

У неофициального шлюза роль ключа играет пара «идентификатор инстанса и токен». В GREEN-API это idInstance и apiTokenInstance: они появляются в карточке инстанса в консоли сразу после его создания. У официального API ключ — это токен доступа приложения, который выдаётся в кабинете разработчика Meta после подключения WhatsApp* Business Platform. Храните ключ в переменных окружения и не публикуйте его в коде.

Как работать с WhatsApp* API на Python?

Установите библиотеку провайдера или используйте пакет requests. Сохраните идентификатор инстанса и токен в переменных окружения. Затем вызовите метод отправки с номером получателя и текстом — пример есть в разделе об отправке первого сообщения. У GREEN-API есть готовые библиотеки для Python, Node.js, PHP, Java, Go и других языков. Начните с одного сообщения на свой номер.

Чем WhatsApp* Business отличается от WhatsApp* Business API?

WhatsApp* Business — бесплатное мобильное приложение для небольшой команды. В нём есть каталог, быстрые ответы и метки, но нет автоматизации из ваших систем. У WhatsApp* Business API нет приложения: это интерфейс для программ, через который CRM или бот отправляют и принимают сообщения. Приложение подходит магазину с одним телефоном, API — компании с большим числом чатов.