Como criar um agente de prospecção B2B com OpenOutreach, OpenAI e BetterContact

Pesquisar uma empresa, identificar o responsável pela área, avaliar se há aderência ao produto e localizar um e-mail são tarefas diferentes. Quando tudo depende de pesquisa manual, o time comercial pode gastar boa parte do dia montando a lista, em vez de conversar com possíveis clientes.

A proposta apresentada no áudio de Luciano Silva é automatizar essa preparação com três componentes: uma ferramenta para organizar a prospecção, um modelo de IA para apoiar a qualificação e um serviço para localizar dados de contato. A decisão comercial continua sendo da empresa.

O papel de cada ferramenta

• OpenOutreach: coordena a operação de prospecção. Na arquitetura atual consultada, reúne o OpenOutFind, voltado à descoberta e qualificação, e o OpenOutSend, voltado à abordagem por e-mail.
• API da OpenAI: permite que o sistema use modelos de IA para analisar informações de acordo com o perfil de cliente definido. Não é necessário copiar cada perfil manualmente para uma conversa no ChatGPT.
• BetterContact: disponibiliza recursos de busca de pessoas e empresas e de enriquecimento de contatos, incluindo e-mail profissional e telefone quando disponíveis.

Uma distinção importante em relação à explicação resumida do vídeo: na versão atual documentada, o OpenOutreach usa um provedor de dados para descobrir perfis; ele não precisa entrar na sua conta do LinkedIn nem automatizar a navegação nessa rede. Um link de perfil pode aparecer no resultado sem ter sido obtido por uma sessão automatizada da sua conta.

Antes de instalar: defina quem você quer encontrar

O agente precisa de critérios claros. Uma descrição como “quero empresas que possam comprar meu software” deixa decisões demais em aberto. Escreva o problema que você resolve, o tipo de organização atendida, as áreas envolvidas e os perfis que devem ser excluídos.

Exemplo de produto: “Solução para captura de documentos fiscais e integração com ERP, destinada a empresas com volume recorrente de notas e processos manuais de conferência.”

Exemplo de público: “Construtoras e incorporadoras no Brasil. Procurar responsáveis por fiscal, controladoria e financeiro. Excluir escritórios que apenas prestam serviços contábeis e pessoas sem relação com essas áreas.”

Trate critérios difíceis de comprovar, como número de obras em andamento ou volume mensal de notas, como pontos a verificar. Não autorize a IA a preencher lacunas com suposições. Uma empresa parecida com seu público não é, por isso, uma oportunidade comercial confirmada.

Passo 1 — Prepare o OpenOutreach

Separe um computador ou servidor para o piloto. Os exemplos abaixo seguem a documentação consultada em 28/10/2026; versões antigas podem ter outra instalação e outros comandos. Registre a versão adotada e confira sua ajuda antes de executar.

Com o gerenciador uv instalado conforme a documentação oficial, o comando de instalação apresentado pelo projeto é:
uv tool install openoutreach

Para consultar as opções disponíveis:
openoutreach --help

Crie dois arquivos de texto na pasta do trabalho: product.md, com a descrição da solução, e target.md, com o perfil de cliente. Escreva em linguagem objetiva, sem chaves de API ou senhas.

Para abrir a configuração inicial usando esses arquivos:
openoutreach init --product-docs product.md --target target.md

O assistente solicitará as informações que faltarem, incluindo as integrações. Se sua instalação pedir uma caixa de e-mail, essa é a configuração da etapa de envio; ela não deve ser confundida com uma autorização para disparar mensagens. Para trabalhar exclusivamente com descoberta, avalie o OpenOutFind separado.

Não use o comando isolado openoutreach nem a operação run como primeiro teste de uma lista: no fluxo atual documentado, eles podem avançar para envio. Comece pelas operações find, que permitem revisar os resultados.

Passo 2 — Configure a API da OpenAI

Acesse platform.openai.com, escolha ou crie o projeto da integração, confira o faturamento e gere uma chave de API. O uso da API tem cobrança própria; não trate uma assinatura do ChatGPT como saldo disponível para essa integração.

Informe a chave apenas na configuração local ou no gerenciador de segredos da aplicação. Não a coloque em product.md, planilhas, capturas de tela, comandos que serão publicados ou repositórios. Se a ferramenta pedir um modelo, escolha um suportado pela versão instalada e disponível no seu projeto.

Para o primeiro teste de qualificação, recomendamos instruções como: “Avalie somente os dados recebidos. Explique a aderência ao público-alvo. Diferencie evidência de hipótese e marque como não informado aquilo que não puder comprovar.”

A IA ajuda a comparar perfis com os critérios, mas sua justificativa precisa ser revisada. Faça uma amostra de aceitos e rejeitados: se pessoas inadequadas estiverem entrando, ajuste primeiro o perfil de cliente e as instruções, antes de aumentar o volume.

Passo 3 — Conecte o BetterContact

Crie sua conta no BetterContact e localize a chave nas configurações de API. Cadastre-a no assistente do OpenOutreach, no campo correspondente. Confira créditos, cobertura dos países e disponibilidade dos recursos que pretende utilizar.

Buscar perfis e obter informações de contato são etapas distintas. Ter nome, cargo e empresa não garante que um e-mail ou telefone será localizado. O objetivo do piloto é medir a cobertura real no seu segmento.

Para quem desenvolver uma integração própria, o enriquecimento usa POST https://app.bettercontact.rocks/api/v2/async, com autenticação no cabeçalho X-API-Key. O corpo informa os contatos e se devem ser procurados e-mail e telefone; enrich_email_address e enrich_phone_number são opções independentes.

