Errores de entrega de mensajes

Los errores de entrega de mensajes significan que Meta aceptó tu mensaje, pero no pudo entregarlo por motivos relacionados con el cliente, la ventana de 24 horas, la facturación, los archivos multimedia o tu cuenta. A continuación, se ordenan aproximadamente según la frecuencia con que ocurren.

Error 131042 - Problema de pago

Qué impide: Toda la cuenta · ¿Ayuda volver a intentarlo? Después de solucionarlo · Dónde solucionarlo: WhatsApp Manager > Configuración de pagos

Qué ves: Los mensajes de plantilla fallan con el error 131042, un problema de pago relacionado con la elegibilidad de la empresa.
Diagnóstico sencillo: Meta no puede cobrar a la cuenta: no hay una tarjeta o línea de crédito válida, la tarjeta fue rechazada o venció, o faltan la moneda y la zona horaria. Es común justo después de cambiar de proveedor, si la línea de crédito anterior sigue vinculada. No se cobran los mensajes que fallan.

Solución 1 – Enfoque recomendado
1. En WhatsApp Manager > Configuración de pagos, agrega o actualiza una tarjeta válida, o comprueba que la línea de crédito esté activa.
2. Asegúrate de que la tarjeta permita pagos internacionales y no esté vencida.
3. Comprueba que la cuenta tenga configuradas una moneda y una zona horaria.
4. ¿Cambiaste de proveedor? Pídeles que eliminen su línea de crédito y luego vuelve a conectarte.
5. Envía un mensaje de prueba antes de reanudar las campañas.

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 131026 - Mensaje no entregable

Qué impide: A este cliente · ¿Ayuda volver a intentarlo? No, a menos que el cliente lo solucione · Dónde solucionarlo: El teléfono del cliente

Qué ves: Los mensajes a un contacto fallan con el error 131026: mensaje no entregable.
Diagnóstico sencillo: El número no está en WhatsApp, el cliente no aceptó los términos más recientes de WhatsApp, tiene una versión desactualizada de la aplicación o bloqueó a tu empresa. Meta no especifica cuál es el motivo.

Solución 1 – Enfoque recomendado
1. Comprueba que el número esté en WhatsApp (abre wa.me/ seguido del número).
2. Comunícate con el cliente por otro medio (SMS, llamada o correo electrónico) y pídele que actualice WhatsApp, acepte los términos más recientes y compruebe que tu número no esté en Configuración > Privacidad > Bloqueados.
3. Pídele que envíe primero un mensaje al número de tu empresa.
4. Después de varios intentos fallidos, deja de enviar mensajes y marca el contacto como no disponible.

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 131049 - No entregado para mantener un ecosistema saludable

Qué impide: Enviar mensajes de marketing a este cliente · ¿Ayuda volver a intentarlo? Sí, después de más de 24 h (nunca para números de EE. UU. con +1) · Dónde solucionarlo: Horario y público de la campaña

Qué ves: Los mensajes de plantilla de marketing a algunos contactos fallan con el error 131049.
Diagnóstico sencillo: Meta limita la cantidad de mensajes de marketing que cada persona recibe de todas las empresas. Este cliente alcanzó ese límite. Se aplica a todas las empresas, incluidas las verificadas. Los números de EE. UU. (+1) no pueden recibir mensajes de plantilla de marketing.

Solución 1 – Enfoque recomendado
1. No vuelvas a enviarlo de inmediato.
2. Vuelve a intentarlo después de al menos 24 horas y deja intervalos más largos cada vez; también puedes esperar a que el cliente responda, lo que abre una ventana de 24 horas durante la cual se entrega cualquier mensaje.
3. Para los números de EE. UU. (+1), usa SMS o correo electrónico.
4. Envía mensajes de marketing solo a contactos que interactúan y dieron su consentimiento; para actualizaciones transaccionales, usa una plantilla de utilidad clasificada correctamente.

