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"
]
}
]
}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_sentMensagens recebidas
Mensagens SMS e MMS recebidas nos seus números da Twilio no período.
twilio:messages_receivedTotal de mensagens
Todas as mensagens enviadas e recebidas no período, somando SMS, MMS e WhatsApp.
twilio:messages_totalSMS enviados
Mensagens SMS enviadas no período.
twilio:sms_sentSMS recebidos
Mensagens SMS recebidas no período.
twilio:sms_receivedMMS 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_sentMMS 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_receivedMensagens 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_messagesSegmentos 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_segmentsMensagens entregues
Mensagens enviadas com entrega confirmada pela operadora, incluindo mensagens de WhatsApp marcadas como lidas.
twilio:delivered_messagesMensagens 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_messagesMensagens com falha
Mensagens que a Twilio não conseguiu entregar à operadora.
twilio:failed_messagesTaxa 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_rateTaxa de falha
Percentual de mensagens enviadas que falharam ou não foram entregues, sobre as mensagens que chegaram a um estado final.
twilio:failure_rateTotal de ligações
Ligações atendidas pela conta no período, recebidas e realizadas.
twilio:calls_totalLigações recebidas
Ligações recebidas nos seus números da Twilio no período.
twilio:calls_inboundLigações realizadas
Ligações realizadas pela conta no período.
twilio:calls_outboundMinutos 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_minutesDuraçã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_durationLigações atendidas
Ligações que foram atendidas e concluídas no período.
twilio:completed_callsLigações ocupadas
Ligações que encontraram sinal de ocupado.
twilio:busy_callsLigações sem resposta
Ligações que tocaram e não foram atendidas.
twilio:no_answer_callsLigações com falha
Ligações que não puderam ser conectadas.
twilio:failed_callsTaxa de atendimento
Percentual de ligações atendidas, sobre as ligações que chegaram a um estado final.
twilio:answer_rateGasto 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_spendGasto com SMS e MMS
Valor cobrado pelo tráfego de SMS e MMS no período.
twilio:messaging_spendGasto 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_spendGasto com voz
Valor cobrado pelas ligações de voz no período.
twilio:voice_spendGasto 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_dayTaxa 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_dayLigaçõ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_dayGasto 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_dayMensagens por canal
Como o volume de mensagens do período se divide entre SMS, MMS e WhatsApp.
twilio:messages_by_channelMensagens 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_summaryGasto 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_categoryMensagens enviadas por status
Estado final das mensagens enviadas no período, conforme informado pela Twilio. Mensagens recebidas não entram.
twilio:messages_by_statusErros 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_codesLigaçõ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.
