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.
      • Plano: disponível em qualquer workspace com acesso ao CRM (Leads); não há restrição de plano específica para links de captação.
      • 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. 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": "[email protected]", "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.

      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.