Metrics

Métricas do Twilio pela API

Seu cliente conecta a conta do Twilio e seu produto consulta 40 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

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"
      ]
    }
  ]
}
Exemplo: "Mensagens enviadas" em outubro, comparado a setembro.

Mais exemplos de chamadas no Twilio

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Mensagens ao longo do tempo

Mensagens enviadas e recebidas em cada dia do período. A Twilio agrupa o uso por dia em UTC, então um dia aqui pode não coincidir exatamente com o calendário 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"
      ]
    }
  ]
}

Tabela

Volume e gasto por canal

Mensagens e valor cobrado por canal no 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

Mensagens recebidas

Mensagens SMS e MMS recebidas nos seus números da Twilio no 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

  • Mensagens enviadas

    Mensagens SMS, MMS e WhatsApp enviadas no período, contadas pelos registros de uso da Twilio.

    twilio:messages_sent
  • Mensagens recebidas

    Mensagens SMS e MMS recebidas nos seus números da Twilio no período.

    twilio:messages_received
  • Total de mensagens

    Todas as mensagens enviadas e recebidas no período, somando SMS, MMS e WhatsApp.

    twilio:messages_total
  • SMS enviados

    Mensagens SMS enviadas no período.

    twilio:sms_sent
  • SMS recebidos

    Mensagens SMS recebidas no período.

    twilio:sms_received
  • MMS enviados

    Mensagens MMS enviadas no período. A Twilio só oferece MMS nos Estados Unidos e no Canadá, então contas fora desses países sempre reportam zero.

    twilio:mms_sent
  • MMS recebidos

    Mensagens MMS recebidas no período. A Twilio só oferece MMS nos Estados Unidos e no Canadá, então contas fora desses países sempre reportam zero.

    twilio:mms_received
  • Mensagens de WhatsApp

    Mensagens de template e de atendimento enviadas por WhatsApp no período. Janelas de conversa gratuitas são cobradas à parte e não entram nesta contagem.

    twilio:whatsapp_messages
  • Segmentos de mensagem

    Segmentos cobráveis em todas as mensagens do período. Um texto longo é dividido em vários segmentos, e é isso que a Twilio cobra.

    twilio:message_segments
  • Mensagens entregues

    Mensagens enviadas com entrega confirmada pela operadora, incluindo mensagens de WhatsApp marcadas como lidas.

    twilio:delivered_messages
  • Mensagens não entregues

    Mensagens aceitas pela operadora que não puderam ser entregues, geralmente porque o número está inacessível ou bloqueado.

    twilio:undelivered_messages
  • Mensagens com falha

    Mensagens que a Twilio não conseguiu entregar à operadora.

    twilio:failed_messages
  • Taxa de entrega

    Percentual de mensagens enviadas com entrega confirmada, sobre as mensagens que chegaram a um estado final. Mensagens ainda em trânsito ficam fora do cálculo.

    twilio:delivery_rate
  • Taxa de falha

    Percentual de mensagens enviadas que falharam ou não foram entregues, sobre as mensagens que chegaram a um estado final.

    twilio:failure_rate
  • Total de ligações

    Ligações atendidas pela conta no período, recebidas e realizadas.

    twilio:calls_total
  • Ligações recebidas

    Ligações recebidas nos seus números da Twilio no período.

    twilio:calls_inbound
  • Ligações realizadas

    Ligações realizadas pela conta no período.

    twilio:calls_outbound
  • Minutos de chamada

    Minutos de voz cobrados no período. A Twilio arredonda cada chamada para o minuto seguinte, então este é o valor cobrado e não o tempo exato de conversa.

    twilio:call_minutes
  • Duração média da chamada

    Tempo médio de conversa das ligações atendidas, medido em segundos reais e não em minutos cobrados.

    twilio:avg_call_duration
  • Ligações atendidas

    Ligações que foram atendidas e concluídas no período.

    twilio:completed_calls
  • Ligações ocupadas

    Ligações que encontraram sinal de ocupado.

    twilio:busy_calls
  • Ligações sem resposta

    Ligações que tocaram e não foram atendidas.

    twilio:no_answer_calls
  • Ligações com falha

    Ligações que não puderam ser conectadas.

    twilio:failed_calls
  • Taxa de atendimento

    Percentual de ligações atendidas, sobre as ligações que chegaram a um estado final.

    twilio:answer_rate
  • Gasto Total

    Tudo o que a Twilio cobrou da conta no período, conforme o total de uso informado por ela. Os custos são estimativas até a Twilio fechar a fatura.

    twilio:total_spend
  • Gasto com SMS e MMS

    Valor cobrado pelo tráfego de SMS e MMS no período.

    twilio:messaging_spend
  • Gasto com WhatsApp

    Valor cobrado pelo tráfego de WhatsApp no período. A Meta passou a cobrar por template em julho de 2025, então comparações que atravessam essa data não são equivalentes.

    twilio:whatsapp_spend
  • Gasto com voz

    Valor cobrado pelas ligações de voz no período.

    twilio:voice_spend
  • Gasto com números

    Valor cobrado pelos números de telefone mantidos pela conta.

    twilio:phone_numbers_spend

Gráficos

6 métricas

  • Mensagens ao longo do tempo

    Mensagens enviadas e recebidas em cada dia do período. A Twilio agrupa o uso por dia em UTC, então um dia aqui pode não coincidir exatamente com o calendário local.

    twilio:messages_by_day
  • Taxa de entrega ao longo do tempo

    Percentual de mensagens entregues em cada dia do período. A Twilio agrupa por dia em UTC, então um dia aqui pode não coincidir exatamente com o calendário local.

    twilio:delivery_rate_by_day
  • Ligações ao longo do tempo

    Ligações atendidas em cada dia do período. A Twilio agrupa por dia em UTC, então um dia aqui pode não coincidir exatamente com o calendário local.

    twilio:calls_by_day
  • Gasto ao longo do tempo

    Valor cobrado pela Twilio em cada dia do período. A Twilio agrupa por dia em UTC, então um dia aqui pode não coincidir exatamente com o calendário local.

    twilio:spend_by_day
  • Mensagens por canal

    Como o volume de mensagens do período se divide entre SMS, MMS e WhatsApp.

    twilio:messages_by_channel
  • Mensagens por direção

    Como o volume de mensagens do período se divide entre enviadas e recebidas.

    twilio:messages_by_direction

Tabelas

5 métricas

  • Volume e gasto por canal

    Mensagens e valor cobrado por canal no período.

    twilio:channel_summary
  • Gasto por produto

    Valor cobrado pela Twilio por produto no período. O que não se encaixa nos produtos listados é agrupado em Outros, então as linhas sempre somam o gasto total.

    twilio:spend_by_category
  • Mensagens enviadas por status

    Estado final das mensagens enviadas no período, conforme informado pela Twilio. Mensagens recebidas não entram.

    twilio:messages_by_status
  • Erros mais frequentes

    Códigos de erro da Twilio que apareceram com mais frequência no período, com a mensagem devolvida por ela para cada um.

    twilio:top_error_codes
  • Ligações por status

    Estado final das ligações no período, conforme informado pela Twilio.

    twilio:calls_by_status

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.