Preguntas frecuentes y solución de problemas de Coexistence
Esta guía cubre errores importantes y cómo solucionarlos durante el uso de Coexistence
Error de tipo de mensaje no compatible en Coexistence
Códigos de error: 131051, 131060 y otros
Si usas WhatsApp Coexistence para conectar tu número de WhatsApp Business App a Chakra Chat, es posible que de vez en cuando veas en tu bandeja de entrada un mensaje como este:
"Mensaje no compatible. Ver en WhatsApp Business App."
Este comportamiento es esperado en ciertas situaciones y Meta lo aplica; no se trata de un error de Chakra. Esta guía explica por qué sucede, qué significan los distintos códigos de error y qué puedes hacer al respecto.
Qué significa este error
En Chakra aparece un marcador de posición de "mensaje no compatible" cuando un mensaje enviado o recibido en tu número de Coexistence no se puede reenviar a Chakra mediante el sistema de webhooks de Meta. El mensaje sigue existiendo; simplemente no está visible en Chakra porque Meta nunca envió a Chakra los datos necesarios para mostrarlo.
Esta es una limitación de la Cloud API de Meta/WhatsApp, no algo que Chakra pueda sortear. El mensaje original siempre sigue visible en la propia WhatsApp Business App.
Códigos de error comunes que puedes ver
Código de error | Significado | Suele aparecer cuando |
|---|---|---|
131051 | Tipo de mensaje no compatible | El contacto envió un tipo de mensaje que la Cloud API no admite en absoluto (por ejemplo, reacciones, encuestas, mensajes temporales o de visualización única, y mensajes eliminados) |
131060 | Mensaje recibido durante la sincronización o no disponible | Una limitación específica de Coexistence, normalmente relacionada con mensajes iniciales, dispositivos vinculados no compatibles o un número que aún se está sincronizando |
Otros (no se muestra ningún código numérico) | Marcador de posición genérico de "mensaje no compatible" | Mensajes editados por un contacto o enviados desde un dispositivo vinculado no compatible |
Ambos códigos indican el mismo problema de fondo: Meta no envió un evento de webhook que incluyera el contenido del mensaje, por lo que Chakra no tiene nada que mostrar.
Por qué sucede
Hay cinco causas comunes. Compara lo que ves con los casos que se describen a continuación.
1. El contacto usó un dispositivo complementario (vinculado) no compatible
Meta admite la mayoría de los dispositivos complementarios/vinculados de WhatsApp en Coexistence, pero WhatsApp para Windows y WhatsApp para WearOS no son compatibles. Si tu contacto envía un mensaje desde uno de estos dispositivos, no se activa ningún webhook y Chakra no puede reflejarlo. (La documentación de Meta sobre dispositivos vinculados lo explica en detalle.)
2. Sincronización de mensajes después de un período de inactividad
Si un contacto envía un mensaje a tu número de Coexistence después de un período de inactividad, es posible que la conexión necesite un momento para actualizarse. Los mensajes que lleguen durante este período de actualización pueden aparecer como no compatibles hasta que termine la sincronización.
3. Tipo de mensaje realmente no compatible
Algunos tipos de mensajes de WhatsApp simplemente no son compatibles con la Cloud API, independientemente de Coexistence. Esto incluye, por ejemplo, reacciones, encuestas, mensajes de visualización única y mensajes eliminados o revocados. Siempre aparecerán como no compatibles; no hay solución, porque la Cloud API no procesa este contenido.
4. Primer mensaje, especialmente a través de un anuncio Click-to-WhatsApp
Cuando alguien envía un mensaje a tu número por primera vez, en especial justo después de tocar un anuncio Click-to-WhatsApp, es posible que ese primer mensaje no llegue a través del webhook. Este es el caso relacionado con el error 131060 y Meta lo señala explícitamente en su documentación como un comportamiento esperado que suele resolverse en segundos.
5. El contacto edita un mensaje que ya había enviado
Si un contacto edita un mensaje que ya te había enviado, la versión editada también puede aparecer como no compatible en Chakra, aunque la versión original se haya recibido correctamente.
Qué puedes hacer
Causa | Qué hacer |
|---|---|
Dispositivo complementario no compatible | Consulta el mensaje completo directamente en la WhatsApp Business App principal de tu teléfono. |
Sincronización después de la inactividad | Espera a que termine la sincronización; los mensajes posteriores deberían llegar con normalidad. No tienes que hacer nada. |
Tipo de mensaje no compatible | Consulta el mensaje en WhatsApp Business App. Esta es una limitación permanente de Meta y no hay forma de evitarla. |
Primer mensaje a través de un anuncio | No tienes que hacer nada; normalmente se resuelve en segundos y los mensajes posteriores llegan con normalidad. |
Mensaje editado | Consulta el mensaje editado en WhatsApp Business App. |
Si ves mensajes no compatibles constantemente, incluso mensajes de texto normales de contactos que usan dispositivos compatibles, no es un comportamiento esperado; consulta la nota de solución de problemas a continuación.
Cuándo esto podría indicar un problema real de conexión
Es normal que aparezcan marcadores de posición de mensajes no compatibles de vez en cuando con Coexistence. Sin embargo, si la mayoría o todos los mensajes entrantes aparecen como no compatibles, comprueba lo siguiente:
- Confirma que el mensaje esté visible en WhatsApp Business App en tu dispositivo principal.
- Ve a WhatsApp Business Manager y confirma que Chakra siga apareciendo como socio conectado activo de tu cuenta de WhatsApp Business.
- Si Chakra no aparece en la lista, es probable que se haya eliminado la conexión con tu socio; tendrás que volver a conectar tu canal de Coexistence mediante el flujo de Embedded Signup.
Una causa común de la desconexión con un socio es que no se haya abierto WhatsApp Business App en el dispositivo principal durante 14+ días, lo que puede cerrar la sesión de los dispositivos vinculados e interrumpir la conexión.
Preguntas frecuentes sobre mensajes no compatibles
¿Perderé el contenido del mensaje para siempre? No. El mensaje nunca se pierde; simplemente no se refleja en Chakra. Siempre permanece completamente visible en WhatsApp Business App.
¿Esto afecta la entrega del mensaje a mi contacto? No. Esto solo afecta si Chakra puede mostrar el mensaje. No afecta la entrega en WhatsApp.
¿Es un error de Chakra? No. Es una limitación que Meta aplica a través de la Cloud API a los números conectados mediante Coexistence. Afecta a todas las plataformas que ofrecen Coexistence, no solo a Chakra.
¿Puedo sincronizar el historial y los contactos para evitarlo? La sincronización de contactos e historial de mensajes durante la incorporación es independiente de este problema y no evita que aparezcan marcadores de posición de mensajes no compatibles en los cinco casos anteriores.
Detalles de los códigos de error
Error 131060: mensaje no disponible actualmente
Qué impide: Un mensaje entrante en Chakra · ¿Reintentar ayuda? No; normalmente se soluciona en segundos · Dónde solucionarlo: aplicación WhatsApp Business
Qué ves: Un mensaje entrante aparece como no disponible en Chakra, con el error 131060.
Diagnóstico sencillo: Meta no envió a Chakra un primer mensaje de un contacto nuevo, a menudo proveniente de un anuncio de clic a WhatsApp. Meta documenta que esto es lo esperado en los números de la aplicación WhatsApp Business.
Solución 1 – Enfoque recomendado
1. Lee el mensaje en la aplicación WhatsApp Business.
2. Responde con normalidad; los mensajes posteriores del contacto llegarán a Chakra como de costumbre.
Solución 2 – Verificada por Chakra: Verificación en curso. Si la solución 1 no lo resuelve, crea un ticket con el equipo de soporte de Chakra.
Error 131051 – Tipo de mensaje no compatible
Qué impide: Un mensaje en Chakra · ¿Reintentar ayuda? No · Dónde solucionarlo: aplicación WhatsApp Business
Qué ves: Chakra muestra “Mensaje no compatible. Ver en la aplicación WhatsApp Business”, con el error 131051.
Diagnóstico sencillo: El contacto envió algo que la API de WhatsApp no puede mostrar, como una reacción, una encuesta, un mensaje de visualización única o un mensaje eliminado.
Solución 1 – Enfoque recomendado
1. Ve el mensaje en la aplicación WhatsApp Business.
2. Si necesitas el contenido en Chakra, pídele al contacto que lo envíe como texto normal.
Solución 2 – Verificada por Chakra: Verificación en curso. Si la solución 1 no lo resuelve, crea un ticket con el equipo de soporte de Chakra.