A veces, tu mensaje puede no enviarse y aparecer un mensaje de error. Hemos mapeado todos los casos utilizando el detalle de Meta sobre qué hacer cuando aparece cada tipo de error específico.

Ejemplo de cómo aparece el mensaje de error. La caja estará con un color rojo y aparecerá un enlace ver detalles que abre una modal:

Podrás ver el detalle del error haciendo clic en ver detalles:

El cloudchat muestra el desglose de todos los códigos de error de Meta

Errores más comunes y explicación detallada sobre ellos

🔴 131049 – WhatsApp – Incumplimiento de Políticas

• Descripción: Mensaje no entregado para mantener una interacción saludable del ecosistema

• Canal: WhatsApp

• Qué significa: WhatsApp bloqueó la entrega por incumplimiento de políticas.

• Causas comunes:

  • Contenido considerado spam o de baja calidad.

  • Alta tasa de bloqueos/reportes de usuarios.

  • Falta de opt-in válido.

• Acción recomendada:

  • Revisar las plantillas aprobadas y el lenguaje utilizado.

  • Mejorar la recolección de opt-ins.

  • Monitorear métricas de calidad en Meta Business Manager.

🟠 131026 – WhatsApp – Mensaje no entregable (genérico)

• Descripción: Mensaje no entregado

• Canal: WhatsApp

• Qué significa: No se pudo entregar el mensaje, sin detalles específicos.

• Causas comunes:

  • Número inválido, desactivado o bloqueado.

  • El usuario desinstaló la aplicación.

  • Error temporal en la infraestructura de Meta.

• Acción recomendada:

  • Validar los números antes de enviar.

  • Asegurar opt-in actualizado.

  • Reintentar envíos en caso de error transitorio.

🟡 131048 – WhatsApp – Límite de tasa de spam alcanzado

• Descripción: Límite de tasa de spam alcanzado

• Canal: WhatsApp

• Qué significa: La cuenta superó el límite de envío permitido.

• Causas comunes:

  • Volumen de envíos por encima del nivel de calidad.

  • Cuenta con reputación baja.

• Acción recomendada:

  • Segmentar envíos.

  • Monitorear métricas de reputación.

  • Solicitar revisión de límites, si es necesario.

🟡 63024 – Twilio/Correo Electrónico/WhatsApp – Error genérico de API

• Descripción: Código de error genérico de API de WhatsApp Cloud

• Canal: Multicanal (Twilio, Email, WhatsApp)

• Qué significa: Error genérico de la API, sin detalles específicos de la causa.

• Causas comunes:

  • Tiempo de espera o fallo en la red.

  • Payload inválido.

  • Error transitorio en la API.

• Acción recomendada:

  • Implementar reintento automático.

  • Validar payloads.

  • Escalar al soporte del proveedor en caso de repetición.

🟡 130472 – WhatsApp – Usuario no elegible

• Descripción: El número del usuario forma parte de un experimento / no es elegible

• Canal: WhatsApp

• Qué significa: El número del usuario no puede recibir mensajes en este momento.

• Causas comunes:

  • Número en sandbox/prueba de Meta.

  • Usuario no habilitado para recibir mensajes comerciales.

• Acción recomendada:

  • Confirmar la elegibilidad del número.

  • Escalar al proveedor si es recurrente.

🟠 #100 – Facebook – Acción inválida

• Descripción: Acción inválida (no es propietario del tema / llamada a API inválida)

• Canal: Facebook (API)

• Qué significa: La llamada realizada no es válida.

• Causas comunes:

  • Endpoint incorrecto.

  • Token sin permisos.

  • Parámetros no válidos.

• Acción recomendada:

  • Revisar payloads y permisos.

  • Consultar la documentación de la API Graph.

🔴 131042 – WhatsApp – Problema de elegibilidad empresarial

• Descripción: Pago o cuenta no permitidos

• Canal: WhatsApp

• Qué significa: La cuenta no está apta para enviar mensajes.

• Causas comunes:

  • Empresa en categoría restringida.

  • Falta de verificación en el Business Manager.

  • Pago pendiente.

• Acción recomendada:

  • Resolver la facturación.

  • Verificar la elegibilidad en Meta Business Manager.

🟡 131047 – WhatsApp – Reintento de reenganche fallido

• Descripción: Se excedió la ventana de 24h – Reintento de mensaje de reenganche fallido

• Canal: WhatsApp

• Qué significa: Se envió un mensaje fuera de la ventana de 24h sin usar plantilla.

• Causas comunes:

  • Respuesta enviada después del límite permitido.

• Acción recomendada:

  • Usar plantillas aprobadas para reenganche.

  • Configurar alertas para respetar la ventana.

🟡 Errores adicionales (por canal):

• Correo Electrónico:

  • 451 4.7.1 → Límite de velocidad alcanzado en el servidor de correo.

  • 535-5.7.8 → Fallo en la autenticación SMTP.

  • 003 → Tiempo de espera de red en envío.

  • 2603 → Red inalcanzable.

• Twilio:

  • 21617 → El mensaje supera los 1600 caracteres.

  • 63007 → Canal “From” inválido.

  • 63018 → Límite de velocidad.

  • 63049 / 63032 / 63016 → Errores genéricos del proveedor.