ComposioHQ/Apollo-Automation

Apollo Automation

Optimieren Sie Ihre Vertriebsprospektion mit Apollo.io – durchsuchen Sie Unternehmen, finden Sie Entscheidungsträger, reichern Sie Kontaktdaten mit E-Mails und Telefonnummern an und verwalten Sie Ihre Vertriebspipeline-Phasen – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/apollo

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Client-Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Apollo.io-Konto, wenn Sie dazu aufgefordert werden (API-Key-Authentifizierung).
3. Beginnen Sie, natürliche Sprachbefehle zu erteilen, um Interessenten zu prospecten und anzureichern.

---

Kern-Workflows

1. Organisationen durchsuchen

Finden Sie Zielunternehmen mit Filtern wie Name, Standort, Mitarbeiterzahl und Branchen-Keywords.

Tool: APOLLO_ORGANIZATION_SEARCH

Beispielbefehl:

"Finde SaaS-Unternehmen in Texas mit 50-500 Mitarbeitern auf Apollo"

Wichtige Parameter:

• q_organization_name — Teilweise Namensübereinstimmung (z. B. "Apollo" findet "Apollo Inc.")
• organization_locations — Hauptsitz-Standorte, die einbezogen werden sollen (z. B. "texas", "tokyo")
• organization_not_locations — Hauptsitz-Standorte, die ausgeschlossen werden sollen
• organization_num_employees_ranges — Mitarbeiterbereiche im Format "min,max" (z. B. "50,500")
• q_organization_keyword_tags — Branchen-Keywords (z. B. "software", "healthcare")
• page / per_page — Paginierung (max. 100 pro Seite, max. 500 Seiten)

---

2. Personen in Unternehmen finden

Durchsuchen Sie Apollos Kontaktdatenbank nach Personen, die Kriterien wie Position, Dienstalter, Standort und Unternehmen erfüllen.

Tool: APOLLO_PEOPLE_SEARCH

Beispielbefehl:

"Finde VP of Sales bei microsoft.com und apollo.io"

Wichtige Parameter:

• person_titles — Berufsbezeichnungen (z. B. "VP of Sales", "CTO")
• person_seniorities — Dienstalter (z. B. "director", "vp", "senior")
• person_locations — Geografische Standorte der Personen
• q_organization_domains — Unternehmensdomains (z. B. "apollo.io" — "www." ausschließen)
• organization_ids — Apollo-Unternehmens-IDs aus der Organisationssuche
• contact_email_status — Nach E-Mail-Status filtern: "verified", "unverified", "likely to engage"
• page / per_page — Paginierung (max. 100 pro Seite)

---

3. Einzelne Kontakte anreichern

Erhalten Sie umfassende Daten (E-Mail, Telefon, LinkedIn, Unternehmensinfo) für eine einzelne Person anhand ihrer E-Mail, LinkedIn-URL oder Name + Unternehmen.

Tool: APOLLO_PEOPLE_ENRICHMENT

Beispielbefehl:

"Reichere Tim Zheng bei Apollo.io auf Apollo an"

Wichtige Parameter (mindestens eine Kennung erforderlich):

• email — E-Mail-Adresse der Person
• linkedin_url — Vollständige LinkedIn-Profil-URL
• first_name + last_name + (organization_name oder domain) — Namensbasierte Zuordnung
• domain — Bare Hostname ohne Protokoll (z. B. "apollo.io", nicht "https://apollo.io")
• reveal_personal_emails — Auf true setzen, um private E-Mails zu erhalten (kann zusätzliche Credits verbrauchen)
• reveal_phone_number — Auf true setzen für Telefonnummern (erfordert webhook_url)

---

4. Interessenten in Bulk anreichern

Reichern Sie bis zu 10 Personen gleichzeitig für eine effiziente Stapelverarbeitung an.

Tool: APOLLO_BULK_PEOPLE_ENRICHMENT

Beispielbefehl:

"Reichere diese 5 Leads mit ihren Apollo-Daten an: [Liste der Namen/E-Mails]"

Wichtige Parameter:

• details (erforderlich) — Array von 1-10 Personenobjekten, jeweils mit Kennungen wie email, linkedin_url, first_name, last_name, domain, company_name
• reveal_personal_emails — Private E-Mails einschließen (zusätzliche Credits)
• reveal_phone_number — Telefonnummern einschließen (erfordert webhook_url)

---

5. Kontakt-Pipeline-Phasen verwalten

Listen Sie verfügbare Phasen auf und aktualisieren Sie Kontakte durch Ihren Verkaufstrichter.

