Como enriquecer leads inbound com agentes em vez de licenças do Apollo

TL;DR: Para enriquecer leads inbound com agentes, envie o e-mail e o domínio corporativo de cada novo cadastro para um webhook que dispara a execução de um agente. O agente enriquece os dados do contato no People Data Labs e da empresa no Apollo, consulta o nome em listas de sanções, avalia a aderência ao seu ICP e cria uma tarefa para cada lead. Uma pessoa da equipe analisa todos os leads qualificados antes de qualquer resposta ser enviada. Você paga por lead em créditos do Firecrawl, e não por assento.

Um novo cadastro chega com dois dados valiosos: um e-mail e o domínio da empresa. Alguém precisa transformar isso em uma decisão: trata-se de um comprador em potencial, um estudante, um concorrente ou alguém com quem sua empresa não pode negociar legalmente?

A resposta convencional é pagar por licenças individuais nas ferramentas de enriquecimento para todos os responsáveis pela triagem de leads. O Apollo cobra por usuário (assento), e sua página de preços indica que todas as contas de uma organização compartilham o mesmo plano. Isso faz sentido quando pessoas realizam as pesquisas manualmente. Quando um agente assume essas buscas, quem analisa o resultado final não precisa de licença alguma.

Este guia ensina como estruturar esse fluxo no Sharkly, usando Claude Code ou Codex como runtime e o Firecrawl Alexandria como camada de dados. Todos os valores em créditos apresentados abaixo correspondem aos preços de tabela do Firecrawl consultados em 3 de novembro de 2026. Não processamos um lead real para este artigo, portanto considere os totais como exemplos práticos e confirme os valores no playground antes de colocar qualquer integração em produção.

Por que enriquecer leads inbound com agentes

O enriquecimento de leads inbound consiste em identificar o cargo, a empresa e o perfil de aderência de um contato antes que alguém da sua equipe gaste tempo com ele. Um agente pode realizar as pesquisas, aplicar suas regras de qualificação e gerar um resumo conciso de um parágrafo. A decisão sobre quem deve receber uma resposta continua nas mãos de uma pessoa.

Três pontos fundamentais mudam quando o agente faz as consultas:

1. A cobrança acompanha os leads. Uma única chave de API do Firecrawl cobre todos os provedores integrados. Cada consulta tem um custo tabelado em créditos, e consultas que não encontram resultados nos provedores abaixo não têm custo.
2. As regras ficam centralizadas em um arquivo. O seu ICP fica documentado em um arquivo revisado que o agente lê a cada execução, em vez de depender da memória ou do julgamento individual de quem faz a triagem.
3. Todos os leads passam pelas mesmas verificações. O quadragésimo cadastro do dia passa pela mesma checagem de sanções aplicada ao primeiro.

Visão geral do pipeline de enriquecimento inbound

Etapa 1: Um webhook inicia a execução do enriquecimento

No Sharkly, uma Automation é uma regra vinculada a um Space que delega tarefas repetíveis a um Agent ou Crew. Um dos tipos de gatilho disponíveis é o webhook: uma URL secreta que recebe requisições POST de outro serviço. O backend do seu fluxo de cadastro faz o envio do novo lead para essa URL.

# From your signup handler. The URL is a secret; keep it in your app's env.
curl -X POST "$SHARKLY_LEAD_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"signup_id": "su_10482", "email": "[email protected]", "domain": "example-corp.com"}'

O Sharkly exibe a URL completa apenas uma vez, no momento em que o gatilho é criado ou gerado novamente. Depois disso, o card do gatilho informa apenas que a URL está ativa. Você também pode definir um segredo de assinatura para exigir validação por assinatura em cada requisição.

Um detalhe importante molda essa arquitetura: uma Automation inicia a execução de um agente, e não diretamente uma tarefa. Por isso, as instruções orientam o agente a criar a tarefa do lead ao concluir o fluxo. O histórico de execução armazena o payload do gatilho, registrando exatamente o que foi recebido para cada lead.

Etapa 2: Enriquecer os dados da pessoa pelo e-mail

O endpoint person/enrich do People Data Labs custa 60 créditos por chamada. Apenas o email já basta como dado de entrada. O parâmetro responsável por controlar seus custos é o min_likelihood, que vai de 1 a 10 e tem valor padrão 2. Ao aumentá-lo, correspondências de baixa confiança retornam um erro 404 em vez de dados incorretos. A página de integrações do Firecrawl define isso de forma direta: “um 404 aqui sai de graça; um registro incorreto, não”.

// enrich-lead.mjs: one call per signup, key injected as $FIRECRAWL_API_KEY
const call = (alexandria) =>
  fetch("https://api.firecrawl.dev/v2/scrape", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ alexandria }),
  }).then((r) => r.json());

