Metrics
Métricas de Twilio con la API
Tu cliente conecta su cuenta de Twilio y tu producto consulta 40 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_sent",
"component": "number_v1",
"metrics": [
"messages_sent"
]
}
]
}Más ejemplos de llamadas a Twilio
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Mensajes a lo largo del tiempo
Mensajes enviados y recibidos en cada día del período. Twilio agrupa el uso por día en UTC, así que un día aquí puede no coincidir exactamente con el calendario local.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_by_day",
"component": "chart_v1",
"metrics": [
"messages_sent",
"messages_received"
],
"dimensions": [
"date"
]
}
]
}Tabla
Volumen y gasto por canal
Mensajes y valor cobrado por canal en el período.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:channel_summary",
"component": "datatable_v1",
"metrics": [
"messages_total",
"total_spend"
],
"dimensions": [
"channel"
]
}
]
}Número
Mensajes recibidos
Mensajes SMS y MMS recibidos en tus números de Twilio en el período.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_received",
"component": "number_v1",
"metrics": [
"messages_received"
]
}
]
}Números
29 métricas
Mensajes enviados
Mensajes SMS, MMS y WhatsApp enviados en el período, contados por los registros de uso de Twilio.
twilio:messages_sentMensajes recibidos
Mensajes SMS y MMS recibidos en tus números de Twilio en el período.
twilio:messages_receivedTotal de mensajes
Todos los mensajes enviados y recibidos en el período, sumando SMS, MMS y WhatsApp.
twilio:messages_totalSMS enviados
Mensajes SMS enviados en el período.
twilio:sms_sentSMS recibidos
Mensajes SMS recibidos en el período.
twilio:sms_receivedMMS enviados
Mensajes MMS enviados en el período. Twilio solo ofrece MMS en Estados Unidos y Canadá, por lo que las cuentas fuera de esos países siempre reportan cero.
twilio:mms_sentMMS recibidos
Mensajes MMS recibidos en el período. Twilio solo ofrece MMS en Estados Unidos y Canadá, por lo que las cuentas fuera de esos países siempre reportan cero.
twilio:mms_receivedMensajes de WhatsApp
Mensajes de plantilla y de atención enviados por WhatsApp en el período. Las ventanas de conversación gratuitas se cobran por separado y no entran en este conteo.
twilio:whatsapp_messagesSegmentos de mensaje
Segmentos cobrables en todos los mensajes del período. Un texto largo se divide en varios segmentos, y eso es lo que Twilio cobra.
twilio:message_segmentsMensajes entregados
Mensajes enviados con entrega confirmada por el operador, incluyendo mensajes de WhatsApp marcados como leídos.
twilio:delivered_messagesMensajes no entregados
Mensajes aceptados por el operador que no pudieron ser entregados, generalmente porque el número está inaccesible o bloqueado.
twilio:undelivered_messagesMensajes con fallo
Mensajes que Twilio no pudo entregar al operador.
twilio:failed_messagesCargo de entrega
Porcentaje de mensajes enviados con entrega confirmada, sobre los mensajes que llegaron a un estado final. Mensajes aún en tránsito quedan fuera del cálculo.
twilio:delivery_rateTasa de fallo
Porcentaje de mensajes enviados que fallaron o no fueron entregados, sobre los mensajes que llegaron a un estado final.
twilio:failure_rateTotal de llamadas
Llamadas atendidas por la cuenta en el período, recibidas y realizadas.
twilio:calls_totalLlamadas recibidas
Llamadas recibidas en sus números de Twilio en el período.
twilio:calls_inboundLlamadas realizadas
Llamadas realizadas por la cuenta en el período.
twilio:calls_outboundMinutos de llamada
Minutos de voz cobrados en el período. Twilio redondea cada llamada al minuto siguiente, así que este es el valor cobrado y no el tiempo exacto de conversación.
twilio:call_minutesDuración media de la llamada
Tiempo medio de conversación de las llamadas atendidas, medido en segundos reales y no en minutos cobrados.
twilio:avg_call_durationLlamadas respondidas
Llamadas que fueron atendidas y concluidas en el período.
twilio:completed_callsLlamadas ocupadas
Llamadas que encontraron señal de ocupado.
twilio:busy_callsLlamadas sin respuesta
Llamadas que sonaron y no fueron atendidas.
twilio:no_answer_callsLlamadas con fallo
Llamadas que no pudieron ser conectadas.
twilio:failed_callsTasa de atención
Porcentaje de llamadas atendidas, sobre las llamadas que llegaron a un estado final.
twilio:answer_rateGasto Total
Todo lo que Twilio cobró de la cuenta en el período, conforme al total de uso informado por ella. Los costos son estimaciones hasta que Twilio cierre la factura.
twilio:total_spendGasto con SMS y MMS
Valor cobrado por el tráfico de SMS y MMS en el período.
twilio:messaging_spendGasto con WhatsApp
Valor cobrado por el tráfico de WhatsApp en el período. Meta comenzó a cobrar por plantilla en julio de 2025, así que las comparaciones que cruzan esta fecha no son equivalentes.
twilio:whatsapp_spendGasto con voz
Valor cobrado por las llamadas de voz en el período.
twilio:voice_spendGasto con números
Valor cobrado por los números de teléfono mantenidos por la cuenta.
twilio:phone_numbers_spend
Gráficos
6 métricas
Mensajes a lo largo del tiempo
Mensajes enviados y recibidos en cada día del período. Twilio agrupa el uso por día en UTC, así que un día aquí puede no coincidir exactamente con el calendario local.
twilio:messages_by_dayTasa de entrega a lo largo del tiempo
Porcentaje de mensajes entregados en cada día del período. Twilio agrupa por día en UTC, así que un día aquí puede no coincidir exactamente con el calendario local.
twilio:delivery_rate_by_dayLlamadas a lo largo del tiempo
Llamadas atendidas en cada día del período. Twilio agrupa por día en UTC, así que un día aquí puede no coincidir exactamente con el calendario local.
twilio:calls_by_dayGasto a lo largo del tiempo
Valor cobrado por Twilio en cada día del período. Twilio agrupa por día en UTC, así que un día aquí puede no coincidir exactamente con el calendario local.
twilio:spend_by_dayMensajes por canal
Cómo se divide el volumen de mensajes del período entre SMS, MMS y WhatsApp.
twilio:messages_by_channelMensajes por dirección
Cómo se divide el volumen de mensajes del período entre enviados y recibidos.
twilio:messages_by_direction
Tablas
5 métricas
Volumen y gasto por canal
Mensajes y valor cobrado por canal en el período.
twilio:channel_summaryGasto por producto
Valor cobrado por Twilio por producto en el período. Lo que no se ajusta a los productos listados se agrupa en Otros, por lo que las filas siempre suman el gasto total.
twilio:spend_by_categoryMensajes enviados por estado
Estado final de los mensajes enviados en el período, según lo informado por Twilio. Los mensajes recibidos no se incluyen.
twilio:messages_by_statusErrores más frecuentes
Códigos de error de Twilio que aparecieron con más frecuencia en el período, con el mensaje devuelto por ella para cada uno.
twilio:top_error_codesLlamadas por estado
Estado final de las llamadas en el período, según lo informado por Twilio.
twilio:calls_by_status
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
