Métricas de WhatsApp

La página Metrics en WhatsApp → Metrics muestra el rendimiento de tus envíos de WhatsApp en todo el espacio de trabajo. Para consultar un mensaje individual, usa el registro de WhatsApp. Para ver la página, tu rol en el espacio de trabajo necesita acceso de lectura tanto a WhatsApp como a analíticas.

Consulta tus métricas

Rango, alcance y pestañas

• Outbound / Inbound: la pestaña Outbound cubre los mensajes que enviaste. La pestaña Inbound cuenta los mensajes que recibieron tus números, en total y por número.
• Rango: últimas 24 horas, 7, 30 (por defecto) o 90 días. También puedes arrastrar sobre un gráfico para hacer zoom.
• Alcance: solo en la pestaña Outbound, limita la página a un número, plantilla, categoría de plantilla o etiqueta, de uno en uno. Dos partes de la página ignoran el alcance y siempre cubren todo el espacio de trabajo: la lista de códigos de error y el panel Breakdowns.

Los mensajes se asignan al período en que Bird los aceptó, así que un acuse de entrega que llega hoy actualiza las cifras de ayer. Las horas más recientes pueden mostrar menos entregas de las que tendrán una vez que lleguen todos los acuses.

Mosaicos de resumen

Un mosaico fuera de su rango saludable muestra Needs attention. Revisa las causas de fallo para saber por qué.

Entregas en el tiempo

El gráfico representa los mensajes aceptados, entregados y fallidos por hora (rango de 24 horas) o por día (rangos más largos). Úsalo para detectar un pico, por ejemplo después de enviar una campaña o cuando una plantilla empieza a ser rechazada.

Causas de fallo

El gráfico de tasa de fallo muestra la tasa de fallo a lo largo del rango. Debajo, los fallos se agrupan por código de error, con los más frecuentes primero. La lista muestra hasta 50 códigos que ocurrieron en el rango, así que un código poco frecuente puede faltar en una lista larga. Los códigos de error siempre abarcan todo el espacio de trabajo, aunque limites el alcance de la página. La última fila, Rejected, cuenta los mensajes que Bird rechazó antes de aceptarlos. Estos mensajes no forman parte de la tasa de fallo, así que la fila muestra un recuento sin proporción.

Latencia

La tabla de latencia muestra los tiempos p50, p95 y p99 de tres etapas:

• Procesamiento: desde que Bird acepta el mensaje hasta que lo pasa a WhatsApp.
• Entrega: desde el traspaso a WhatsApp hasta que WhatsApp confirma la entrega en el dispositivo del destinatario.
• Total: ambas etapas juntas.

Una etapa de Delivery lenta suele significar que los teléfonos de los destinatarios estaban sin conexión, algo que Bird no puede controlar. Una etapa de Processing lenta merece investigarse. Si el p50 está bien pero el p99 es lento, la causa suele ser una sola plantilla o un solo destino.

Desgloses

El panel Breakdowns divide los mensajes aceptados, entregados y fallidos por número, plantilla, categoría de plantilla, etiqueta o país. Cada fila se marca como Healthy o Needs attention con los mismos umbrales que los mosaicos de resumen. Cada pestaña muestra las 50 filas principales del rango.

Las etiquetas son las que estableces al enviar. Un mensaje con varias etiquetas aparece en la fila de cada una. Los destinatarios cuyo país no puede identificarse aparecen en ZZ, y los envíos a grupos se excluyen de la pestaña de país.

Acceso programático

Las mismas cifras están disponibles a través de la API, los SDK (bird.whatsapp.stats), la CLI (bird whatsapp stats) y el servidor MCP. Empieza con estos endpoints:

• Estadísticas de resumen, diarias y por hora
• Desgloses por número, plantilla, categoría de plantilla, etiqueta, país y código de error
• Estadísticas de entrada: resumen, diarias, por hora y por número

Cada página de referencia enumera los rangos de tiempo aceptados, los filtros y los campos de respuesta.

Próximos pasos

• Registro de WhatsApp: busca un mensaje individual
• Eventos de estado de mensaje: los eventos a partir de los cuales se construyen estas métricas
• Webhooks de estado de mensaje: recibe cada cambio de estado en el momento en que ocurre