Visão geral

A API Exact Sales da V4MOS.AI entrega os registros brutos sincronizados das contas Exact Sales conectadas à sua organização: leads, vendas, perdas, histórico de etapas e de qualificação, UTMs dos leads, funis, etapas, origens, segmentos, motivos de descarte e usuários. As linhas vêm como foram sincronizadas, com os nomes de coluna do data warehouse (snake_case), prontas para levar ao seu BI. Todos os endpoints usam o prefixo /v1/exact-sales e seguem a mesma autenticação, paginação e formato de resposta.

Primeiros passosCopiar link da seção

URL base: https://data.v4mos.ai. Toda chamada exige suas credenciais de API e o organizationId — veja Autenticação.

1. Conecte a integração Exact Sales em app.v4mos.ai (Contas conectadas) e aguarde a primeira sincronização.
2. Chame qualquer endpoint abaixo com o seu organizationId, por exemplo GET /v1/exact-sales/leads?organizationId=….
3. Toda linha traz integration_id e integration_name: a conta conectada de onde ela veio. Para ler uma conta só, passe esse valor em integrationId.

Endpoints disponíveisCopiar link da seção

• getLeads/v1/exact-sales/leadsUma linha por lead: etapa, funil, previsão de fechamento, origem, sub-origem, segmento, pré-vendedor e vendedor.
• getVendas/v1/exact-sales/salesUma linha por venda fechada a partir de um lead: data, etapa, ciclo, valor total e número de produtos.
• getPerdas/v1/exact-sales/lossesUma linha por lead marcado como perdido: quando, em que etapa e funil, e por quê.
• getHistórico de etapas dos leads/v1/exact-sales/lead-stage-historyUma linha por mudança de etapa de um lead: etapa e funil de origem e de destino, ciclo e dados de descarte.
• getHistórico de qualificação/v1/exact-sales/qualification-historyUma linha por qualificação de um lead: etapa, ciclo, pontuação, data da reunião e ação do usuário.
• getUTMs dos leads/v1/exact-sales/lead-utmsUma linha por parâmetro UTM capturado em um lead (chave e valor).
• getFunis/v1/exact-sales/funnelsUma linha por funil, com o indicador de ativo.
• getEtapas/v1/exact-sales/stagesUma linha por etapa do funil: posição, tipo de gate e indicador de ativo.
• getOrigens/v1/exact-sales/sourcesUma linha por origem de lead, com o tipo e as sub-origens (JSON).
• getSegmentos/v1/exact-sales/industriesUma linha por segmento em que os leads podem ser classificados.
• getMotivos de descarte/v1/exact-sales/discard-reasonsUma linha por motivo de descarte de lead.
• getUsuários/v1/exact-sales/usersUma linha por usuário da conta: função e indicador de ativo.

RecursosCopiar link da seção

Paginação e filtrosCopiar link da seção

• page (padrão 1) e limit (padrão 500, máximo 5000). meta.hasNextPage diz se existe outra página; as linhas vêm sempre na mesma ordem, então avance as páginas até ele ser false.
• dateFrom / dateTo (YYYY-MM-DD, inclusivos) filtram pela coluna de data indicada na tabela acima. Recursos sem coluna de data recusam esses parâmetros.
• integrationId mantém só as linhas de uma conta conectada.
• As respostas ficam em cache por 30 minutos e os dados são sincronizados uma vez por dia — veja Sincronização de dados.

Formato da respostaCopiar link da seção

{
  "data": [{ "...": "um objeto por linha, com as colunas listadas em cada endpoint" }],
  "meta": {
    "page": 1,
    "limit": 500,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Valores monetários e contadores grandes (campos format: decimal e format: int64 no schema de cada endpoint) chegam como texto, por exemplo "125.50", para não perder precisão. Converta para um tipo decimal do seu lado.