O telefone não deve ser prometido como saída automática de qualquer instalação do OpenOutreach. Confira se a versão utilizada expõe essa opção; se não expuser, será necessária uma etapa adicional de integração com o BetterContact.

Faça um piloto com poucos contatos

Na interface atual documentada, este comando busca dez leads qualificados e exporta o resultado para CSV, sem executar a etapa de envio:
openoutreach find 10 > leads-piloto.csv

Abra o arquivo e confira empresa, cargo, perfil e justificativa de qualificação. Só depois avalie executar a modalidade com busca de e-mail, que pode consumir créditos:
openoutreach find 10 emails > leads-com-emails.csv

Esse segundo comando não deve ser interpretado como “enriquecer exatamente as dez linhas do primeiro CSV”. A operação trabalha sobre o estado da instalação e o objetivo informado. Para enriquecer uma lista fechada, use um fluxo compatível com a importação desses contatos ou a API específica.

Compare os arquivos por identificador estável antes de importar no CRM. Uma nova exportação pode conter contatos já obtidos: arquivo novo não significa lista inteiramente nova. Essa conferência evita duplicidade de leads e abordagens repetidas.

Como tratar pedidos que ainda estão processando

O BetterContact processa as buscas e o enriquecimento de forma assíncrona. A solicitação inicial retorna um identificador; o resultado é consultado depois. No enriquecimento, ele vem no campo id e é utilizado em GET /api/v2/async/{request_id}.

Na integração, analise o status do processamento. processing significa que ainda é preciso aguardar; terminated indica conclusão; on_hold pode sinalizar falta de créditos. Uma resposta HTTP de sucesso, sozinha, não significa que os dados já estejam disponíveis.

Guarde o identificador do pedido e consulte o mesmo processamento, com intervalo entre tentativas e limite de espera. Não reenvie automaticamente a solicitação só porque o e-mail ainda não apareceu. Isso dificulta a rastreabilidade e pode gerar trabalho ou cobranças duplicadas. Um webhook pode receber o retorno quando suportado pelo recurso escolhido.

O que revisar antes de abordar alguém

• A pessoa ainda trabalha na empresa e tem relação com a área que você deseja alcançar?
• A justificativa da IA se baseia em dados ou apenas em uma hipótese sobre necessidade de compra?
• O contato já existe no CRM, já está sendo trabalhado ou pediu para não receber abordagens?
• O e-mail retornado tem uma situação de verificação adequada ao seu processo?
• A mensagem proposta explica um benefício relevante, sem inventar informações sobre a pessoa ou a empresa?

Depois dessa revisão, encaminhe a lista ao processo comercial. Se for habilitar envio automatizado, faça uma homologação separada da caixa, dos limites, do conteúdo e do tratamento de respostas. Encontrar contatos e autorizar mensagens são decisões diferentes.

Custos, dados e continuidade

Uma ferramenta de código aberto não torna toda a operação gratuita. Considere o consumo da API da OpenAI, os recursos do BetterContact, a infraestrutura e a revisão humana. Compare custo por contato utilizável e por oportunidade, não apenas quantidade de linhas exportadas.

Também não há lista infinita garantida. O resultado depende do público definido, da cobertura dos dados, das exclusões e dos limites da operação. Comece pequeno e amplie quando a qualidade justificar.

Leia o aviso de privacidade da versão instalada. O projeto documenta fluxos de compartilhamento com um repositório central de contatos; executar localmente não significa que todos os dados permaneçam no computador. Avalie essas transferências antes de usar dados reais.

Contatos profissionais podem ser dados pessoais. Defina a finalidade e a base legal aplicável, limite os dados ao necessário e mantenha um processo para atender solicitações e impedir novas abordagens quando cabível. O legítimo interesse exige análise concreta, não é uma autorização automática para prospectar qualquer pessoa.

Para rodar de forma recorrente, recomendamos guardar o estado entre execuções, evitar jobs sobrepostos, preservar backups e aplicar deduplicação no CRM. Monitore pendências e falhas; não deixe um processo repetindo chamadas sem limite.

Comece pela qualidade da lista

A combinação de OpenOutreach, OpenAI e BetterContact pode reduzir o trabalho manual de preparar a prospecção. O ganho depende de um público bem definido, de integrações acompanhadas e de contatos que façam sentido para o negócio.

Antes de buscar centenas de nomes, valide os primeiros dez. Essa amostra mostra se a configuração está ajudando o comercial a encontrar conversas melhores — ou apenas gerando uma planilha maior.

A Sintria atua no desenvolvimento de soluções e integrações para processos empresariais. Converse com nossa equipe para avaliar uma automação de prospecção conectada às ferramentas e à rotina do seu negócio.

Referências

Guia elaborado a partir do áudio de Luciano Silva e da documentação consultada em 28/10/2026. Os comandos são exemplos documentais, não uma instalação executada neste artigo. Homologue a versão utilizada antes de operar.

OpenOutreach: https://github.com/eracle/OpenOutreach

OpenOutFind: https://github.com/eracle/OpenOutFind

OpenAI — Primeiros passos: https://developers.openai.com/api/docs/quickstart

BetterContact — Enriquecimento: https://doc.bettercontact.rocks/api-reference/endpoint/create

BetterContact — Status das solicitações: https://doc.bettercontact.rocks/api-reference/statuses

ANPD — Guia de legítimo interesse: https://www.gov.br/anpd/pt-br/assuntos/noticias/anpd-lanca-guia-orientativo-sobre-legitimo-interesse