Solución 2 – Verificada por Chakra: Verificación en curso. Guía completa: https://chakrahq.com/help/chat/faqs/whatsapp-api-error-code-troubleshooting/whatsapp-error-131049

Error 131047 - Ventana de 24 horas vencida

Qué impide: Enviar mensajes normales a este cliente · ¿Ayuda volver a intentarlo? Usa una plantilla · Dónde solucionarlo: Bandeja de entrada o flujo del bot

Qué ves: Un mensaje normal (sin plantilla) falla con el error 131047, mensaje de reactivación.
Diagnóstico sencillo: Pasaron más de 24 horas desde que el cliente te envió su último mensaje, por lo que solo puedes enviar plantillas aprobadas. En raras ocasiones, Meta devuelve este error por equivocación dentro de la ventana.

Solución 1 – Enfoque recomendado
1. Envía una plantilla aprobada.
2. Cuando el cliente responda, podrás volver a enviar mensajes normales durante 24 horas.
3. Comprueba que los flujos del bot no envíen mensajes normales después de largos periodos de espera.

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 131050 - El usuario rechazó los mensajes de marketing

Qué impide: Enviar mensajes de marketing a este cliente · ¿Ayuda volver a intentarlo? No · Dónde solucionarlo: En ningún lado: respeta su decisión

Qué ves: Los mensajes de plantilla de marketing a un contacto fallan con el error 131050.
Diagnóstico sencillo: El cliente decidió dejar de recibir mensajes de marketing de tu empresa. Solo él puede volver a activarlos.

Solución 1 – Enfoque recomendado
1. Deja de enviar mensajes de marketing a este contacto y exclúyelo de los envíos masivos de marketing.
2. Los mensajes de plantilla de utilidad y autenticación, así como las respuestas normales, siguen funcionando.

No hagas esto: No envíes contenido de marketing como plantilla de utilidad para eludir el rechazo: esto infringe las políticas de WhatsApp.

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 131053 - Error al subir archivos multimedia

Qué impide: Este mensaje · ¿Ayuda volver a intentarlo? Después de solucionarlo · Dónde solucionarlo: El archivo multimedia

Qué ves: Un mensaje con una imagen, un video o un archivo falla con el error 131053.
Diagnóstico sencillo: El tipo de archivo no es compatible, es demasiado grande o el enlace no es un enlace público directo (por ejemplo, un enlace para compartir de Google Drive).

Solución 1 – Enfoque recomendado
1. Comprueba el archivo: imágenes JPEG o PNG de hasta 5 MB; videos MP4 de hasta 16 MB; audio de hasta 16 MB; documentos de hasta 100 MB.
2. Sube el archivo directamente o usa un enlace público directo que abra el archivo.
3. Vuelve a enviarlo.

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 131052 - No se puede descargar el archivo multimedia enviado por el cliente

Qué impide: Un archivo entrante · ¿Ayuda volver a intentarlo? Pide al cliente que lo vuelva a enviar · Dónde solucionarlo: El cliente

Qué ves: No se puede abrir en la bandeja de entrada un archivo que envió el cliente; aparece el error 131052.
Diagnóstico sencillo: WhatsApp no pudo descargar el archivo; puede estar dañado, no ser compatible o no estar disponible temporalmente.

Solución 1 – Enfoque recomendado
1. Pide al cliente que vuelva a enviar el archivo.
2. Si vuelve a fallar, pídele que lo envíe como documento en lugar de foto.

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 130403 - La empresa bloqueó a este usuario

Qué impide: A este cliente · ¿Ayuda volver a intentarlo? No, hasta que lo desbloquees · Dónde solucionarlo: La lista de bloqueados de tu empresa

Qué ves: Los mensajes fallan con el error 130403, que indica que tu empresa bloqueó a este usuario.
Diagnóstico sencillo: Alguien de tu equipo bloqueó el número de este cliente.

