En resumen: Restricted Chat bloquea el envío de una API basada en WhatsApp Web en un chat o un grupo, hasta que el teléfono principal desactive el ajuste. Si un envío falla y el canal sigue activo, revise ese chat en el teléfono y no lo reintente. Whapi.Cloud está incorporando limit_companion_sharing_enabled y HTTP 403 antes del envío, para que el handler identifique la causa en lugar de un fallo sin explicación.
Un backend de Node.js o Python, en un canal activo, ve que un chat o un grupo rechaza un envío, mientras la sesión sigue conectada y los demás chats siguen saliendo. Desactive Restricted Chat en el teléfono principal y vuelva a enviar.
¿Qué es WhatsApp Restricted Chat y quién puede activarlo?
Solo el teléfono principal puede activar o desactivar Restricted Chat. Un reintento de la API deja ese interruptor como está.
Según la documentación oficial de WhatsApp, consultada el 4 de noviembre de 2026, en la versión más reciente de la app, Advanced chat privacy se sustituye por Restricted chat. El reemplazo añade un control que deja ese chat fuera de los dispositivos vinculados. El Centro de ayuda lo describe como una forma de impedir el uso de clientes no oficiales o de agentes de IA. Un chat que ya tiene Advanced chat privacy activado no cambia por sí solo. Desactive ese ajuste anterior y el control aparece en adelante como Restricted chat. Las publicaciones de la beta de octubre de 2026 describían chats uno a uno. En esa revisión, la documentación oficial también incluye los grupos.
En un chat 1:1, cualquiera de los dos participantes puede activar el ajuste. Un administrador del grupo activa el ajuste para todos los mensajes de ese grupo.
Con Restricted Chat activado, en ese chat no están disponibles el guardado automático de multimedia, la exportación del chat, Meta AI ni los dispositivos vinculados. El cifrado de extremo a extremo se mantiene en los mensajes personales. Meta AI solo ve los mensajes que las personas eligen enviarle. El ajuste no aparece en los chats con empresas que usan Meta para almacenar los mensajes y responder a los clientes.
Por qué Restricted Chat puede impedir los envíos de las API basadas en WhatsApp Web
Las pruebas de Whapi muestran que WhatsApp Web marca el mensaje saliente como fallido antes de que salga la solicitud de red.
El Centro de ayuda confirma el bloqueo de los dispositivos vinculados. Alguien activa Restricted Chat en el teléfono principal. WhatsApp Web rechaza entonces el envío en ese chat. Un envío de texto usa esa sesión de dispositivo vinculado, de modo que el mensaje no sale. Un reintento deja el ajuste activado.
En las pruebas de Whapi, el aviso dentro de la app indicaba que el chat no se puede usar en dispositivos vinculados, y WhatsApp Web marcó el mensaje como fallido sin enviar ninguna solicitud de red. Ese estado de fallo anterior a la solicitud proviene de las pruebas de Whapi. El Centro de ayuda no describe ese mecanismo.
Por qué las integraciones de API no detectan bien este fallo
El canal sigue activo. Los demás chats del mismo canal siguen enviando mensajes, mientras un chat o un grupo no lo hace.
Lo primero que prueba la mayoría de los equipos es reintentar, reconectar o esperar ante un error de red genérico. Restricted Chat sigue activado, y el siguiente intento falla igual. La sesión permanece conectada todo el tiempo.
La revisión de Whapi de bibliotecas de WhatsApp Web y de implementaciones de API de acceso público no encontró un manejo explícito de esta restricción. Una integración afectada puede reportar un fallo de envío genérico, o no identificar la causa. Lo que observe depende del manejo de errores de ese proveedor.
Cómo trata Whapi el Restricted Chat
Whapi.Cloud está incorporando HTTP 403 antes de un envío a un Restricted Chat. El JSON de abajo es el contrato previsto, no una respuesta en vivo de la API. limit_companion_sharing_enabled no está en el esquema público al 4 de noviembre de 2026.
Whapi.Cloud deja vigente el ajuste de privacidad. El gateway se está actualizando para registrar el bloqueo y responder con un resultado predecible. Esa comprobación se llama manejo explícito de la restricción.
Whapi.Cloud está añadiendo el flag al objeto del chat y al objeto del grupo. limit_companion_sharing_enabled es true cuando los dispositivos vinculados están bloqueados y false cuando no lo están. Los envíos directos, los reenvíos y las copias están previstos para recibir HTTP 403 con un motivo explícito antes del intento. Los eventos de webhook entrantes se conservan para lo que el chat todavía entregue. Este artículo no promete que los mensajes entrantes de un Restricted Chat vayan a llegar.
Si guarda el flag en caché, tome ese valor como el último estado conocido. La actualización puede demorarse, así que el siguiente envío puede ejecutarse antes de que la app vea el cambio. Lea los metadatos del chat con GET /chats/{ChatID}. Lea los metadatos del grupo con 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 cambió el acceso de los dispositivos vinculados, chat por chat. Whapi.Cloud está incorporando ese cambio en el gateway, y la API que usa el integrador se está actualizando para devolver el flag y HTTP 403, en lugar de un fallo local del cliente web.
Si el flag y el 403 todavía no están en su canal, consulte al equipo de soporte de Whapi.Cloud desde el widget de chat en whapi.cloud.
Cómo restablecer el envío en un Restricted Chat
Abra el chat o el grupo en el teléfono principal, desactive Restricted Chat y vuelva a enviar. Ni WhatsApp Web ni la API pueden cambiar ese interruptor.
Cuando un administrador del grupo desactiva el ajuste, puede enviar a ese grupo de nuevo. En un chat 1:1, confirme en el teléfono principal que la restricción está desactivada antes del siguiente envío.
Qué deben hacer ahora los desarrolladores
Trate el bloqueo como algo limitado a un solo chat. Deje de reintentar ese envío, maneje el HTTP 403 y lea limit_companion_sharing_enabled antes del siguiente intento.
Aplique el manejo explícito de la restricción. Whapi.Cloud está incorporando el flag y HTTP 403 para que el envío de la API web nombre la causa, en lugar de fallar sin explicación. Whapi.Cloud está adaptando la API a este cambio de WhatsApp.
