Instantly-Automation (Composio)

Instantly-Automatisierung

Automatisieren Sie Ihre Kaltakquise per E-Mail mit Instantly – erstellen und verwalten Sie Kampagnen mit mehrstufigen Sequenzen, konfigurieren Sie Sendezeitpläne, importieren Sie Leads in großen Mengen, verwalten Sie Versandkonten und verfolgen Sie die Kampagnenleistung – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/instantly

---

Einrichtung

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

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Instantly-Konto, wenn Sie dazu aufgefordert werden (API-Schlüssel-Authentifizierung).
3. Beginnen Sie, natürliche Sprachbefehle zur Verwaltung Ihrer Outreach-Kampagnen zu geben.

---

Kern-Workflows

1. Versandkonten auflisten

Rufen Sie alle in Ihrem Instantly-Arbeitsbereich konfigurierten E-Mail-Konten ab, mit Filterung nach Status und Anbieter.

Tool: INSTANTLY_LIST_ACCOUNTS

Beispielaufforderung:

„Zeige alle aktiven Versandkonten in meinem Instantly-Arbeitsbereich an“

Wichtige Parameter:

• status – Nach Status filtern: 1 (Aktiv), 2 (Pausiert), -1 (Verbindungsfehler), -2 (Soft-Bounce-Fehler), -3 (Sendefehler)
• provider_code – Nach Anbieter filtern: 1 (Benutzerdefiniert IMAP/SMTP), 2 (Google), 3 (Microsoft), 4 (AWS)
• search – Nach E-Mail-Substring oder Domain suchen
• limit – Maximale Anzahl (1-100)
• starting_after – Paginierungs-Cursor aus vorheriger Antwort
• tag_ids – Komma-getrennte Tag-UUIDs

---

2. Kampagne erstellen

Starten Sie eine neue Outreach-Kampagne mit Zeitplanung, E-Mail-Sequenzen, A/B-Testing-Varianten und Sendekonfiguration.

Tool: INSTANTLY_CREATE_CAMPAIGN

Beispielaufforderung:

„Erstelle eine Instantly-Kampagne namens 'Q1 Outreach', die Montag-Freitag von 9:00-17:00 Uhr Central Time sendet, mit einer 3-stufigen E-Mail-Sequenz“

Wichtige Parameter:

• name (erforderlich) – Kampagnenname
• campaign_schedule (erforderlich) – Zeitplankonfiguration:
  • schedules (erforderlich) – Array von Zeitplanobjekten, jedes mit:
    • name – Zeitplanname
    • timing – {from: "09:00", to: "17:00"} (HH:mm-Format)
    • days – Mapping von Tagesindex-Strings „0“ (So) bis „6“ (Sa) auf Booleans
    • timezone – Unterstützte Werte: „America/Chicago“, „America/Detroit“, „America/Boise“, „America/Anchorage“
  • start_date / end_date – ISO 8601-Daten
• email_list – Array von E-Mail-Adressen der Versandkonten (müssen vorkonfigurierte Konten sein; verwenden Sie INSTANTLY_LIST_ACCOUNTS, um gültige Adressen zu ermitteln)
• sequences – Array (nur erstes Element wird verwendet) mit:
  • steps – Array von Schrittobjekten mit:
    • type – Muss „email“ sein
    • delay – Tage bis zur NÄCHSTEN E-Mail (ganze Zahl, min. 0)
    • variants – Array von {subject, body}-Objekten für A/B-Testing
• daily_limit – Tägliches Sendelimit
• email_gap – Minuten zwischen E-Mails
• stop_on_reply – Kampagne stoppen, wenn ein Lead antwortet (Boolean)
• stop_on_auto_reply – Bei automatischen Antworten stoppen (Boolean)
• open_tracking / link_tracking – Tracking aktivieren (Booleans)

Hinweise zu Zeitzonen:

• Bestätigt funktionierend: „America/Chicago“ (Central), „America/Detroit“ (Eastern), „America/Boise“ (Mountain)
• Automatisch zugeordnet: „America/New_York“ wird auf „America/Detroit“ gemappt, „America/Denver“ auf „America/Boise“
• NICHT unterstützt: „America/Los_Angeles“, „US/Pacific“ – verwenden Sie stattdessen „America/Anchorage“ oder „America/Dawson“ als Alternativen

---

3. Kampagneneinstellungen aktualisieren

Ändern Sie den Zeitplan, die Sendelimitierungen, Sequenzen oder Tracking-Einstellungen einer bestehenden Kampagne.

Tool: INSTANTLY_UPDATE_CAMPAIGN

Beispielaufforderung:

„Aktualisiere meine Instantly-Kampagne, erhöhe das tägliche Limit auf 100 und aktiviere das Öffnungs-Tracking“

Wichtige Parameter:

