Apollo 자동화

Apollo 자동화은(는) 무엇을 하나요?

Apollo.io로 영업 프로스펙팅을 강화하세요 – 자연어 명령만으로 기업 검색, 의사 결정권자 발견, 이메일 및 전화번호를 포함한 연락처 데이터 보강, 영업 파이프라인 단계 관리를 모두 처리할 수 있습니다.

툴킷 문서: composio.dev/toolkits/apollo

---

설정

1. Composio MCP 서버를 클라이언트 설정에 추가합니다:

   https://rube.app/mcp
   

2. 메시지가 나타나면 Apollo.io 계정을 연결합니다(API 키 인증).
3. 자연어 명령을 사용하여 프로스펙팅과 리드 보강을 시작합니다.

---

핵심 워크플로우

1. 조직 검색

이름, 위치, 직원 수, 산업 키워드 등의 필터를 사용하여 타겟 기업을 찾습니다.

도구: APOLLO_ORGANIZATION_SEARCH

예시 프롬프트:

"텍사스에 있는 직원 50-500명 규모의 SaaS 기업을 Apollo에서 찾아줘"

주요 매개변수:

• q_organization_name -- 부분 이름 일치 (예: "Apollo"는 "Apollo Inc."와 일치)
• organization_locations -- 포함할 본사 위치 (예: "texas", "tokyo")
• organization_not_locations -- 제외할 본사 위치
• organization_num_employees_ranges -- "최소,최대" 형식의 직원 수 범위 (예: "50,500")
• q_organization_keyword_tags -- 산업 키워드 (예: "software", "healthcare")
• page / per_page -- 페이지네이션 (최대 100개/페이지, 최대 500페이지)

---

2. 기업 내 인물 검색

직함, 연차, 위치, 기업 기준에 맞는 인물을 Apollo의 연락처 데이터베이스에서 검색합니다.

도구: APOLLO_PEOPLE_SEARCH

예시 프롬프트:

"microsoft.com과 apollo.io에서 영업 부사장(VPs of Sales)을 찾아줘"

주요 매개변수:

• person_titles -- 직함 (예: "VP of Sales", "CTO")
• person_seniorities -- 연차 수준 (예: "director", "vp", "senior")
• person_locations -- 인물의 지리적 위치
• q_organization_domains -- 기업 도메인 (예: "apollo.io" – "www." 제외)
• organization_ids -- 조직 검색에서 얻은 Apollo 기업 ID
• contact_email_status -- 이메일 상태 필터: "verified", "unverified", "likely to engage"
• page / per_page -- 페이지네이션 (최대 100개/페이지)

---

3. 개별 연락처 보강

이메일, LinkedIn URL, 또는 이름+회사 정보를 사용하여 한 사람의 종합 데이터(이메일, 전화, LinkedIn, 회사 정보)를 가져옵니다.

도구: APOLLO_PEOPLE_ENRICHMENT

예시 프롬프트:

"Apollo에서 Tim Zheng의 정보를 보강해줘"

주요 매개변수 (식별자 중 하나는 필수):

• email -- 개인 이메일 주소
• linkedin_url -- 전체 LinkedIn 프로필 URL
• first_name + last_name + (organization_name 또는 domain) -- 이름 기반 매칭
• domain -- 프로토콜 없는 순수 호스트명 (예: "apollo.io", "https://apollo.io" 아님)
• reveal_personal_emails -- true로 설정 시 개인 이메일 획득 (추가 크레딧 사용 가능)
• reveal_phone_number -- true로 설정 시 전화번호 획득 (webhook_url 필요)

---

4. 잠재 고객 일괄 보강

효율적인 배치 처리를 위해 최대 10명의 인물을 동시에 보강합니다.

도구: APOLLO_BULK_PEOPLE_ENRICHMENT

예시 프롬프트:

"이 5명의 리드를 Apollo 데이터로 일괄 보강해줘: [이름/이메일 목록]"

주요 매개변수:

• details (필수) -- 각각 email, linkedin_url, first_name, last_name, domain, company_name과 같은 식별자를 포함하는 1-10명의 인물 객체 배열
• reveal_personal_emails -- 개인 이메일 포함 (추가 크레딧)
• reveal_phone_number -- 전화번호 포함 (webhook_url 필요)

---

5. 연락처 파이프라인 단계 관리

