Links de captura

Os links de captura servem para enviar dados de um lead para a Clickmax sem depender de um formulário criado dentro da plataforma.

Na prática, você recebe uma URL de captura e envia para ela os dados que quer salvar, como nome, email e telefone.

Se você já tem uma landing page, um formulário externo ou uma integração própria, basta usar o link de captura gerado na Clickmax e enviar os dados do lead para essa URL. A Clickmax recebe essas informações e cria ou atualiza o lead automaticamente.

Exemplo de envio

O envio deve ser feito com método POST e com o conteúdo em formato JSON.

Exemplo de URL:

https://api.clickmax.dev/ingest/SEU_LINK_DE_CAPTURA

Exemplo de payload:

{
  "email": "[email protected]",
  "name": "Maria Silva",
  "telephone": "5511999999999",
  "utmSource": "facebook",
  "utmMedium": "cpc",
  "utmCampaign": "campanha-de-captacao",
  "utmContent": "criativo-a",
  "utmTerm": "gestao comercial"
}

Exemplo com curl:

curl -X POST "https://api.clickmax.dev/ingest/SEU_LINK_DE_CAPTURA" \
  -H "Content-Type: application/json" \
  --data '{
    "email": "[email protected]",
    "name": "Maria Silva",
    "telephone": "5511999999999",
    "utmSource": "facebook",
    "utmMedium": "cpc",
    "utmCampaign": "campanha-de-captacao",
    "utmContent": "criativo-a",
    "utmTerm": "gestao comercial"
  }'

Campos mais comuns

CampoO que significa
emailEmail do lead
nameNome do lead
telephoneTelefone somente com números
utmSourceOrigem do tráfego
utmMediumMeio da campanha
utmCampaignNome da campanha
utmContentVariação do anúncio ou criativo
utmTermTermo ou palavra-chave

Cuidados importantes

  • envie o telefone somente com números
  • sempre que possível, envie pelo menos nome, email ou telefone para identificar o lead com mais facilidade

Resposta esperada

Quando o envio for aceito, a resposta retorna um identificador do lead criado:

{
  "leadId": "088a60ed-7fe6-4a96-b7dd-a91573fc3cdc"
}

Resumo rápido

Se você já tem uma página ou formulário fora da Clickmax, o link de captura é a forma mais simples de enviar esses dados para dentro da plataforma.