Metrics
Métricas do GoHighLevel pela API
Seu cliente conecta a conta do GoHighLevel e seu produto consulta 45 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": "ghl:total_contacts",
"component": "number_v1",
"metrics": [
"total_contacts"
],
"dimensions": [
"contacts"
]
}
]
}Mais exemplos de chamadas no GoHighLevel
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
Contatos ao longo do tempo
Evolução de novos contatos durante o 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": "ghl:contacts_over_time",
"component": "chart_v1",
"metrics": [
"new_contacts"
],
"dimensions": [
"date"
]
}
]
}Tabela
Principais oportunidades
Lista das oportunidades de maior valor 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": "ghl:top_opportunities",
"component": "datatable_v1",
"metrics": [
"value",
"stage",
"status",
"created_at"
],
"dimensions": [
"opportunity_name"
]
}
]
}Número
Novos contatos
Número de novos contatos adicionados no período selecionado.
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": "ghl:new_contacts",
"component": "number_v1",
"metrics": [
"new_contacts"
],
"dimensions": [
"contacts"
]
}
]
}Números
26 métricas
Total de contatos criados
Total de contatos criados até a data atual (todos os tempos).
ghl:total_contactsNovos contatos
Número de novos contatos adicionados no período selecionado.
ghl:new_contactsContatos com e-mail
Quantidade de contatos que possuem endereço de e-mail cadastrado.
ghl:contacts_with_emailContatos sem e-mail
Quantidade de contatos que não possuem endereço de e-mail cadastrado.
ghl:contacts_without_emailContatos com número de telefone
Quantidade de contatos que possuem número de telefone cadastrado.
ghl:contacts_with_phoneContatos sem número de telefone
Quantidade de contatos que não possuem número de telefone cadastrado.
ghl:contacts_without_phoneTotal de oportunidades criadas
Total de oportunidades (negócios) criadas no período.
ghl:total_opportunitiesOportunidades em aberto
Número de oportunidades com status Em Aberto no período selecionado.
ghl:open_opportunitiesValor das oportunidades em aberto
Valor monetário total de todas as oportunidades em aberto no período selecionado.
ghl:open_valueOportunidades ganhas
Número de oportunidades ganhas no período selecionado.
ghl:won_opportunitiesOportunidades perdidas
Número de oportunidades perdidas no período selecionado.
ghl:lost_opportunitiesOportunidades abandonadas
Número de oportunidades com status Abandonado no período selecionado.
ghl:abandoned_opportunitiesValor total das oportunidades
Valor monetário total de todas as oportunidades criadas no período selecionado.
ghl:total_valueValor das oportunidades ganhas
Valor monetário total das oportunidades ganhas no período selecionado.
ghl:won_valueValor das oportunidades perdidas
Valor monetário total das oportunidades perdidas no período selecionado.
ghl:lost_valueValor das oportunidades abandonadas
Valor monetário total das oportunidades abandonadas no período selecionado.
ghl:abandoned_valueTaxa de conversão
Porcentagem de oportunidades ganhas em relação ao total de oportunidades.
ghl:conversion_rateTaxa de ganho
Porcentagem de oportunidades ganhas em relação ao total de oportunidades fechadas (ganhas + perdidas). Taxa de ganho = Ganhas ÷ (Ganhas + Perdidas).
ghl:win_rateTicket médio das oportunidades ganhas
Valor monetário médio das oportunidades ganhas no período selecionado.
ghl:average_won_valueTempo médio para fechar oportunidade
Número médio de dias desde a criação da oportunidade até o fechamento (ganha ou perdida).
ghl:average_close_timeMensagens enviadas
Número total de mensagens (SMS/E-mail) enviadas pelo GoHighLevel no período selecionado.
ghl:messages_sentTotal de conversas
Número total de conversas ativas no período selecionado.
ghl:total_conversationsNovas conversas no período
Número de novas conversas iniciadas no período selecionado.
ghl:new_conversationsConversas não lidas
Número de conversas que possuem mensagens não lidas.
ghl:unread_conversationsTotal de mensagens não lidas
Contagem total de mensagens não lidas em todas as conversas.
ghl:total_unread_messagesTotal de conversas não atribuídas
Número de conversas ainda não atribuídas a nenhum membro da equipe.
ghl:unassigned_conversations
Gráficos
12 métricas
Contatos ao longo do tempo
Evolução de novos contatos durante o período.
ghl:contacts_over_timeOportunidades ao longo do tempo
Evolução do número de oportunidades criadas durante o período.
ghl:opportunities_over_timeValor ao longo do tempo
Evolução do valor total de oportunidades durante o período.
ghl:value_over_timeConversas ao longo do tempo
Evolução do número de conversas durante o período.
ghl:conversations_over_timeOportunidades por estágio do pipeline
Resumo de oportunidades agrupadas por estágio do pipeline.
ghl:opportunities_by_stageQuantidade de oportunidades por status
Número de oportunidades agrupadas por status (aberto, ganho, perdido, abandonado).
ghl:opportunities_by_statusContatos por origem
Distribuição de contatos por origem de aquisição.
ghl:contacts_by_sourceContagem de contatos por tags
Distribuição de contatos agrupados pelas tags atribuídas.
ghl:contacts_by_tagsContagem de contatos por tipo
Distribuição de contatos agrupados por tipo de contato.
ghl:contacts_by_typeContatos por usuário responsável
Contatos mapeados pelos usuários aos quais estão atribuídos.
ghl:contacts_by_assigneeDistribuição de conversas por canal
Distribuição de conversas por tipo de canal (SMS, E-mail, etc.).
ghl:conversations_by_typeConversas por responsável
Número de conversas atribuídas a cada membro da equipe.
ghl:conversations_by_assignee
Tabelas
7 métricas
Principais oportunidades
Lista das oportunidades de maior valor no período.
ghl:top_opportunitiesOportunidades por estágio do pipeline
Resumo de oportunidades agrupadas por estágio do pipeline.
ghl:pipeline_by_stageOportunidades perdidas por motivo
Divisão das oportunidades perdidas pelo motivo da perda.
ghl:lost_by_reasonPrincipais origens de contatos criados
Principais origens de criação de contatos mostrando a contagem por origem.
ghl:contacts_by_source_tableContatos por nome da empresa
Contatos distribuídos por diferentes nomes de empresa.
ghl:contacts_by_companyContatos por usuário responsável
Contatos distribuídos pelo membro da equipe responsável.
ghl:contacts_by_assignee_tableConversas atribuídas
Número de conversas atribuídas a cada membro da equipe.
ghl:conversations_by_assignee_table
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