Solución 1 – Enfoque recomendado
1. Comprueba si el bloqueo fue intencional (por spam o abuso). Si fue así, mantenlo.
2. Si no fue intencional, desbloquea al usuario donde lo bloquearon (para los números de la aplicación WhatsApp Business, en la lista de contactos bloqueados de la aplicación) y vuelve a enviar el mensaje.

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: Este mensaje · ¿Ayuda volver a intentarlo? Después de solucionarlo · Dónde solucionarlo: El tipo de mensaje o la aplicación WhatsApp Business

Qué ves: Un mensaje enviado falla con el error 131051, o un mensaje entrante aparece como no compatible.
Diagnóstico sencillo: Mensaje saliente: el tipo de mensaje no es compatible. Mensaje entrante: el cliente envió algo que la API no puede mostrar, como una encuesta o contenido multimedia de visualización única.

Solución 1 – Enfoque sugerido
1. Mensajes salientes: envía un tipo compatible (texto, contenido multimedia, ubicación, contacto, interactivo o plantilla).
2. Mensajes entrantes en un número de la aplicación WhatsApp Business: consúltalos en la aplicación o pide al cliente que los vuelva a enviar como texto.

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 135000 - Error genérico del usuario

Qué afecta: Este mensaje · ¿Ayuda volver a intentarlo? Después de corregirlo · Dónde corregirlo: Plantilla o contenido del mensaje

Qué ves: No se puede enviar un mensaje y aparece el error 135000, un error genérico del usuario.
Diagnóstico sencillo: Meta no pudo identificar una causa específica. En la práctica, suele deberse a un problema de formato o a una restricción de la plantilla.

Solución 1 – Enfoque sugerido
1. Revisa las variables y el formato de la plantilla.
2. Prueba con otra plantilla aprobada; si funciona, vuelve a crear la que falla.
3. ¿Sigue fallando? Envía una solicitud de soporte con la hora del error.

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 131037 - El número 555 necesita un nombre para mostrar aprobado

Qué afecta: Este número · ¿Ayuda volver a intentarlo? Después de corregirlo · Dónde corregirlo: WhatsApp Manager

Qué ves: No se pueden enviar mensajes desde un número 555 (proporcionado por Meta) y aparece el error 131037.
Diagnóstico sencillo: Los números 555 proporcionados por Meta no pueden enviar mensajes hasta que se apruebe su nombre para mostrar.

Solución 1 – Enfoque sugerido
1. Configura el nombre para mostrar en WhatsApp Manager y espera a que se apruebe.
2. O envía mensajes desde tu propio número comercial verificado.

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 131021 - El remitente y el destinatario son el mismo

Qué afecta: Este mensaje · ¿Ayuda volver a intentarlo? No · Dónde corregirlo: Número del destinatario

Qué ves: No se puede enviar un mensaje y aparece el error 131021.
Diagnóstico sencillo: Intentaste enviar un mensaje a tu propio número comercial. Suele ocurrir durante las pruebas.

Solución 1 – Enfoque sugerido
1. Envía el mensaje a otro número.

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 131057 - Cuenta en modo de mantenimiento

Qué afecta: Toda la cuenta, temporalmente · ¿Ayuda volver a intentarlo? Sí, después de esperar · Dónde corregirlo: No hay nada que corregir: espera

Qué ves: No se pueden enviar mensajes y aparece el error 131057, que indica que la cuenta está en modo de mantenimiento.
Diagnóstico sencillo: Meta está realizando tareas de mantenimiento en la cuenta, a menudo durante una actualización del rendimiento.

Solución 1 – Enfoque sugerido
1. Espera —por lo general, de unos minutos a unas horas— y vuelve a enviar el mensaje.

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.

¿Sigues sin poder resolverlo?

Envía una solicitud de soporte a Chakra con el número del cliente, la hora del mensaje fallido y el código de error exacto. Referencia de Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes