For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/capture-link.md.
  • Português

      • Envie leads de uma página externa

      Crie um link de captação na Clickmax, copie a URL pública que ele gera e envie os dados do lead para essa URL a partir de qualquer página, formulário ou integração externa. A Clickmax recebe o envio e cria o lead no CRM.

      Antes de começar

      • Papel: qualquer membro autenticado do workspace com acesso ao CRM (área Leads) pode criar e gerenciar links de captação — não exige papel administrativo. Veja papéis e permissões.
      • Atenção: qualquer pessoa com a URL do link pode enviar dados para a sua base de leads. Compartilhe apenas em canais confiáveis.

      Passo 1 — Crie o link de captação

      1. No CRM, abra Leads → Links de captação.

      2. Clique em Criar link de captação.

        Links de captação com o botão Criar link de captação

      3. Em Nome do link, use um nome fácil de reconhecer (ex.: Campanha Instagram).

      4. Opcional: em Funil de origem, escolha um funil para identificar de onde os leads vieram. A lista mostra os seus funis; funis da versão anterior aparecem com (v3) no nome. Deixe em Nenhum funil se não quiser associar.

      5. Clique em Criar link.

        Formulário do link de captação com nome e funil de origem

      Passo 2 — Copie a URL pública

      Ao criar, a Clickmax mostra o endereço público do link. Clique em Copiar link. A URL termina em /ingest/SEU_LINK_DE_CAPTURA:

      URL pública do link de captação pronta para copiar

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

      Sempre copie a URL exata mostrada na tela — não monte o endereço manualmente. Você também pode copiá-la depois, na lista de links, pelo botão Copiar link.

      Passo 3 — Envie os dados da sua página

      Na sua página ou formulário externo, faça uma requisição POST para a URL com o corpo em JSON. Envie ao menos email, name ou telephone para identificar o lead.

      curl -X POST "https://api.clickmax.dev/ingest/SEU_LINK_DE_CAPTURA" \
  -H "Content-Type: application/json" \
  --data '{ "email": "maria@empresa.com", "name": "Maria Silva", "telephone": "5511999999999" }'

      A lista completa de campos aceitos (documento, endereço, campos customizados, UTMs), os formatos exigidos e a resposta estão na referência do link de captura.

      Passo 4 — Confira o lead no CRM

      Depois de um envio bem-sucedido, o lead aparece na lista de Leads. Na lista de links de captação, o contador de leads captados do link também aumenta.

      Quando você ainda não tem nenhum link de captação, a lista mostra uma prévia esmaecida da área, o título Crie seu primeiro link de captação, um resumo curto e três destaques. O botão Criar link de captação faz o mesmo que o botão do topo e abre o formulário do passo 1. Uma busca ou filtro sem resultado não mostra essa tela: continua aparecendo a mensagem simples de que nada foi encontrado.

      Relacionados

      Se não funcionou

      • A requisição retornou erro (4xx/5xx): consulte os códigos de erro para identificar a causa.
      • O lead não aparece: confira se você usou POST, Content-Type: application/json e a URL exata do link; telephone e whatsappNumber só aceitam dígitos. Detalhes na referência do link de captura e nos códigos de erro.
      • O envio "deu certo" mas nada foi salvo: se o campo website (proteção anti-bot) for enviado preenchido, a Clickmax responde com sucesso mas descarta o envio. Deixe-o vazio — veja a referência do link de captura e os códigos de erro.