사용 가능한 단계를 조회하고 영업 퍼널을 통해 연락처를 업데이트합니다.

도구: APOLLO_LIST_CONTACT_STAGES, APOLLO_UPDATE_CONTACT_STAGE

예시 프롬프트:

"Apollo에서 연락처 X와 Y를 'Qualified' 단계로 이동시켜줘"

단계 조회 주요 매개변수: 없음.

단계 업데이트 주요 매개변수:

• contact_ids (필수) -- 업데이트할 연락처 ID 배열
• contact_stage_id (필수) -- 대상 단계 ID (연락처 단계 조회에서 확인)

---

6. 저장된 연락처 생성 및 검색

새 연락처 레코드를 만들고 기존 Apollo 연락처 데이터베이스를 검색합니다.

도구: APOLLO_CREATE_CONTACT, APOLLO_SEARCH_CONTACTS

예시 프롬프트:

"내 Apollo 연락처에서 Stripe 직원을 검색해줘"

검색 주요 매개변수:

• 키워드 검색, 단계 ID 필터링, 정렬 옵션
• page / per_page -- 페이지네이션

생성 주요 매개변수:

• first_name, last_name, email, organization_name
• account_id -- 조직과 연결
• contact_stage_id -- 초기 영업 단계

---

알려진 문제점

• 조직 도메인이 비어 있을 수 있음: APOLLO_ORGANIZATION_SEARCH에서 반환된 일부 조직의 도메인 필드가 누락되었거나 비어 있습니다. 도메인에 의존하기 전에 APOLLO_ORGANIZATION_ENRICHMENT를 사용하여 도메인을 검증하세요.
• HTTP 403은 설정 문제를 의미: 403 응답은 API 키 또는 플랜 접근 문제를 나타냅니다 – 재시도하지 마세요. 먼저 자격 증명이나 플랜을 수정하세요.
• 인물 검색이 난독화된 데이터를 반환: APOLLO_PEOPLE_SEARCH는 전체 연락처 세부 정보 대신 has_email/has_direct_phone 플래그 또는 난독화된 필드를 표시할 수 있습니다. 전체 정보를 얻으려면 APOLLO_PEOPLE_ENRICHMENT를 사용하세요.
• 페이지네이션 제한이 엄격함: 인물 검색은 per_page 최대 100개, 최대 500페이지를 지원합니다. 조기에 중단하면 결과 집합의 상당 부분을 놓칠 수 있습니다.
• 일괄 보강 배치 크기가 작음: APOLLO_BULK_PEOPLE_ENRICHMENT는 호출당 10개 항목만 허용합니다. 식별자가 불충분할 때 status='success'와 함께 missing_records > 0를 반환할 수 있습니다 – 개별 레코드는 APOLLO_PEOPLE_ENRICHMENT로 재시도하세요.
• 자동 중복 제거 없음: APOLLO_CREATE_CONTACT는 중복을 제거하지 않습니다. 먼저 APOLLO_SEARCH_CONTACTS로 기존 연락처를 확인하세요.
• 도메인 형식이 중요: 프로토콜 접두사("https://") 또는 "www." 접두사 없이 항상 순수 호스트명(예: "apollo.io")을 사용하세요.

---

빠른 참조

작업	도구 슬러그	필수 매개변수
조직 검색	APOLLO_ORGANIZATION_SEARCH	없음 (선택적 필터)
조직 보강	APOLLO_ORGANIZATION_ENRICHMENT	domain
조직 일괄 보강	APOLLO_BULK_ORGANIZATION_ENRICHMENT	domains
인물 검색	APOLLO_PEOPLE_SEARCH	없음 (선택적 필터)
인물 보강	APOLLO_PEOPLE_ENRICHMENT	email, linkedin_url 중 하나 또는 이름+회사
인물 일괄 보강	APOLLO_BULK_PEOPLE_ENRICHMENT	details (1-10개 인물 객체)
연락처 단계 조회	APOLLO_LIST_CONTACT_STAGES	없음
연락처 단계 업데이트	APOLLO_UPDATE_CONTACT_STAGE	contact_ids, contact_stage_id
연락처 생성	APOLLO_CREATE_CONTACT	이름 + 식별자
연락처 검색	APOLLO_SEARCH_CONTACTS	없음 (선택적 필터)

---

Composio 제공