Síntoma / Necesidad

Recibir notificaciones en tiempo real sobre errores en el envío de mensajes de WhatsApp.

Contexto / Escenarios

Esta funcionalidad permite a los clientes gestionar errores mediante eventos enviados directamente a sus webhooks. Los escenarios más comunes incluyen:

• Monitoreo proactivo para identificar problemas.
• Registro y trazabilidad de errores para análisis y resolución.

Respuesta (Solución / Recomendación)

Códigos de error entregados por Meta y su descripción:

131026 El mensaje no se puede entregar

• Motivos comunes:
  • El número no pertenece a WhatsApp.
  • Plantillas de autenticación no disponibles para usuarios en India.
  • El destinatario no ha aceptado las nuevas condiciones de servicio.
  • El destinatario usa una versión antigua de WhatsApp.
• Acciones recomendadas:
  • Verifique que el destinatario pueda recibir mensajes.
  • Asegúrese de que las condiciones de servicio y la versión de la aplicación estén actualizadas.

131042 Problema de pago relacionado con la idoneidad de la empresa

• Motivos comunes:
  • La cuenta de pago no está vinculada o activa.
  • Se superó el límite de crédito.
  • Configuración incompleta (zona horaria, divisa).
• Acciones recomendadas:
  • Verifique la configuración de facturación en su cuenta de WhatsApp Business.

130472 El número del usuario forma parte de un experimento

• Motivos comunes:
  • El mensaje no se envió debido a un experimento.
• Acciones recomendadas:
  • Consulte la documentación sobre experimentos de mensajes de marketing.

131049 Meta ha decidido no entregarlo

• Motivos comunes:
  • Límites aplicados para proteger el ecosistema.
• Acciones recomendadas: 
  • Espere antes de reenviar el mensaje.
  • Consulte los límites de mensajes para más información.

131048 Se ha alcanzado el límite de frecuencia de spam

• Motivos comunes:
  • Restricciones en la cantidad de mensajes enviados debido a bloqueos o marca como spam.
• Acciones recomendadas:
  • Verifique el estado de calidad en el Administrador de WhatsApp.
  • Revise los límites de frecuencia basados en la calidad.

131031 La cuenta se ha bloqueado

• Motivos comunes:
  • Incumplimiento de políticas o errores en la verificación de datos.
• Acciones recomendadas:
  • Revise el cumplimiento de políticas y utilice la API de estado para más detalles.

132000 Error de coincidencia del recuento de parámetros de la plantilla

• Motivos comunes:
  • Discrepancias entre los parámetros definidos y los enviados.
• Acciones recomendadas:
  • Asegúrese de incluir todos los parámetros requeridos.

100 Parámetro no válido

• Motivos comunes:
  • Parámetros mal escritos o no admitidos.
• Acciones recomendadas:
  • Verifique que los parámetros sean válidos y cumplan con las especificaciones.

131053 Error de subida de contenido multimedia

• Motivos comunes:
  • Tipo de contenido no admitido.
• Acciones recomendadas:
  • Confirme que el contenido multimedia cumple con los formatos admitidos.