REST API конечные точки WhatsApp
Параметры в GET-запросах передаются через строку запроса. Параметры в POST-запросах — через тело запроса в формате JSON. Используйте токен в заголовке авторизации Bearer. Получить токен для WhatsApp API!
Whapi.Cloud подключается к WhatsApp через сессию связанного устройства.
Ваш аккаунт WhatsApp привязывается к каналу с помощью QR-кода или кода сопряжения, аналогично WhatsApp Web, однако соединение поддерживается через серверные сокеты.
Далее API выступает в роли защищённого шлюза, который в реальном времени отправляет и принимает события (сообщения, статусы, обновления групп) и предоставляет их через HTTP-эндпоинты и webhooks.
Нет. После привязки номера телефон не требуется постоянно держать в сети.
Однако WhatsApp может периодически запрашивать активность на основном устройстве для сохранения действительности связанной сессии. На практике обычно достаточно открыть WhatsApp на телефоне один раз в несколько недель.
Да. Вы можете продолжать пользоваться WhatsApp в обычном режиме на телефоне и в WhatsApp Web, пока API подключён.
API работает параллельно как дополнительное связанное устройство и не блокирует и не заменяет ваше стандартное использование.
В некоторых случаях WhatsApp может автоматически аннулировать сессии связанных устройств.
В этом случае каналу потребуется повторная авторизация путём сканирования нового QR-кода или использования кода сопряжения.
Данные при этом не теряются, и после повторной привязки API сразу возобновляет нормальную работу.
Да. Несмотря на то что API на платных тарифах не накладывает жёстких ограничений на отправку сообщений, WhatsApp активно отслеживает поведение аккаунтов. Безопасность использования зависит не столько от API, сколько от способа отправки сообщений. Постепенный прогрев, разумный темп, релевантный контент и вовлечённость получателей играют ключевую роль. Агрессивные или неестественные паттерны отправки могут привести к ограничениям независимо от используемого инструмента, поэтому в продакшн-сценариях всегда следует использовать задержки, пакетную обработку и базовый контроль скорости.
Webhooks — это HTTP-уведомления в реальном времени, которые Whapi.Cloud отправляет на ваш сервер при возникновении значимых событий. Они срабатывают при получении сообщений, изменении статусов доставки или прочтения, событиях в группах или каналах, а также при других обновлениях, связанных с WhatsApp. Это позволяет вашей системе мгновенно реагировать без постоянного опроса API, делая webhooks основным механизмом для построения событийных автоматизаций и ботов.
Да. API спроектирован для непрерывной работы и поддержки долгоживущих процессов, таких как чат-боты, сервисы уведомлений, интеграции с CRM и системы мониторинга. После привязки номера и корректной авторизации API может работать неограниченно долго, при условии, что WhatsApp не сбросит сессию связанного устройства. Для стабильного и непрерывного использования в продакшн-среде рекомендуется платный тариф.
Само использование API не увеличивает риск блокировки автоматически. Ограничения в первую очередь связаны с тем, как используется аккаунт WhatsApp. Поведение, похожее на спам, плохая репутация номера, низкая вовлечённость получателей или негативная обратная связь могут привести к ограничениям как с API, так и без него. Соблюдение рекомендаций — постепенный прогрев, контролируемая скорость отправки и осмысленный контент — существенно снижает риски.
Whapi.Cloud не осуществляет постоянное хранение содержимого ваших сообщений.
Сообщения обрабатываются в реальном времени для доставки, триггера webhooks и формирования событий доставки. Пока канал активен, данные сообщений могут временно находиться в краткоживущих технических кэшах исключительно для целей обработки, маршрутизации и обработки событий.
После отключения канала или его неактивности содержимое сообщений на стороне Whapi.Cloud не сохраняется. API не предназначен для хранения сообщений или ведения архивов. Любое долговременное хранение, аналитика или история сообщений должны реализовываться на вашей собственной инфраструктуре с использованием webhooks и ответов API.