Apollo Automation

Automação Apollo

Acelere sua prospecção de vendas com o Apollo.io -- pesquise empresas, descubra tomadores de decisão, enriqueça dados de contatos com e-mails e números de telefone, e gerencie os estágios do seu pipeline de vendas -- tudo através de comandos em linguagem natural.

Documentação do toolkit: composio.dev/toolkits/apollo

---

Configuração

1. Adicione o servidor MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta do Apollo.io quando solicitado (autenticação via chave de API).
3. Comece a emitir comandos em linguagem natural para prospectar e enriquecer leads.

---

Fluxos de Trabalho Principais

1. Pesquisar Organizações

Encontre empresas-alvo usando filtros como nome, localização, número de funcionários e palavras-chave do setor.

Ferramenta: APOLLO_ORGANIZATION_SEARCH

Exemplo de prompt:

"Encontre empresas de SaaS no Texas com 50-500 funcionários no Apollo"

Parâmetros principais:

• q_organization_name -- Correspondência parcial de nome (ex.: "Apollo" corresponde a "Apollo Inc.")
• organization_locations -- Sedes a incluir (ex.: "texas", "tokyo")
• organization_not_locations -- Sedes a excluir
• organization_num_employees_ranges -- Faixas de funcionários no formato "min,max" (ex.: "50,500")
• q_organization_keyword_tags -- Palavras-chave do setor (ex.: "software", "healthcare")
• page / per_page -- Paginação (máx. 100 por página, máx. 500 páginas)

---

2. Descobrir Pessoas em Empresas

Pesquise a base de contatos do Apollo para pessoas que correspondam a cargo, senioridade, localização e critérios de empresa.

Ferramenta: APOLLO_PEOPLE_SEARCH

Exemplo de prompt:

"Encontre VPs de Vendas em microsoft.com e apollo.io"

Parâmetros principais:

• person_titles -- Cargos (ex.: "VP of Sales", "CTO")
• person_seniorities -- Níveis de senioridade (ex.: "director", "vp", "senior")
• person_locations -- Localizações geográficas das pessoas
• q_organization_domains -- Domínios da empresa (ex.: "apollo.io" -- exclua "www.")
• organization_ids -- IDs da empresa no Apollo (da Pesquisa de Organizações)
• contact_email_status -- Filtro por status do e-mail: "verified", "unverified", "likely to engage"
• page / per_page -- Paginação (máx. 100 por página)

---

3. Enriquece Contatos Individuais

Obtenha dados abrangentes (e-mail, telefone, LinkedIn, informações da empresa) para uma única pessoa usando seu e-mail, URL do LinkedIn ou nome + empresa.

Ferramenta: APOLLO_PEOPLE_ENRICHMENT

Exemplo de prompt:

"Enriqueça Tim Zheng na Apollo.io no Apollo"

Parâmetros principais (pelo menos um identificador é obrigatório):

• email -- Endereço de e-mail da pessoa
• linkedin_url -- URL completa do perfil do LinkedIn
• first_name + last_name + (organization_name ou domain) -- Correspondência baseada em nome
• domain -- Nome do host sem protocolo (ex.: "apollo.io", não "https://apollo.io")
• reveal_personal_emails -- Defina como true para obter e-mails pessoais (pode usar créditos extras)
• reveal_phone_number -- Defina como true para números de telefone (requer webhook_url)

---

4. Enriquece Prospects em Lote

Enriqueça até 10 pessoas simultaneamente para processamento em lote eficiente.

Ferramenta: APOLLO_BULK_PEOPLE_ENRICHMENT

Exemplo de prompt:

"Enriqueça em lote estes 5 leads com seus dados do Apollo: [lista de nomes/e-mails]"

Parâmetros principais:

• details (obrigatório) -- Array de 1 a 10 objetos de pessoa, cada um com identificadores como email, linkedin_url, first_name, last_name, domain, company_name
• reveal_personal_emails -- Incluir e-mails pessoais (créditos extras)
• reveal_phone_number -- Incluir números de telefone (requer webhook_url)

---

5. Gerencie Estágios do Pipeline de Contatos