const person = await call({
  provider: "people-data-labs",
  capability: "person/enrich",
  options: { email: lead.email, min_likelihood: 6, titlecase: true },
});
const p = person.alexandria?.[0];
if (p?.error) brief.errors.push(p.error); // check every result before using it

O retorno contém cerca de 150 campos. Para o seu resumo, apenas cinco são necessários. Com valores ilustrativos, os dados que o agente armazena ficam assim:

{
  "full_name": "Jordan Example",
  "job_title": "Director Of Platform Engineering",
  "job_company_name": "Example Corp",
  "linkedin_url": "linkedin.com/in/placeholder",
  "likelihood": 8
}

Acompanhe também os limites de uso. Por meio do Alexandria, o People Data Labs disponibiliza 50.000 chamadas de API por ano por organização, somando os endpoints de pessoas e empresas. Novas tentativas automáticas (retries) contam na cota, e o limite é reiniciado em 1º de janeiro no horário UTC.

Etapa 3: Enriquecer os dados da empresa pelo domínio

Os dados corporativos do Apollo cobrem rodadas de investimento, número de colaboradores e tecnologias em uso. O exemplo oficial do Firecrawl utiliza o recurso companies/bulk-enrich, que processa até dez domínios por requisição. Na tabela comparativa do Firecrawl de outubro de 2026, o custo listado é de 30 créditos por empresa encontrada, sem cobrança para domínios não localizados.

const company = await call({
  provider: "apollo",
  capability: "companies/bulk-enrich",
  options: { "domains[]": [lead.domain] },
});
const org = company.alexandria?.[0]?.data?.organizations?.[0];
// org.name, org.estimated_num_employees, funding and technology fields

A documentação do Apollo no Alexandria inclui uma skill nativa chamada “CRM account data refresh”. Ela atualiza o enriquecimento de contas com base no domínio e compara as novas informações com o que já está salvo no CRM. É exatamente a mesma chamada, só que direcionada à sua base de clientes atual em vez de novos cadastros.

Etapa 4: Consultar o lead em listas de sanções

A categoria People no Alexandria disponibiliza o OpenSanctions — uma base de dados de sanções internacionais, pessoas politicamente expostas (PEPs) e indivíduos de interesse —, além da UK Sanctions List. A descoberta de recursos é gratuita; portanto, instrua o agente a localizar o endpoint de verificação e checar o preço antes da primeira requisição tarifada:

firecrawl find-tools --options '{"providers": ["opensanctions-org"]}' --include-costs

O recurso de datasets do OpenSanctions indica um custo de 5 créditos por consulta. Não deduza que a busca direta por entidades custe o mesmo; utilize sempre o valor informado pelo find-tools. Atente-se também ao licenciamento: o OpenSanctions distribui seus dados sob a licença CC BY-NC 4.0 e disponibiliza licenças comerciais específicas para triagem de negócios, o que torna necessária a contratação da licença correta para fluxos comerciais de vendas.

Uma correspondência encontrada não significa que o agente deva rejeitar o lead imediatamente, mas sim que a tarefa será encaminhada para revisão humana com o alerta devidamente anexado.

Etapa 5: Avaliar a aderência ao seu ICP

A pontuação não consome créditos adicionais porque analisa informações que você já obteve nas etapas anteriores. Armazene as regras em uma Sharkly Skill para garantir que toda execução consulte o mesmo arquivo e que qualquer alteração passe por revisão.

# inbound-icp.md (owner: head of sales)
qualify_if: employees >= 50 AND title in [Director, VP, Head, CTO] AND sanctions_match == false
nurture_if: employees < 50 OR title not senior
disqualify_if: free_email_domain OR known_competitor_domain
on_sanctions_match: route to Sales review with the match, never auto-reply
brief_fields: [name, title, company, employees, funding, score, reason, credits_spent]

Como rotear o lead no painel de tarefas

É no roteamento que o Sharkly mostra seu real diferencial. Os status das tarefas podem ser configurados por tipo de tarefa, com cada status vinculado a uma categoria predefinida. Para fluxos de leads, três status são suficientes:

O agente gera a tarefa como última ação da execução:

sharkly task create \
  --title "Lead: Example Corp (Director Of Platform Engineering)" \
  --body-file brief.md \
  --status "Sales review" \
  --assignee <member> --output json

Essa atribuição aparece na Inbox do responsável como uma notificação de prioridade Primary. Se o agente redigir uma sugestão de primeira resposta, esse rascunho fica disponível no corpo da tarefa, mas nunca é enviado de forma autônoma. Essa barreira de validação segue o mesmo conceito que abordamos no artigo sobre agentes de codificação com humanos no circuito (human-in-the-loop).

Custo detalhado em créditos por lead

Para um lead em que ambos os enriquecimentos retornam dados com sucesso, a composição dos preços de tabela fica assim:

Na tabela de preços do Firecrawl, o plano Hobby sai por US$ 19 mensais para 5.000 créditos (US$ 0,0038 por crédito). Isso resulta em US$ 0,342 por lead para 90 créditos. No plano Standard, o valor é de US$ 99 por 100.000 créditos (US$ 0,00099 por crédito), baixando o custo do mesmo lead para US$ 0,0891. Evite disparar a consulta da empresa para cadastros com domínios de e-mails públicos como o gmail.com — caso contrário, você gastará 30 créditos apenas para saber o número total de funcionários do Google.

Processando 100 leads qualificados por mês, o consumo seria de 9.000 créditos. Como esse volume excede os 5.000 créditos do plano Hobby, vale mais a pena adquirir créditos extras ou migrar diretamente para o Standard. Faça esse cálculo considerando o volume real do seu negócio antes de contratar um plano.

Vale fazer uma ressalva quanto ao modelo de cobrança por assento: o Apollo cobra por licença individual de usuário, enquanto o Clay adota um modelo diferente, oferecendo usuários ilimitados por workspace em qualquer plano. O objetivo aqui não é generalizar dizendo que licenças por usuário são ruins, mas destacar que, quando agentes executam as pesquisas, a cobrança se alinha ao volume de leads trabalhados, e não à quantidade de profissionais que acessam os relatórios.

Como o Sharkly orquestra todo o processo

O Claude Code ou o Codex processa as requisições, enquanto o Sharkly garante total visibilidade de todas as etapas.

• A chave de API não fica exposta nas tarefas. Configure a variável FIRECRAWL_API_KEY nas Environment Variables do Agent. O Sharkly sinaliza essas configurações de texto puro como visíveis para gestores do Agent, portanto use uma chave com escopo restrito a este processo.
• Agentes não consomem assentos de usuário. No Sharkly, um assento é destinado a uma pessoa. Agents, Crews, Computers e Runtimes não ocupam vagas de licença.
• Todas as execuções deixam histórico. O registro de execuções das Automations documenta o payload do gatilho, as ações executadas pelo agente e os eventuais motivos de erro.

Antes de colocar o webhook em operação definitiva, clique em Run now na Automation informando um payload de teste. Acompanhe algumas execuções antes de habilitar a geração automática de rascunhos de resposta. O guia de Automations detalha cada modalidade de gatilho disponível.

Comece com um único webhook

Para estruturar o enriquecimento de leads inbound com agentes, comece de forma enxuta: um webhook, um agente, duas chamadas de enriquecimento de dados, um arquivo de regras e um status de revisão humana. Teste o fluxo nos seus próximos 20 cadastros e analise cada resumo antes de qualquer contato comercial. É possível começar gratuitamente no Sharkly, e o uso dos modelos consome diretamente o plano do Claude Code ou Codex já vinculado ao seu Runtime.

Perguntas frequentes (FAQ)

Quanto custa enriquecer um lead inbound com o Firecrawl?

Pelos preços de tabela do Firecrawl, um lead com dados localizados tanto no People Data Labs quanto no Apollo consome 90 créditos antes da triagem de sanções. Isso representa cerca de US$ 0,34 no plano Hobby e US$ 0,09 no Standard, faturados mensalmente.

Uma consulta de enriquecimento sem correspondência consome créditos?

Nesses dois serviços, não. Uma busca no People Data Labs com índice inferior ao seu min_likelihood retorna um 404 gratuito, e a consulta em lote corporativa do Apollo não cobra por domínios não encontrados.

O agente pode responder ao lead de forma autônoma?

Recomenda-se evitar o envio automático. O agente cria a tarefa com uma sugestão em rascunho, e um membro da equipe realiza a revisão e faz o envio manual.

O OpenSanctions é gratuito para uso comercial?

Não. Os dados são fornecidos sob a licença CC BY-NC 4.0, e a checagem corporativa exige a contratação de uma licença comercial paga. Confirme essa conformidade antes de integrar a ferramenta ao seu funil comercial.

Preciso de um assento pago no Apollo para rodar esse fluxo?

Não é necessário assento no Apollo para as buscas do agente, pois as requisições passam pela sua chave de API do Firecrawl. O Firecrawl pode solicitar que um administrador da organização confirme previamente os termos de dados do provedor; caso necessário, o erro retornado será THIRD_PARTY_DATA_TERMS_REQUIRED.

O que acontece se o Firecrawl exigir o aceite dos termos durante a execução?

A resposta da API fornecerá uma URL em requiresAction.url, onde o administrador da organização poderá aceitar as condições. As diretrizes do Firecrawl determinam que os agentes dependem de autorização explícita do usuário antes de concordar com termos de serviço, de modo que o agente deve manter a tarefa aguardando a intervenção de uma pessoa.