Pular para o conteúdo principal

Captação de leads

Onde: Funil de Vendas → Leads. A fila abre com o filtro Novos, ordenada pelo score e, nos empates, pela data de criação mais recente. Use a busca ou os filtros Todos, Novos, Em contato, Qualificados e Descartados para encontrar contatos fora desse recorte.

Fila real de leads com busca, filtros e ações de captação

Landing de campanha​

  1. Clique em Link.
  2. Copie o endereço da empresa e abra em outra aba para conferir o formulário.
  3. Acrescente os parâmetros de campanha antes de divulgar.
  4. Preencha e envie um contato de teste autorizado; depois confira a fila Novos.

Formato do link, substituindo ID_DA_EMPRESA pelo identificador do perfil empresarial:

https://app.empresas.atla.pro/public/campaign/ID_DA_EMPRESA?utm_source=instagram&utm_medium=social&utm_campaign=evento-outubro&utm_content=convite

São reconhecidos utm_source, utm_medium, utm_campaign, utm_content e utm_term. O botão de copiar da tela copia o endereço base; complete os UTMs manualmente antes de publicar a campanha.

A captura pública exige nome e pelo menos e-mail ou telefone. Respostas de qualificação são validadas de acordo com o formulário da empresa. A confirmação pública não revela se o contato já existia.

Incorporar no site​

Clique em Incorporar e copie o código para a página do site em que o formulário deve aparecer. Ele usa /public/embed/ID_DA_EMPRESA, com a apresentação incorporada do mesmo formulário.

Para uma incorporação com ajuste automático de altura, valide a origem e o iframe emissor antes de aceitar mensagens:

<iframe id="pepper-lead-form"
  src="https://app.empresas.atla.pro/public/embed/ID_DA_EMPRESA"
  title="Formulário de contato"
  style="width:100%;border:0;min-height:520px"
  loading="lazy"></iframe>
<script>
  const form = document.getElementById('pepper-lead-form');
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://app.empresas.atla.pro') return;
    if (event.source !== form.contentWindow) return;
    if (event.data?.type !== 'pepper:lead-form:height') return;
    const height = Number(event.data.height);
    if (Number.isFinite(height) && height > 0 && height < 10000) {
      form.style.height = height + 'px';
    }
  });
</script>

O título, texto, campos e perguntas de qualificação vêm da configuração da empresa. O CRM atual não oferece uma tela para editar esse formulário; a configuração é feita pela API com suporte técnico.

Importar CSV​

  1. Clique em Importar na fila de leads.
  2. Selecione um arquivo .csv com cabeçalho e até 2 MB.
  3. Confira as colunas sugeridas para Nome, E-mail, Telefone, CPF/CNPJ e Empresa. Use Não importar para ignorar um campo.
  4. Confira a prévia. Mapeie o nome e pelo menos uma forma de contato nos dados.
  5. Informe etiquetas para toda a lista, se fizer sentido, separadas por vírgulas.
  6. Clique em Importar N linhas.
  7. Confira os totais de criados, mesclados e ignorados. Corrija as linhas recusadas antes de reimportar.
Escolha de arquivo CSV Mapeamento e prévia de duas linhas fictícias

Exemplo de arquivo:

nome,email,telefone,empresa
Ana Exemplo,ana@example.com,11900000000,Empresa Exemplo
Bruno Exemplo,bruno@example.com,21900000000,Loja Demonstração

O parser aceita vírgula, ponto e vírgula ou tabulação. A interface usa seleção de arquivo; não há campo para colar o CSV. A importação não oferece coluna de consentimento: não suponha que a lista importada esteja autorizada para marketing.

Cadastro manual​

Clique em Novo lead para abrir os campos de nome, empresa, e-mail, telefone e autorização de marketing.

Formulário de cadastro manual e checkbox de autorização
Incompatibilidade identificada

Nesta revisão, a tela envia consent no cadastro manual, mas a validação de POST /lead não aceita esse campo. O envio pode ser rejeitado mesmo com os dados preenchidos. O formulário existe, mas a gravação pelo contrato atual precisa de correção. Até a correção, use os canais habilitados e validados no seu ambiente; não marque consentimento sem autorização da pessoa.

Feira e integração​

A API também possui captura contextualizada pela feira e webhook assinado. Landing e embed têm links próprios por empresa; a captura de feira resolve a empresa pela feira informada. Não confunda essa origem com um negócio já ganho.

O webhook e sua rotação de segredo são operações técnicas, sem botão no CRM atual. Consulte Arquitetura e integrações para o contrato e a limitação do parser de assinatura encontrada na análise.

Duplicidade e consentimento​

A captação procura contatos da mesma empresa por documento, e-mail ou telefone. Ao encontrar um existente, preenche identificadores e dados básicos vazios, acumula etiquetas, preserva o primeiro toque e registra o contato mais recente em source.lastTouch. Qualificação recebida pode atualizar a qualificação anterior.

Essa mesclagem reduz duplicações nas capturas, mas não há índice único que elimine uma corrida entre duas gravações simultâneas. A edição direta de um lead também não aplica essa mesma busca de duplicidade.

Na captura pública, marketing exige aceite explícito. O registro guarda data, canal, IP e versão da política quando enviada. Uma revogação anterior não é reativada automaticamente na mesclagem. O cadastro atual não oferece um fluxo na tela para renovar esse consentimento.

Próximo passo: qualificar e converter o lead.