logo
enes

Semaforización

Last update: 4 days ago by Irais Aguirre

Permite monitorear la calidad de los números de teléfono y de las plantillas de una cuenta de WhatsApp Business (WABA), según la calificación que les asigna Meta, y consultar los números de teléfono de la cuenta.

Los endpoints disponibles son:

  • Listar números de teléfono de la WABA.
  • Consultar la calidad de los números de teléfono de la WABA.
  • Consultar la calidad de las plantillas de la WABA.

Todos los endpoints usan el token de administración. Consulta Generar Token de Autenticación.

Calificación de calidad

Meta califica la calidad de cada número de teléfono (qualityRating) y de cada plantilla (qualityScore) con un color:

  • GREEN: calidad alta.
  • YELLOW: calidad media.
  • RED: calidad baja.
  • UNKNOWN: Meta aún no tiene suficiente información para calificar.

El valor UNKNOWN es normal en estos casos:

  • Número o plantilla nuevos: todavía no se han usado lo suficiente para que Meta reúna métricas como tasa de entrega, bloqueos o reportes de spam.
  • Poco volumen de envío: con pocos mensajes no hay datos suficientes para una calificación confiable. Es común en ambientes de desarrollo o de pruebas.
  • Evaluación periódica de Meta: Meta recalcula la calidad cada cierto tiempo, así que puede haber un desfase entre el uso de un número o plantilla y su calificación.

Actualización de la información

Para no agotar el límite de peticiones a Meta, la primera consulta de una WABA obtiene la información de Meta y la guarda durante 12 horas. Durante ese periodo, el servicio responde con la información guardada, sin volver a consultar a Meta. Al terminar el periodo, la siguiente consulta vuelve a obtener la información de Meta.

El campo processedAt de la respuesta indica cuándo se obtuvo la información de Meta, es decir, cuándo empezó su periodo de 12 horas.

Páginas de esta sección:

Anterior
Códigos de error
Siguiente
Números de teléfono