Liste os estágios disponíveis e atualize contatos ao longo do seu funil de vendas.

Ferramentas: APOLLO_LIST_CONTACT_STAGES, APOLLO_UPDATE_CONTACT_STAGE

Exemplo de prompt:

"Mova os contatos X e Y para o estágio 'Qualificado' no Apollo"

Parâmetros principais para listar estágios: Nenhum obrigatório.

Parâmetros principais para atualizar estágio:

• contact_ids (obrigatório) -- Array de IDs de contatos a serem atualizados
• contact_stage_id (obrigatório) -- ID do estágio de destino (da Listagem de Estágios de Contato)

---

6. Criar e Pesquisar Contatos Salvos

Crie novos registros de contato e pesquise sua base de contatos existente no Apollo.

Ferramentas: APOLLO_CREATE_CONTACT, APOLLO_SEARCH_CONTACTS

Exemplo de prompt:

"Pesquise meus contatos do Apollo por alguém da Stripe"

Parâmetros principais para pesquisa:

• Pesquisa por palavra-chave, filtragem por ID de estágio, opções de ordenação
• page / per_page -- Paginação

Parâmetros principais para criar:

• first_name, last_name, email, organization_name
• account_id -- Vincular a uma organização
• contact_stage_id -- Estágio inicial no funil

---

Armadilhas Conhecidas

• Domínios de organização podem estar vazios: Algumas organizações de APOLLO_ORGANIZATION_SEARCH retornam campos de domínio ausentes ou vazios. Use APOLLO_ORGANIZATION_ENRICHMENT para validar domínios antes de confiar neles.
• HTTP 403 indica problemas de configuração: Uma resposta 403 indica problemas de chave de API ou acesso ao plano -- não tente novamente. Corrija suas credenciais ou plano primeiro.
• Pesquisa de pessoas retorna dados ofuscados: APOLLO_PEOPLE_SEARCH pode mostrar flags has_email/has_direct_phone ou campos ofuscados em vez de detalhes completos do contato. Use APOLLO_PEOPLE_ENRICHMENT para obter informações completas.
• Limites de paginação são rígidos: A pesquisa de pessoas suporta per_page até 100 e no máximo 500 páginas. Parar cedo pode perder grandes partes do conjunto de resultados.
• Enriquecimento em lote tem limites pequenos de lote: APOLLO_BULK_PEOPLE_ENRICHMENT aceita apenas 10 itens por chamada. Pode retornar status='success' com missing_records > 0 quando os identificadores são insuficientes -- tente novamente registros individuais com APOLLO_PEOPLE_ENRICHMENT.
• Sem desduplicação automática: APOLLO_CREATE_CONTACT não desduplica. Verifique contatos existentes primeiro com APOLLO_SEARCH_CONTACTS.
• Formato do domínio importa: Sempre use nomes de host simples (ex.: "apollo.io") sem prefixos de protocolo ("https://") ou prefixo "www.".

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Pesquisar organizações	APOLLO_ORGANIZATION_SEARCH	Nenhum (filtros opcionais)
Enriquecer organização	APOLLO_ORGANIZATION_ENRICHMENT	domain
Enriquece organizações em lote	APOLLO_BULK_ORGANIZATION_ENRICHMENT	domains
Pesquisar pessoas	APOLLO_PEOPLE_SEARCH	Nenhum (filtros opcionais)
Enriquecer pessoa	APOLLO_PEOPLE_ENRICHMENT	Um de: email, linkedin_url, ou nome+empresa
Enriquece pessoas em lote	APOLLO_BULK_PEOPLE_ENRICHMENT	details (1-10 objetos de pessoa)
Listar estágios de contato	APOLLO_LIST_CONTACT_STAGES	Nenhum
Atualizar estágio de contato	APOLLO_UPDATE_CONTACT_STAGE	contact_ids, contact_stage_id
Criar contato	APOLLO_CREATE_CONTACT	Nome + identificadores
Pesquisar contatos	APOLLO_SEARCH_CONTACTS	Nenhum (filtros opcionais)

---

Desenvolvido por Composio