Error 131057 de WhatsApp: cuenta comercial en mantenimiento
El error 131057 indica que la cuenta de WhatsApp Business está en modo de mantenimiento, por lo que sus peticiones se rechazan durante un breve periodo. La descripción de Meta es "Business Account is in maintenance mode." Una causa que indica Meta es una actualización de throughput, que tarda hasta un minuto. Espera y reintenta en lugar de cambiar nada en la petición.
Código de Meta para "Business Account is in maintenance mode."
Tiempo máximo que tarda una actualización de throughput, durante el cual el número devuelve 131057.
Throughput fijo para números usados con la app de WhatsApp Business y Cloud API.
¿Qué significa el error 131057 de WhatsApp?
Significa que Meta ha puesto la cuenta de WhatsApp Business en modo de mantenimiento y no acepta peticiones para ella en ese momento.
La referencia de Cloud API muestra el texto detallado "Business Account is in maintenance mode" y explica que una causa podría ser una actualización de throughput de la cuenta. La expresión «una causa» es importante: Meta menciona la actualización como una causa posible, no como la única.
La petición no tiene ningún problema. Se espera que la misma llamada, enviada sin cambios cuando termine el mantenimiento, funcione correctamente. Por eso, en este tipo de código, esperar es toda la solución.
¿Por qué una actualización de throughput provoca el error 131057?
Porque el número no se puede usar durante unos instantes mientras se cambia a la tasa superior.
La guía de throughput de Meta indica que Cloud API admite hasta 80 mensajes por segundo de forma predeterminada y hasta 1.000 mediante una actualización automática. El proceso puede tardar hasta un minuto. Durante ese tiempo, el número no se puede usar en la plataforma y cualquier petición de API devuelve 131057. Después de la primera actualización, los aumentos posteriores se realizan sin tiempo de inactividad.
La guía enumera las condiciones de elegibilidad: un límite de mensajería ilimitado en el Portafolio Comercial, al menos 100K usuarios únicos contactados fuera de una ventana de atención en 24 horas móviles y una calificación de calidad Media o superior.
¿Se aplica el error 131057 a un número de Coexistencia?
Puede aparecer en cualquier número, pero la explicación basada en throughput encaja peor con los números de Coexistencia.
La guía de throughput de Meta indica que los números usados con la app de WhatsApp Business y Cloud API tienen un throughput fijo de 20 mensajes por segundo para mantener la compatibilidad con la app. La actualización automática a 1.000 descrita en la misma guía se aplica a los números del nivel predeterminado.
Por tanto, en un número de Coexistencia, interpreta 131057 por su significado literal, una cuenta en modo de mantenimiento, y espera antes de reintentar. Si persiste mucho más de unos minutos, contacta con el soporte de Meta e incluye el fbtrace_id de la respuesta en lugar de volver a conectar el número.
Errores comunes
- Editar la petición. La petición es válida, así que cambiarla no ayuda mientras la cuenta está en mantenimiento.
- Reintentar sin esperar. Durante una actualización, cada llamada realizada en ese minuto devuelve el mismo código.
- Volver a conectar el número. El modo de mantenimiento está del lado de Meta y termina sin ninguna acción por parte de la empresa.
EasyCoexistence consulta el nivel de throughput junto con la calificación de calidad y el nivel de mensajería de cada número conectado, por lo que el throughput real del número se ve en el panel.
Preguntas frecuentes
¿Cuánto dura el modo de mantenimiento?
Meta indica que una actualización de throughput tarda hasta un minuto. Meta no publica una duración para otras causas de mantenimiento.
¿Recibiré un aviso cuando termine la actualización?
Sí. Meta envía un webhook phone_number_quality_update con el evento establecido en THROUGHPUT_UPGRADE cuando se actualiza el número.
¿Un throughput mayor cuesta más?
No. La guía de throughput de Meta indica que la actualización es gratuita y no afecta a los precios.
¿Está relacionado el error 131057 con el 130429?
Indirectamente. El 130429 significa que enviaste mensajes más rápido de lo permitido por tu throughput. El 131057 puede aparecer mientras se aumenta ese throughput.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el