Conoce los errores que puede devolver Meta en tu reporte de gestión de HSM
Errores de autorización
|
Código |
Descripción |
Posibles soluciones |
Código de estado HTTP |
|---|---|---|---|
|
0 |
AuthException - No se pudo autenticar al usuario de la app. |
Obtener un nuevo token de acceso. |
401 (No autorizado) |
|
3 |
Método de la API - Problema de función o permisos. |
Usar el depurador de token de acceso para verificar permisos. |
500 (Error de servidor interno) |
|
10 |
Permiso denegado - No se otorgó el permiso o se eliminó. |
Verificar permisos y configuración del número de teléfono. |
403 (Prohibido) |
|
190 |
El token de acceso caducó. |
Obtener un nuevo token de acceso. |
401 (No autorizado) |
|
200-299 |
Permiso de la API - No se otorgó el permiso o se eliminó. |
Usar el depurador de token de acceso para verificar permisos. |
403 (Prohibido) |
Errores de integridad
|
Código |
Descripción |
Posibles soluciones |
Código de estado HTTP |
|---|---|---|---|
|
368 |
Bloqueado temporalmente por infracción de políticas. |
Revisar la aplicación de políticas de WhatsApp. |
403 (Prohibido) |
|
130497 |
La cuenta de empresa no puede enviar mensajes a los usuarios de este país. |
Consultar la política de mensajes de WhatsApp Business. |
403 (Prohibido) |
|
131031 |
Se bloqueó la cuenta. |
Revisar la aplicación de políticas y usar la API de estado general. |
403 (Prohibido) |
Otros errores
| Código | Descripción | Posibles soluciones | Código de estado HTTP |
|---|---|---|---|
| 1 | API desconocida | Verifica el estado de la API de WhatsApp Business y revisa la referencia del punto de conexión. | 400 (Solicitud incorrecta) |
| 2 | Servicio de API | Posible sobrecarga o caída del servidor. Consulta el estado de la API antes de intentarlo de nuevo. | 503 (Servicio no disponible) |
| 33 | El valor del parámetro no es válido | El número de teléfono de la empresa fue eliminado. Verifica que sea correcto. | 400 (Solicitud incorrecta) |
| 100 | Parámetro inválido | Se incluyeron parámetros incorrectos o no admitidos. Revisa la documentación. | 400 (Solicitud incorrecta) |
| 130472 | El número del usuario es parte de un experimento | El mensaje no se envió porque es parte de un experimento de WhatsApp. | 400 (Solicitud incorrecta) |
| 131000 | Se produjo un error | Error desconocido al enviar un mensaje o configurar clave pública. Inténtalo de nuevo o abre un ticket de soporte. | 500 (Error de servidor interno) |
| 131005 | Acceso denegado | No tienes los permisos necesarios. Usa el depurador de token de acceso. | 403 (Prohibido) |
| 131008 | Falta un parámetro obligatorio | Revisa la documentación para asegurarte de incluir todos los parámetros requeridos. | 400 (Solicitud incorrecta) |
| 131009 | El valor del parámetro no es válido | Uno o más valores no son compatibles. Consulta la documentación. | 400 (Solicitud incorrecta) |
| 131016 | Servicio no disponible | La API puede estar caída. Consulta el estado antes de intentarlo de nuevo. | 500 (Error de servidor interno) |
| 131021 | El destinatario no puede ser el emisor | No puedes enviar un mensaje al mismo número de teléfono que emite el mensaje. | 400 (Solicitud incorrecta) |
| 131026 | El mensaje no se puede enviar | El destinatario podría no tener WhatsApp, no haber aceptado los términos o estar usando una versión antigua. | 400 (Solicitud incorrecta) |
| 131037 | Falta la aprobación del nombre para mostrar | El número de teléfono del negocio no tiene un nombre para mostrar aprobado. | 400 (Solicitud incorrecta) |
| 131042 | Problema de pago | Puede haber un error con el método de pago o la configuración de la cuenta. Revisa la facturación. | 400 (Solicitud incorrecta) |
| 131045 | Certificado incorrecto | Error en el registro del número de teléfono. Regístralo antes de intentarlo de nuevo. | 500 (Error de servidor interno) |
| 131047 | Mensajes de nueva interacción | Pasaron más de 24 horas desde la última respuesta del destinatario. Usa una plantilla de mensaje aprobada. | 400 (Solicitud incorrecta) |
Errores de sincronización
| Código | Descripción | Posibles soluciones | Código de estado HTTP |
|---|---|---|---|
| 2593107 | Se superó el límite de solicitudes de sincronización | Solo puedes llamar a este punto de conexión una vez para sincronizar los contactos y otra para el historial de mensajes. Consulta "Registro de usuarios de aplicaciones empresariales". Si es necesario, elimina al cliente comercial y vuelve a registrarlo. | 400 (Solicitud incorrecta) |
| 2593108 | La solicitud de sincronización se realizó fuera del período de tiempo permitido | La sincronización solo es posible dentro de las 24 horas posteriores al registro del usuario en WhatsApp Business. Consulta "Registro de usuarios de aplicaciones empresariales". Si es necesario, elimina al cliente comercial y vuelve a registrarlo. | 400 (Solicitud incorrecta) |
Errores de limitación
| Código | Descripción | Posibles soluciones | Código de estado HTTP |
|---|---|---|---|
| 4 | Demasiadas llamadas a la API | Consulta la sección "Límite de frecuencia de la app" en el panel de apps. Si se alcanzó el límite, intenta más tarde o reduce la frecuencia de las consultas a la API. | 400 (Solicitud incorrecta) |
| 80007 | Problemas de límite de frecuencia | La cuenta de WhatsApp Business alcanzó su límite de frecuencia. Revisa los límites y reduce la cantidad de consultas o espera antes de intentarlo de nuevo. | 400 (Solicitud incorrecta) |
| 130429 | Se alcanzó el límite de frecuencia | La API de la nube alcanzó su límite de rendimiento. Consulta la documentación sobre "Rendimiento". Reduce la frecuencia de envío de mensajes o intenta más tarde. | 400 (Solicitud incorrecta) |
| 131048 | Se alcanzó el límite de frecuencia de spam | No se pudo enviar el mensaje debido a restricciones por cantidad de mensajes enviados desde el número. Esto puede deberse a bloqueos o marcas de spam previas. Consulta el estado de calidad en el administrador de WhatsApp y revisa los límites según la calidad. | 400 (Solicitud incorrecta) |
| 131056 | Límite de frecuencia de la combinación empresa-cliente | Se enviaron demasiados mensajes desde el número de teléfono del emisor al mismo destinatario en poco tiempo. Espera y reintenta más tarde. Aún puedes enviar mensajes a otros números sin restricciones. | 400 (Solicitud incorrecta) |
| 133016 | Se excedió el límite de frecuencia de anulación del registro | Se realizaron demasiados intentos de registro o anulación del registro en poco tiempo. El número fue bloqueado temporalmente. Intenta nuevamente cuando el número esté desbloqueado y revisa la sección "Limitaciones" en el documento de Registro. | 400 (Solicitud incorrecta) |