Кратко: Restricted Chat блокирует отправку через API на базе WhatsApp Web в одном чате или группе, пока основной телефон не выключит настройку. Если одно сообщение не ушло, а канал при этом на связи, проверьте этот чат на телефоне и не повторяйте отправку. Whapi.Cloud вводит limit_companion_sharing_enabled и HTTP 403 до отправки, чтобы обработчик называл причину, а не сбой без объяснения.
Бэкенд на Node.js или Python на подключённом канале видит, как один чат или одна группа отклоняет отправку. Сессия остаётся на связи, и сообщения в остальные чаты уходят. Выключите Restricted Chat на основном телефоне и отправьте снова.
Что такое WhatsApp Restricted Chat и кто может его включить?
Включить и выключить Restricted Chat можно только с основного телефона. Повтор через API этот переключатель не меняет.
На 4 ноября 2026 года официальная документация WhatsApp сообщает: в актуальной версии приложения Advanced chat privacy заменяют на Restricted chat. Новая настройка не пускает этот чат на связанные устройства. Справочный центр описывает это как способ закрыть чат от неофициальных клиентов и AI-агентов. Чат с уже включённой Advanced chat privacy сам на новую настройку не переходит. Выключите прежнюю настройку — и дальше этот пункт отображается как Restricted chat. В бета-публикациях октября 2026 года речь шла о чатах один на один. На момент этой проверки официальная документация включает и группы.
В чате один на один настройку может включить любой из собеседников. Администратор группы включает её для всех сообщений в этой группе.
Пока Restricted Chat включён, в этом чате недоступны автоматическое сохранение медиа, экспорт чата, Meta* AI и связанные устройства. Сквозное шифрование личных сообщений сохраняется. Meta* AI видит только сообщения, которые человек сам выбирает отправить. Настройка не появляется в чатах с бизнесами, которые хранят сообщения и отвечают клиентам через Meta*.
Почему Restricted Chat срывает отправку через API на базе WhatsApp Web
Тесты Whapi показывают: WhatsApp Web помечает исходящее сообщение неудачным ещё до того, как сетевой запрос уходит.
Справочный центр подтверждает блокировку связанных устройств. Кто-то включает Restricted Chat на основном телефоне, и WhatsApp Web отказывается отправлять сообщения в этот чат. Отправка текста идёт через сессию связанного устройства, поэтому сообщение не уходит. Повтор оставляет настройку включённой.
В тестах Whapi уведомление в приложении сообщало, что чат нельзя использовать на связанных устройствах, а WhatsApp Web помечал сообщение неудачным и не отправлял сетевой запрос. Такое состояние — сбой до сетевого запроса — получено в тестах Whapi. Справочный центр этот механизм не описывает.
Почему интеграциям трудно заметить этот сбой
Статус канала остаётся рабочим. Остальные чаты того же канала продолжают отправлять сообщения, а один чат или одна группа — нет.
Первое, за что хватаются команды, — повтор, переподключение или ожидание при общей сетевой ошибке. Restricted Chat при этом включён, поэтому следующая попытка срывается так же. Сессия всё это время остаётся подключённой.
Обзор публичных библиотек WhatsApp Web и реализаций API, который провёл Whapi, не нашёл явной обработки этого ограничения. Затронутая интеграция может сообщить об общем сбое отправки или не назвать причину. Какой из этих вариантов вы увидите, зависит от того, как ошибки обрабатывает конкретный провайдер.
Как Whapi обрабатывает Restricted Chat
Whapi.Cloud вводит HTTP 403 до отправки в чат с Restricted Chat. JSON ниже — задуманный контракт, а не реальный ответ API. Флага limit_companion_sharing_enabled в публичной схеме на 4 ноября 2026 года нет.
Whapi.Cloud не снимает настройку приватности. Шлюз обновляют так, чтобы он фиксировал блокировку и отвечал предсказуемым результатом. Эту проверку называют явной обработкой ограничения.
Whapi.Cloud добавляет флаг в объект чата и в объект группы. limit_companion_sharing_enabled равен true, если связанные устройства заблокированы, и false, если нет. Прямая отправка, пересылка и копирование рассчитаны на HTTP 403 с указанной причиной до самой попытки. Входящие события вебхуков остаются для всего, что чат ещё доставляет. Эта статья не обещает, что входящие сообщения из чата с Restricted Chat придут.
Если вы кэшируете флаг, считайте значение последним известным состоянием. Обновление может запаздывать, и следующая отправка уйдёт раньше, чем приложение увидит изменение. Метаданные чата читайте через GET /chats/{ChatID}. Метаданные группы — через GET /groups/{GroupID}.
// Intended contract, not a live response. A retry while the flag is true hits the same Restricted Chat block.
const chat = {
"id": "chat_identifier",
"limit_companion_sharing_enabled": true
};
const refused = {
"error": {
"code": 403,
"message": "This chat has Restricted Chat enabled. Messaging from linked devices is unavailable. Disable Restricted Chat on the primary phone to send messages."
}
};
WhatsApp изменил доступ связанных устройств отдельно для каждого чата. Whapi.Cloud принимает это изменение на шлюзе, поэтому API для интегратора обновляют: он будет возвращать флаг и HTTP 403 вместо локального сбоя веб-клиента.
Если флага и HTTP 403 на вашем канале ещё нет, напишите в поддержку Whapi.Cloud через виджет чата на whapi.cloud.
Как вернуть отправку в чат с Restricted Chat
Откройте чат или группу на основном телефоне, выключите Restricted Chat, затем отправьте снова. Ни WhatsApp Web, ни API не могут переключить эту настройку.
Когда администратор группы выключит настройку, вы снова сможете отправить сообщение в эту группу. В чате один на один перед следующей отправкой убедитесь на основном телефоне, что ограничение снято.
Что делать разработчику дальше
Относитесь к отказу как к проблеме одного чата. Не повторяйте эту отправку, обрабатывайте HTTP 403 и читайте limit_companion_sharing_enabled перед следующей попыткой.
Обрабатывайте эту проверку как явную обработку ограничения. Whapi.Cloud вводит флаг и HTTP 403, чтобы отправка через API на базе WhatsApp Web называла причину, а не завершалась без объяснения. Whapi.Cloud адаптирует API к этому изменению WhatsApp.