Tools: APOLLO_LIST_CONTACT_STAGES, APOLLO_UPDATE_CONTACT_STAGE

Beispielbefehl:

"Verschiebe Kontakte X und Y in die Phase 'Qualifiziert' in Apollo"

Wichtige Parameter zum Auflisten von Phasen: Keine erforderlich.

Wichtige Parameter zum Aktualisieren der Phase:

• contact_ids (erforderlich) — Array von Kontakt-IDs, die aktualisiert werden sollen
• contact_stage_id (erforderlich) — Zielphasen-ID (aus Kontaktphasen auflisten)

---

6. Gespeicherte Kontakte erstellen und durchsuchen

Erstellen Sie neue Kontaktdatensätze und durchsuchen Sie Ihre vorhandene Apollo-Kontaktdatenbank.

Tools: APOLLO_CREATE_CONTACT, APOLLO_SEARCH_CONTACTS

Beispielbefehl:

"Durchsuche meine Apollo-Kontakte nach Personen bei Stripe"

Wichtige Parameter für die Suche:

• Stichwortsuche, Filterung nach Phasen-ID, Sortieroptionen
• page / per_page — Paginierung

Wichtige Parameter zum Erstellen:

• first_name, last_name, email, organization_name
• account_id — Mit einer Organisation verknüpfen
• contact_stage_id — Anfängliche Vertriebsphase

---

Bekannte Fallstricke

• Organisationsdomains können leer sein: Einige Organisationen aus APOLLO_ORGANIZATION_SEARCH geben fehlende oder leere Domainfelder zurück. Verwenden Sie APOLLO_ORGANIZATION_ENRICHMENT, um Domains zu validieren, bevor Sie sich darauf verlassen.
• HTTP 403 bedeutet Konfigurationsprobleme: Ein 403-Status weist auf Probleme mit dem API-Key oder Planzugriff hin – wiederholen Sie es nicht. Beheben Sie zuerst Ihre Anmeldeinformationen oder Ihren Plan.
• Personensuche gibt verschleierte Daten zurück: APOLLO_PEOPLE_SEARCH kann has_email/has_direct_phone-Flags oder verschleierte Felder anstelle vollständiger Kontaktdaten anzeigen. Verwenden Sie APOLLO_PEOPLE_ENRICHMENT, um vollständige Informationen zu erhalten.
• Paginierungsgrenzen sind streng: Die Personensuche unterstützt per_page bis zu 100 und maximal 500 Seiten. Ein vorzeitiger Stopp kann große Teile des Ergebnissatzes übersehen.
• Bulk-Anreicherung hat kleine Batch-Grenzen: APOLLO_BULK_PEOPLE_ENRICHMENT akzeptiert nur 10 Einträge pro Aufruf. Es kann status='success' mit missing_records > 0 zurückgeben, wenn die Kennungen nicht ausreichen – wiederholen Sie einzelne Datensätze mit APOLLO_PEOPLE_ENRICHMENT.
• Keine automatische Deduplizierung: APOLLO_CREATE_CONTACT dedupliziert nicht. Überprüfen Sie zuerst mit APOLLO_SEARCH_CONTACTS auf vorhandene Kontakte.
• Domain-Format ist wichtig: Verwenden Sie immer bare Hostnamen (z. B. "apollo.io") ohne Protokollpräfixe ("https://") oder "www."-Präfix.

---

Kurzübersicht

Aktion	Tool-Slug	Erforderliche Parameter
Organisationen durchsuchen	APOLLO_ORGANIZATION_SEARCH	Keine (optionale Filter)
Organisation anreichern	APOLLO_ORGANIZATION_ENRICHMENT	domain
Organisationen in Bulk anreichern	APOLLO_BULK_ORGANIZATION_ENRICHMENT	domains
Personen durchsuchen	APOLLO_PEOPLE_SEARCH	Keine (optionale Filter)
Person anreichern	APOLLO_PEOPLE_ENRICHMENT	Eine von: email, linkedin_url, oder Name+Unternehmen
Personen in Bulk anreichern	APOLLO_BULK_PEOPLE_ENRICHMENT	details (1-10 Personenobjekte)
Kontaktphasen auflisten	APOLLO_LIST_CONTACT_STAGES	Keine
Kontaktphase aktualisieren	APOLLO_UPDATE_CONTACT_STAGE	contact_ids, contact_stage_id
Kontakt erstellen	APOLLO_CREATE_CONTACT	Name + Kennungen
Kontakte durchsuchen	APOLLO_SEARCH_CONTACTS	Keine (optionale Filter)

---

Bereitgestellt von Composio