Errores de envío de mensajes WhatsApp

Al enviar mensajes de WhatsApp desde Vixiees pueden producirse errores por diversas razones. Este artículo documenta los errores más comunes, sus causas y cómo resolverlos.

Errores de validación previa

Estos errores se detectan antes de intentar enviar el mensaje:

Error	Causa	Solución
Teléfono no válido	El número de teléfono del contacto no tiene formato válido	Verificar que el número incluya código de país
Teléfono no presente	El contacto no tiene número de teléfono	Añadir número al contacto
Plantilla no aprobada	La plantilla de mensaje no está aprobada en Meta	Esperar aprobación o usar otra plantilla
Plantilla no encontrada	La plantilla especificada no existe	Verificar el nombre de la plantilla
Parámetros incorrectos	El número de parámetros no coincide con la plantilla	Revisar la configuración de la plantilla
Cabecera multimedia inválida	El tipo de archivo no coincide con la plantilla	Usar el tipo de archivo correcto
Texto de botón vacío	Falta el texto de un botón requerido	Completar el texto del botón
Opt-in transaccional ausente	El contacto no ha dado consentimiento	Obtener consentimiento del contacto

Errores de la API de WhatsApp

Estos errores los devuelve la API de WhatsApp Cloud después de intentar enviar:

Error 131000 - Error general

Mensaje: "Something went wrong"
Causa: Error genérico que puede indicar problemas con la cuenta o el ecosistema
Solución: Verificar el estado de la cuenta en Meta Business Manager

Error 131009 / 131026 - Número no válido

Mensaje: "Phone number is not a valid WhatsApp number"
Causa: El número del destinatario no está registrado en WhatsApp
Solución: Verificar que el contacto use WhatsApp en ese número

Error 131030 - Número no permitido en Sandbox

Mensaje: "Phone number not allowed in Sandbox"
Causa: En entorno de pruebas, el número no está en la lista permitida
Solución: Añadir el número a la lista de destinatarios permitidos en Meta

Error 131037 - Nombre de display pendiente

Mensaje: "Display name approval required"
Causa: El número de WhatsApp Business necesita aprobación del nombre
Solución: Completar la verificación del nombre en Meta

Error 132001 - Plantilla no existe en idioma

Mensaje: "Template doesn't exist in language"
Causa: La plantilla no está aprobada para el idioma seleccionado
Solución: Verificar los idiomas aprobados de la plantilla

Error 132005 - Parámetros muy largos

Mensaje: "Template parameter length exceeded"
Causa: El contenido total supera 1024 caracteres
Solución: Reducir la longitud de los parámetros

Error 132016 - Plantilla deshabilitada

Mensaje: "Template permanently disabled"
Causa: La plantilla fue deshabilitada por baja calidad
Solución: Crear una nueva plantilla con mejor contenido

Error 133010 - Cuenta no registrada

Mensaje: "Account not registered"
Causa: La cuenta de WhatsApp Business no está correctamente registrada
Solución: Reconectar la integración de WhatsApp en Vixiees

Estados de mensaje

Los mensajes pueden tener estos estados:

Aceptado: El mensaje fue aceptado por la API
Enviado: El mensaje salió hacia el destinatario
Entregado: El mensaje llegó al dispositivo del destinatario
Leído: El destinatario leyó el mensaje
Fallido: No se pudo enviar el mensaje
No entregado: El mensaje no llegó al destinatario

Dónde ver los errores

Los errores de envío se muestran:

En la burbuja del mensaje dentro del chat (icono de error)
Como notificación emergente al intentar enviar
En el historial de mensajes del contacto

Conclusión

La mayoría de errores de WhatsApp se deben a problemas de formato de número, plantillas no aprobadas o configuración de la cuenta en Meta. Verifica siempre el estado de tu cuenta de WhatsApp Business y las plantillas antes de reportar un problema.

Escenarios relevantes

Equipos comerciales que experimentan fallos en campañas masivas de WhatsApp
Administradores que necesitan diagnosticar problemas de envío recurrentes
Empresas con múltiples números de WhatsApp y diferentes configuraciones de plantillas