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"
      ]
    }
  ]
}
Ejemplo: "Mensajes enviados" en octubre, comparado con septiembre.

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_sent
  • Mensajes recibidos

    Mensajes SMS y MMS recibidos en tus números de Twilio en el período.

    twilio:messages_received
  • Total de mensajes

    Todos los mensajes enviados y recibidos en el período, sumando SMS, MMS y WhatsApp.

    twilio:messages_total
  • SMS enviados

    Mensajes SMS enviados en el período.

    twilio:sms_sent
  • SMS recibidos

    Mensajes SMS recibidos en el período.

    twilio:sms_received
  • MMS 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_sent
  • MMS 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_received
  • Mensajes 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_messages
  • Segmentos 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_segments
  • Mensajes entregados

    Mensajes enviados con entrega confirmada por el operador, incluyendo mensajes de WhatsApp marcados como leídos.

    twilio:delivered_messages
  • Mensajes no entregados

    Mensajes aceptados por el operador que no pudieron ser entregados, generalmente porque el número está inaccesible o bloqueado.

    twilio:undelivered_messages
  • Mensajes con fallo

    Mensajes que Twilio no pudo entregar al operador.

    twilio:failed_messages
  • Cargo 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_rate
  • Tasa de fallo

    Porcentaje de mensajes enviados que fallaron o no fueron entregados, sobre los mensajes que llegaron a un estado final.

    twilio:failure_rate
  • Total de llamadas

    Llamadas atendidas por la cuenta en el período, recibidas y realizadas.

    twilio:calls_total
  • Llamadas recibidas

    Llamadas recibidas en sus números de Twilio en el período.

    twilio:calls_inbound
  • Llamadas realizadas

    Llamadas realizadas por la cuenta en el período.

    twilio:calls_outbound
  • Minutos 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_minutes
  • Duració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_duration
  • Llamadas respondidas

    Llamadas que fueron atendidas y concluidas en el período.

    twilio:completed_calls
  • Llamadas ocupadas

    Llamadas que encontraron señal de ocupado.

    twilio:busy_calls
  • Llamadas sin respuesta

    Llamadas que sonaron y no fueron atendidas.

    twilio:no_answer_calls
  • Llamadas con fallo

    Llamadas que no pudieron ser conectadas.

    twilio:failed_calls
  • Tasa de atención

    Porcentaje de llamadas atendidas, sobre las llamadas que llegaron a un estado final.

    twilio:answer_rate
  • Gasto 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_spend
  • Gasto con SMS y MMS

    Valor cobrado por el tráfico de SMS y MMS en el período.

    twilio:messaging_spend
  • Gasto 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_spend
  • Gasto con voz

    Valor cobrado por las llamadas de voz en el período.

    twilio:voice_spend
  • Gasto 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_day
  • Tasa 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_day
  • Llamadas 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_day
  • Gasto 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_day
  • Mensajes por canal

    Cómo se divide el volumen de mensajes del período entre SMS, MMS y WhatsApp.

    twilio:messages_by_channel
  • Mensajes 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_summary
  • Gasto 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_category
  • Mensajes 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_status
  • Errores 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_codes
  • Llamadas 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.