Errores comunes en campañas
Cómo diagnosticar y resolver los errores más frecuentes al enviar campañas masivas.
Al enviar campañas masivas, algunos mensajes pueden fallar por distintas razones: números inválidos, plantillas con problemas, límites de la API de Meta, o errores temporales de red. Esta guía te ayuda a identificar y resolver cada tipo de error.
Códigos de error de Meta
| Código | Error | Causa | Solución |
|---|---|---|---|
| 131026 | Destinatario no tiene WhatsApp | El número no está registrado en WhatsApp | Elimina el número de tu lista o verifica que sea correcto |
| 132001 | Plantilla no existe | El nombre o idioma de la plantilla no coincide en Meta | Sincroniza plantillas en Campañas > Plantillas > Sincronizar con Meta |
| 132000 | Parámetros de plantilla inválidos | La cantidad o formato de variables no coincide con la plantilla | Verifica que el CSV tenga el mismo número de columnas que variables en la plantilla |
| 132012 | Plantilla pausada | Meta pausó la plantilla por baja calidad | Revisa la calificación de calidad y crea una nueva plantilla mejorada |
| 132015 | Plantilla deshabilitada | Meta deshabilitó la plantilla permanentemente | Crea una nueva plantilla; la anterior no se puede reactivar |
| 131053 | Media corrupto o inaccesible | El archivo de imagen, video o documento no se pudo procesar | Re-sube el archivo multimedia y verifica que el formato sea compatible |
| 131047 | Se requiere re-engagement | La ventana de 24 horas expiró y se necesita una plantilla aprobada | Usa una plantilla aprobada para recontactar al destinatario |
| 131056 | Límite de pares | Demasiados mensajes al mismo número en poco tiempo | Espera unos minutos antes de reenviar al mismo destinatario |
| 130429 | Límite de velocidad | Envío demasiado rápido para el tier actual | CX Inbox gestiona el throttling automáticamente; no requiere acción |
Errores permanentes vs temporales
CX Inbox clasifica los errores en dos categorías para determinar si un mensaje se puede reintentar:
Errores permanentes
No tiene sentido reintentar estos mensajes. CX Inbox los marca como no recuperables:
- 131026 - Número sin WhatsApp
- 132001 - Plantilla inexistente
- 132000 - Parámetros inválidos
- 132012 / 132015 - Plantilla pausada o deshabilitada
- 131053 - Media corrupto
Errores temporales
CX Inbox reintenta estos mensajes automáticamente:
- 130429 - Límite de velocidad (se reintenta con backoff)
- 131056 - Límite de pares (se reintenta tras espera)
- Errores de red o timeout
- Errores 5xx del servidor de Meta
CX Inbox reintenta automáticamente los mensajes fallidos cada 5 minutos, excepto errores permanentes como números inválidos o plantillas inexistentes.
Cómo diagnosticar errores en una campaña
Vista de detalle de campaña
- Ve a Campañas > Envíos y haz clic en la campaña
- La tabla de destinatarios muestra el estado individual de cada mensaje
- Filtra por estado Fallido para ver solo los errores
- La columna Error muestra el código y mensaje específico de Meta
Acciones en el detalle
| Acción | Descripción |
|---|---|
| Ver conversación | Abre el chat en el inbox para ver el contexto completo |
| Exportar CSV | Descarga un archivo con todos los destinatarios y sus estados |
Pasos generales de diagnóstico
Cuando una campaña tiene una tasa alta de fallos, verifica en este orden:
- Plantilla aprobada: Confirma que la plantilla sigue en estado APPROVED en Campañas > Plantillas. Si fue pausada o rechazada, ese es el problema
- Formato de teléfonos: Los números deben incluir código de país sin
+(ej:5215202665088). Sin código de país, el envío falla - Variables completas: Cada fila del CSV debe tener valores para todas las variables de la plantilla. Variables vacías causan error 132000
- Media válido: Si la plantilla tiene header multimedia, verifica que el archivo se haya subido correctamente y que su formato sea compatible (JPEG/PNG para imagen, MP4 para video, PDF para documento)
- Sincronizar plantillas: Si ves error 132001, haz clic en Sincronizar con Meta para actualizar la lista local
Mensajes fallidos
Los mensajes que no se pudieron entregar aparecen también en Configuración > Mensajes fallidos, donde puedes:
- Ver todos los mensajes fallidos de cualquier origen (campañas e inbox)
- Reintentar mensajes individuales o en lote
- Descartar mensajes con errores permanentes
Para más detalle, consulta la guía de Mensajes fallidos.
Si ves muchos errores 132001 (plantilla no existe) después de cambiar de cuenta de WhatsApp, sincroniza las plantillas. Al conectar un WABA diferente, las plantillas anteriores se eliminan y se importan las del nuevo WABA.
¿Esta página fue útil?