El webhook phone_number_quality_update
phone_number_quality_update informa cambios de throughput y de límite de mensajes de un número. En 2026 no lleva la calificación de calidad verde, amarilla o roja, a pesar de su nombre, y esa calificación hay que consultarla en el número.
El año en que el contenido de este campo dejó de ser la calificación por color.
Calificaciones de calidad que puede tener un número: verde, amarilla y roja, y ninguna llega aquí.
El error que devuelve un número una vez que la limitación por calidad entra en vigor.
¿Qué contiene realmente este webhook?
Información de throughput y de límite de mensajes, entregada como un valor de evento más campos que llevan el límite actual.
El contenido práctico es que la capacidad de un número cambió: pasó a otro tramo de mensajes, o se ajustó su nivel de throughput. Esos datos vale registrarlos porque cambian lo que una integración puede hacer, y porque un tramo que baja es una señal temprana.
Lo que no está en él, pese al nombre del campo, es la calificación de calidad. Un handler escrito contra documentación antigua va a buscar GREEN, YELLOW o RED aquí, no va a encontrar nada, y entonces va a concluir que la calidad nunca cambia.
¿De dónde sale entonces la calificación por color?
De leer el número de teléfono directamente, en una rutina periódica.
El campo quality_rating vive en el objeto del número de teléfono en la Graph API, y hay que consultarlo en vez de esperarlo. Por eso monitorear bien una conexión necesita un poller además de un receptor de webhook: los dos llevan cosas distintas y ninguno basta por sí solo.
También por eso una caída de calidad es invisible para la mayoría de las integraciones. Nada la empuja, la app de WhatsApp Business no da ninguna señal de ella, y cuando produce el error 131048 los envíos afectados ya fallaron.
Errores comunes
- Buscar GREEN, YELLOW o RED en este payload. En 2026 no está ahí.
- Construir el monitoreo solo con webhooks. La calificación de calidad hay que consultarla.
- Ignorar una bajada de tramo. Suele ser la primera señal visible de un problema.
EasyCoexistence consulta la calificación de calidad, el tramo de mensajes y el nivel de throughput en cada número conectado y registra cada revisión, así una caída se ve antes de costar un envío.
Preguntas frecuentes
¿Por qué el campo lleva el nombre de la calidad, entonces?
Es anterior al cambio. El nombre se quedó mientras el contenido se movió, y por eso esto pilla desprevenida a la gente.
¿Con qué frecuencia hay que consultar la calificación?
Con la suficiente para pillar la caída antes de que se vuelva un límite. Nosotros consultamos en una rutina periódica, no bajo demanda.
¿La app muestra la calificación?
No. Nada sobre ella se ve en la app de WhatsApp Business en el teléfono.
¿El 131048 está relacionado?
Sí. Es el error que un número empieza a devolver cuando una calificación baja se convierte en limitación.
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