Interfaces para sua stack

Desenvolvedores: API, webhooks e MCP

Consulte dados atribuídos, envie eventos comerciais e conecte sistemas próprios com interfaces pensadas para ambientes de produção.

Testar grátis por 14 dias
Painel de chaves da API do LeadInsight com escopos e histórico de requisições
HTTP + JSON

API REST

Gere uma chave no painel, defina o site e conceda apenas os escopos necessários. A API permite consultar leads com origem e jornada, atualizar status comerciais e enviar pedidos de lojas ou checkouts externos.

  • Leads, status e atribuição de campanha
  • Pedidos, valores e atualização de pagamento
  • Chaves revogáveis com escopo por site
Consultar leadsExemplo ilustrativo
curl --request GET \
  --url 'https://api.leadinsight.com.br/v1/leads?site_id=site_demo' \
  --header 'Authorization: Bearer $LEADINSIGHT_API_KEY' \
  --header 'Accept: application/json'
Eventos sob condição

Webhooks condicionais

Receba um POST no seu endpoint quando um lead entra, muda de status ou avança no funil. Regras por origem, campanha ou etapa evitam ruído e entregam somente os eventos úteis para a sua automação.

Valide a assinatura com um token secreto antes de processar o payload.

Ver webhook de conversão
lead.status_changedAtivo
SEorigin.type = paid
Elead.status = opportunity
POSThttps://seu-dominio.com/webhooks/leads
Lojas e checkouts

Envio de pedidos (lojas e checkouts)

Crie o pedido quando o checkout iniciar e atualize o mesmo registro quando o pagamento for confirmado. O identificador externo e a chave de idempotência evitam duplicidade, enquanto a origem do lead permanece ligada à receita.

Ver tracking para e-commerce
Confirmar pagamentoExemplo ilustrativo
curl --request POST \
  --url 'https://api.leadinsight.com.br/v1/orders' \
  --header 'Authorization: Bearer $LEADINSIGHT_API_KEY' \
  --header 'Idempotency-Key: order_483_paid' \
  --header 'Content-Type: application/json' \
  --data '{"external_id":"order_483","status":"paid","value":1490}'
Contexto para agentes

MCP para agentes de IA

O conector MCP oferece uma interface estruturada para agentes consultarem leads, atribuição e resultados conforme as permissões concedidas. Assim, ferramentas compatíveis podem responder perguntas operacionais sem exportar planilhas ou compartilhar uma chave ampla da API.

Conhecer o conector MCP
Benefícios técnicos

Integrações controladas do primeiro request ao evento

Use o mínimo de acesso necessário, processe mudanças em tempo real e mantenha a atribuição junto dos dados comerciais.

Acesso com escopo

Cada chave fica vinculada aos sites e recursos necessários, com revogação e rotação controladas pelo painel.

Eventos em tempo real

Webhooks condicionais enviam somente os eventos relevantes para o seu endpoint e reduzem consultas repetidas.

Integração sem amarras

Conecte CRM próprio, checkout, BI, automações e agentes de IA usando interfaces previsíveis e dados atribuídos.

Produção com segurança

Boas práticas

Trate cada integração como uma superfície de acesso: limite permissões, registre o fluxo e planeje reenvios.

Chave por ambiente

Separe desenvolvimento, homologação e produção para revogar um ambiente sem interromper os demais.

Rotação programada

Troque chaves periodicamente e mantenha uma janela controlada para atualizar os consumidores.

Escopo mínimo

Conceda somente os sites e recursos necessários para cada serviço ou automação.

Idempotência

Envie um identificador estável em criações e atualizações para processar tentativas sem duplicar efeitos.

Como funciona

Como funciona

Da primeira chave ao monitoramento em produção em três etapas.

  1. 1

    Gere a chave

    Escolha o ambiente, o site e os escopos mínimos para o consumidor.

  2. 2

    Integre e valide

    Consuma a API ou registre o webhook, testando autenticação, assinatura e idempotência.

  3. 3

    Monitore e rotacione

    Acompanhe respostas e consumo, ajuste regras e renove as chaves de forma programada.

FAQ

Perguntas frequentes sobre a API do LeadInsight

Como autentico na API do LeadInsight?

Com uma chave de API gerada no painel, enviada no header de cada requisição. Cada chave tem escopo por site definido e pode ser revogada a qualquer momento. Use uma chave separada por ambiente, armazene-a em um gerenciador de segredos e nunca a exponha em código client-side.

O que consigo fazer pela API?

Consultar leads e sua atribuição, incluindo origem, campanha e jornada; atualizar status; registrar pedidos de loja com valores; e receber uma estrutura pronta para alimentar BI, CRM próprio ou automações externas. Os recursos respeitam o escopo da chave e do site selecionado no painel.

Como funcionam os webhooks?

Você cadastra a URL do seu endpoint e as condições, como receber apenas leads de campanhas pagas. Quando o evento acontece, o LeadInsight envia um POST assinado com os dados do lead. Use o identificador do evento para processar reenvios com idempotência e evitar efeitos duplicados.

Posso enviar pedidos de um checkout externo?

Sim. O endpoint de pedidos aceita criação e atualização de status: um pedido pendente que for pago depois atualiza o mesmo registro, preservando a campanha de origem e sem duplicar receita. Uma chave de idempotência também protege o fluxo quando o checkout precisa repetir a requisição.

Existe limite de requisições?

Sim. Há limites por chave para proteger a estabilidade da plataforma e eles atendem integrações comuns de produção. O painel permite acompanhar o consumo e identificar respostas de limite. Necessidades acima do padrão podem ser avaliadas com o suporte no plano Elite, conforme o volume e o fluxo.

Conecte o LeadInsight à sua stack

Crie uma conta, configure o site e prepare uma integração com escopo controlado.

Testar grátis por 14 dias