• id (erforderlich) – Kampagnen-UUID
• Jede Kombination aus: name, campaign_schedule, email_list, sequences, daily_limit, email_gap, stop_on_reply, open_tracking, link_tracking usw.
• Setzen Sie einen Parameter auf null, um ihn zu entfernen

---

4. Lead-Listen verwalten und Massenimport

Erstellen Sie dedizierte Lead-Listen und importieren Sie Interessenten in großen Mengen für das Kampagnen-Targeting.

Tools: INSTANTLY_CREATE_LEAD_LIST, INSTANTLY_ADD_LEADS_BULK

Beispielaufforderung:

„Erstelle eine Lead-Liste namens 'Q1 Prospects' und füge 50 Leads zu meiner Instantly-Kampagne hinzu“

Wichtige Parameter zum Erstellen von Lead-Listen:

• Listenname und Konfiguration

Wichtige Parameter für den Massenimport von Leads:

• Kampagnen- oder Listen-ID, in die importiert werden soll
• Array von Lead-Objekten mit E-Mail und Metadaten
• Optionen zur Duplikatbehandlung
• Einstellungen zur Lead-Verifizierung

---

5. Kampagnendetails anzeigen

Rufen Sie die vollständige Kampagnenkonfiguration ab, um Einstellungen zu überprüfen, Sequenzen zu inspizieren oder sich auf Aktualisierungen vorzubereiten.

Tool: INSTANTLY_GET_CAMPAIGN

Beispielaufforderung:

„Zeige mir alle Details meiner Instantly-Kampagne an“

Wichtige Parameter:

• id (erforderlich) – Kampagnen-UUID

---

6. Alle Kampagnen auflisten

Listen Sie alle Kampagnen in Ihrem Arbeitsbereich auf, mit optionalen Filtern und Paginierung.

Tool: INSTANTLY_LIST_CAMPAIGNS

Beispielaufforderung:

„Liste alle meine Instantly-Kampagnen auf“

Wichtige Parameter:

• Optionale Filter- und Paginierungsparameter

---

Bekannte Fallstricke

• Die Zeitzonenunterstützung ist eingeschränkt: Die Instantly-API akzeptiert nur einen begrenzten Satz von Zeitzonen-Strings. Pacific Time („America/Los_Angeles“) wird NICHT unterstützt. Verwenden Sie stattdessen „America/Anchorage“ (UTC-9/UTC-8) oder „America/Dawson“ (UTC-7 ganzjährig) als Alternativen.
• Ungültige Zeitplan-Payloads verursachen 400-Fehler: Ein fehlerhafter campaign_schedule (fehlende days, from, to oder schedules) löst HTTP 400 aus. Wiederholte 400er deuten auf Payload-Probleme hin, nicht auf vorübergehende Fehler.
• Sequenzen müssen vollständig sein: Jeder Sequenzschritt erfordert einen gültigen type („email“), delay und mindestens eine Variante mit sowohl subject als auch body. Unvollständige Varianten blockieren die Kampagnenerstellung.
• Nur das erste Sequenz-Element wird verwendet: Die API verarbeitet nur sequences[0]. Weitere Sequenzen werden ignoriert.
• email_list muss auf bestehende Konten verweisen: Das Feld email_list erfordert E-Mail-Adressen von vorkonfigurierten Versandkonten in Ihrem Instantly-Arbeitsbereich, nicht beliebige Empfängeradressen. Verwenden Sie stets INSTANTLY_LIST_ACCOUNTS, um gültige Versandadressen zu ermitteln.
• 401-Bereichsfehler bei der Kampagnenerstellung: Die Kampagnenerstellung kann mit „Invalid scope. Required: campaigns:create“ fehlschlagen. Aktualisieren Sie Ihre API-Schlüssel-Berechtigungen, bevor Sie Schreibvorgänge wiederholen.
• Rücklesefelder können abweichen: Feldnamen in INSTANTLY_GET_CAMPAIGN-Antworten können von den Erstellungs-Payloads abweichen (z. B. timing.from_ vs. timing.from). Parsen Sie defensiv.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Versandkonten auflisten	INSTANTLY_LIST_ACCOUNTS	Keine (optionale Filter)
Kampagne erstellen	INSTANTLY_CREATE_CAMPAIGN	name, campaign_schedule
Kampagne aktualisieren	INSTANTLY_UPDATE_CAMPAIGN	id
Kampagnendetails abrufen	INSTANTLY_GET_CAMPAIGN	id
Kampagnen auflisten	INSTANTLY_LIST_CAMPAIGNS	Keine (optionale Filter)
Lead-Liste erstellen	INSTANTLY_CREATE_LEAD_LIST	Listenname
Leads massenimportieren	INSTANTLY_ADD_LEADS_BULK	Kampagnen-/Listen-ID, Leads

---

Bereitgestellt von Composio