Em resumo: O Restricted Chat bloqueia o envio pela API de sessão web em um chat ou grupo até o celular principal desligar a configuração. Quando um envio falha e o canal continua ativo, confira esse chat no celular e não tente de novo. A Whapi.Cloud está introduzindo limit_companion_sharing_enabled e o HTTP 403 antes do envio, para a integração indicar a causa em vez de uma falha sem explicação.
No backend em Node.js ou Python, com o canal ativo, um chat ou um grupo recusa o envio. A sessão segue conectada e os demais chats continuam enviando. Desligue o Restricted Chat no celular principal e envie de novo.
O que é o WhatsApp Restricted Chat e quem pode ativá-lo
Só o celular principal liga ou desliga o Restricted Chat. Uma nova tentativa pela API deixa a chave como está.
Em 4 de novembro de 2026, a documentação oficial do WhatsApp informa que, no app mais recente, a privacidade avançada do chat (Advanced chat privacy) está sendo substituída pelo Restricted Chat. A substituição adiciona um controle que mantém esse chat fora dos dispositivos vinculados, o que a Central de Ajuda descreve como forma de impedir clientes não oficiais ou agentes de IA. Um chat que já está com a privacidade avançada ativada não passa sozinho para o Restricted Chat. Desligue essa configuração antiga e o controle passa a aparecer como Restricted Chat. As publicações da beta de outubro de 2026 descreviam chats 1:1. Nessa verificação, a documentação oficial também inclui grupos.
Em um chat 1:1, qualquer um dos participantes pode ativar a configuração. Um administrador do grupo ativa a opção para todas as mensagens daquele grupo.
Com o Restricted Chat ativado, o salvamento automático de mídia, a exportação do chat, o Meta AI e os dispositivos vinculados ficam indisponíveis nesse chat. A criptografia de ponta a ponta permanece nas mensagens pessoais. O Meta AI só vê as mensagens que as pessoas escolhem enviar a ele. A configuração não aparece em chats com empresas que usam a Meta para armazenar mensagens e responder aos clientes.
Por que o Restricted Chat impede envios nas APIs de sessão web
Nos testes da Whapi, o WhatsApp Web marca a mensagem de saída como falha antes que a requisição de rede saia.
A Central de Ajuda confirma o bloqueio dos dispositivos vinculados. Alguém ativa o Restricted Chat no celular principal. O WhatsApp Web passa a recusar o envio nesse chat. Um envio de texto usa essa sessão de dispositivo vinculado, então a mensagem não sai. Uma nova tentativa deixa a configuração ligada.
Nos testes da Whapi, o aviso no app dizia que o chat não pode ser usado em dispositivos vinculados, e o WhatsApp Web marcou a mensagem como falha sem enviar nenhuma requisição de rede. Esse estado de falha antes da requisição vem dos testes da Whapi. A Central de Ajuda não descreve esse mecanismo.
Por que essa falha pode ser difícil de detectar na integração
O status do canal permanece ativo. Os outros chats do mesmo canal continuam enviando mensagens, enquanto um chat ou um grupo não envia.
O primeiro recurso da maioria das equipes é tentar de novo, reconectar ou esperar, tratando o caso como erro genérico de rede. O Restricted Chat continua ligado, então a próxima tentativa falha do mesmo jeito. A sessão permanece conectada o tempo todo.
A revisão da Whapi de bibliotecas públicas do WhatsApp Web e de implementações de API não encontrou tratamento explícito para essa restrição. Uma integração afetada pode devolver uma falha genérica de envio ou pode não indicar a causa. O resultado que você vê depende do tratamento de erro do próprio provedor.
Como a Whapi trata o Restricted Chat
A Whapi.Cloud está introduzindo o HTTP 403 antes de um envio com Restricted Chat. O JSON abaixo é o contrato pretendido, não uma resposta ao vivo da API, e limit_companion_sharing_enabled não faz parte do esquema público em 4 de novembro de 2026.
A Whapi.Cloud não desliga a configuração de privacidade. O gateway está sendo atualizado para registrar o bloqueio e responder com um resultado previsível. O nome dessa verificação é explicit restriction handling.
A Whapi.Cloud está adicionando a flag no objeto de chat e no objeto de grupo. limit_companion_sharing_enabled é true quando os dispositivos vinculados (companion) estão bloqueados e false quando não estão. Envios diretos, encaminhamentos e cópias estão previstos para receber HTTP 403 com um motivo declarado antes da tentativa. Os eventos de webhook de entrada continuam para o que o chat ainda entregar. Este artigo não promete que mensagens recebidas de um Restricted Chat vão chegar.
Se você guardar a flag em cache, trate o valor como o último estado conhecido. A atualização pode demorar a chegar, então o próximo envio pode ocorrer antes de a mudança aparecer. Leia os metadados do chat com GET /chats/{ChatID}. Leia os metadados do grupo com 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."
}
};
O WhatsApp passou a limitar o acesso por dispositivo vinculado em cada chat. A Whapi.Cloud está incorporando essa mudança no gateway, então a API voltada ao cliente está sendo atualizada para devolver a flag e o HTTP 403, em vez de uma falha local do cliente web.
Se a flag e o 403 ainda não estiverem no seu canal, fale com o suporte da Whapi.Cloud pelo widget de chat em whapi.cloud.
Como voltar a enviar mensagens em um Restricted Chat
Abra o chat ou o grupo no celular principal, desligue o Restricted Chat e envie de novo. Nem o WhatsApp Web nem a API conseguem mudar essa chave.
Depois que um administrador do grupo desliga a configuração, você pode enviar para esse grupo de novo. Em um chat 1:1, confirme no celular principal que a restrição está desligada antes do próximo envio.
O que fazer agora na integração
Trate o bloqueio como um único chat. Pare de repetir esse envio, trate o HTTP 403 e leia limit_companion_sharing_enabled antes da próxima tentativa.
Dê a essa verificação o nome explicit restriction handling. A Whapi.Cloud está introduzindo a flag e o HTTP 403 para o envio pela API de sessão web indicar a causa, em vez de falhar sem explicação. A Whapi.Cloud está adaptando a API a essa mudança do WhatsApp.
