Forager em waterfall na ferramenta de contatos do agente
Dê a um framework de agentes ou a um agente de GTM uma ferramenta de consulta de contatos que tenta as fontes em ordem e retorna o primeiro resultado verificado, com a Forager na etapa de celular e e-mail.
- Chave de API gratuita
- Sem cartão de crédito
- Rode sua amostra
Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a Forager
- Ferramentas citadas
LinkedIn
Usa POST /person_contacts_lookup/phone_numbers/, POST /person_contacts_lookup/work_emails/ · Referência da API de números de celular
Quanto custa: 15 créditos por celular encontrado · 5 créditos por e-mail encontrado. Uma consulta de celular ou e-mail sem resultado custa 0 créditos.
- Números de celular
- E-mails corporativos
- E-mails pessoais
- API
- Posição no waterfall
- Agentes de IA e ferramentas para devs
Como os dados fluem
POST /person_contacts_lookup/phone_numbers/ - número de telefone
- +1 (416) 555-0186
- e-mail corporativo
- kim@example.com
- e-mail pessoal
- kim.e@example.net
- source
- forager
- person id
- per_8f3a1c
- nome
- Kim Exemplar
Passos
- Defina uma ferramenta
find_contactno seu framework que receba uma URL do LinkedIn ou nome e empresa - Dentro dela, chame
POST /person_contacts_lookup/phone_numbers/e depoisPOST /person_contacts_lookup/work_emails/quando a fonte anterior não retornar nada - Retorne um resultado tipado com os nomes dos campos, a fonte que o encontrou e o
person_id - Conte créditos só por resultado encontrado, de modo que uma falha na etapa da Forager acrescenta 0 ao custo da execução
import json, os, requests BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage" HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]} body = json.load(open("request.json")) # request fields: see the API reference # 1. Define one find_contact tool in your framework that takes a LinkedIn # URL or name and company # 2. Inside it, call POST /person_contacts_lookup/phone_numbers/ then POST # /person_contacts_lookup/work_emails/ when the earlier source returns # nothing r1 = requests.post(f"{BASE}/person_contacts_lookup/phone_numbers/", headers=HEADERS, json=body) r2 = requests.post(f"{BASE}/person_contacts_lookup/work_emails/", headers=HEADERS, json=body) # 3. Return a typed result with the field names, the source that found it # and the person_id # 4. Count credits per found result only, so a miss in the Forager step adds # 0 to the run's cost
# 1. POST /person_contacts_lookup/phone_numbers/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. POST /person_contacts_lookup/work_emails/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/work_emails/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json
Execute você mesmo: Referência da API de números de celular
- Chave de API gratuita
- Sem cartão de crédito
- Rode sua amostra
Entradas e saídas
| Dados de entrada | Saídas |
|---|---|
| URL do LinkedIn ou identificador público | phone_number |
| nome completo + domínio da empresa | work_email |
personal_email | |
source | |
person_id |
Dúvidas sobre esta receita
Como adiciono uma cascata de contatos às ferramentas do meu agente?
Defina uma ferramenta find_contact no seu framework que receba uma URL do LinkedIn ou nome e empresa. Dentro dela, chame POST /person_contacts_lookup/phone_numbers/ e depois POST /person_contacts_lookup/work_emails/ quando a fonte anterior não retornar nada.
Quanto custa adicionar a Forager como etapa de cascata (waterfall) na ferramenta de contatos de um agente?
Números de celular: 15 créditos por número de celular encontrado, e uma consulta de número de celular sem resultado custa 0 créditos. E-mails corporativos: 5 créditos por e-mail corporativo encontrado, e uma consulta de e-mail corporativo sem resultado custa 0 créditos. E-mails pessoais: 5 créditos por e-mail pessoal encontrado, e uma consulta de e-mail pessoal sem resultado custa 0 créditos. Os 8.250 créditos mensais do plano Growth cobrem 550 celulares ou 1.650 e-mails, ou uma combinação. Os planos self-service são Starter, Growth, Pro e Scale. Veja planos e preços
O que preciso para executar este exemplo prático e o que recebo de volta?
Você envia nome completo + domínio da empresa e URL do LinkedIn ou identificador público. Você recebe person_id, personal_email, phone_number e source, em JSON. Você também precisa de uma chave de API da Forager, que vem com uma conta gratuita.
Qual API de dados de contato pode ser uma etapa na ferramenta de consulta de um agente?
Este exemplo prático usa Mobile numbers, Work emails e Personal emails da Forager. Números de celular: números de celular diretos de uma pessoa, a partir de uma URL do LinkedIn ou de um ID de pessoa da Forager, validados antes de chegarem até você. Dê a um framework de agentes ou a um agente de GTM uma ferramenta de consulta de contatos que testa as fontes em ordem e retorna o primeiro resultado verificado, com a Forager na etapa de celular e e-mail.
Posso testar números de celular de graça?
Sim. Crie uma conta gratuita em app.forager.ai: ela vem com US$ 5 em créditos gratuitos e uma chave de API, e não é preciso cartão de crédito para se cadastrar. Teste com registros que você já conhece ou agende uma demo e envie uma lista: nós a processamos e mostramos o que encontramos.
Quando devo executar este fluxo de trabalho?
A ferramenta find-contact de um agente não retorna nada para um terço dos prospects porque sua única fonte não tem celulares. A ferramenta do agente preenche os contatos que a primeira fonte não encontrou, e a plataforma vê a taxa de acerto de cada etapa nos próprios logs.
Quais produtos da Forager este exemplo prático usa?
Números de celular, e-mails corporativos e e-mails pessoais. Números de celular: números de celular diretos de uma pessoa, a partir de uma URL do LinkedIn ou de um ID de pessoa da Forager, validados antes de chegarem até você. E-mails corporativos: endereços de e-mail corporativo verificados de uma pessoa no empregador atual.
Qual é a precisão dos dados da Forager?
A Forager ficou em #1 de 10 no teste de 2026 da Clay com fornecedores de dados de celular, por pontuação de qualidade: a medida da Clay de quão provável é que um número discado alcance a pessoa certa. O teste que importa é o seu: envie uma lista de perfis do seu interesse. Nós executamos e mostramos o que encontramos, número por número, para você mesmo medir a taxa de acerto e a taxa de conexão.
Quais ferramentas podem executar este fluxo de trabalho?
Nativo no Clay e no Zapier, desenvolvido por parceiros na Deepline e no Cargo e acessado pela API no Make, no n8n e no seu próprio código. Ou chame os endpoints das etapas acima do seu próprio código com uma única chave de API.
Quantas etapas tem este fluxo de trabalho?
4 etapas: defina uma ferramenta find_contact no seu framework que receba uma URL do LinkedIn ou nome e empresa, dentro dela, chame POST /person_contacts_lookup/phone_numbers/ e depois POST /person_contacts_lookup/work_emails/ quando a fonte anterior não retornar nada, retorne um resultado tipado com os nomes dos campos, a fonte que o encontrou e o person_id e conte créditos apenas por resultado encontrado, de modo que uma falha na etapa da Forager adicione 0 ao custo da execução.
Preciso de uma assinatura?
Não para testar: uma conta gratuita vem com US$ 5 em créditos. Para continuar usando a Forager, escolha um plano mensal ou anual. Os planos mensais podem ser cancelados a qualquer momento e os créditos não usados acumulam; os planos anuais liberam todos os créditos de início e custam 10% menos. Volumes maiores são combinados com nossa equipe.
Nossos usuários podem ver os dados da Forager no nosso produto?
Sim, conforme os termos da plataforma. Os planos self-service cobrem o uso interno pela sua própria equipe. Exibir contatos da Forager aos seus usuários, ou repassar registros, é licenciado separadamente: fale com vendas sobre volume e sobre quais campos seus usuários precisam ver.
As respostas escritas não estão disponíveis agora. As páginas acima ainda ajudam, ou agende uma demo e pergunte ao time.
- US$ 5 em créditos grátis
- Sem cartão de crédito
- Rode sua amostra
Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a ForagerUma seleção de equipes que usam a Forager
-
Clay - Construtores de workflows de GTM
Caso de uso selecionado: números de celular, e-mails e dados de pessoas da Forager dentro de tabelas do Clay.
-
Juicebox
- Sourcing de candidatos com IA
Caso de uso selecionado: dados da Forager por trás da busca PeopleGPT e dos agentes de sourcing.
-
Nooks - Discadores power e paralelos
Caso de uso selecionado: números de celular dentro do próprio discador (dialer).
-
Emergent Labs
- Criadores de agentes
Plataforma de criação de apps com IA em que agentes projetam, programam e fazem o deploy de apps full-stack.
-
Airscale
- Enriquecimento em cascata (waterfall)
Caso de uso selecionado: uma etapa da Forager na cascata (waterfall) de números de celular.
-
HubSpot
- Complementos de CRM
Caso de uso selecionado: enriquecer registros de contatos e empresas com dados de pessoas, empresas e vagas de emprego.
-
BetterContact - Enriquecimento em cascata (waterfall)
Caso de uso selecionado: uma etapa da Forager na cascata (waterfall) para números de celular.
-
Freckle - Construtores de workflows de GTM
Caso de uso selecionado: a Forager como provedor de números de celular selecionável em seus waterfalls.
Mais exemplos práticos para criadores de agentes
-
Dê a agentes de código ferramentas tipadas de dados de pessoas e empresas
-
Ofereça dados de pessoas e empresas como integração nativa em um construtor de apps com IA
-
Fundamente a pesquisa de contas de um agente com enriquecimento de empresas
-
Ofereça a busca de pessoas como ferramenta de agente
-
Adicione um slot de número de celular a uma cascata de enriquecimento com vários fornecedores
-
Reforce uma base de sales intelligence com uma fonte adicional de celulares