Was macht ActiveCampaign Automation via Rube MCP?
Automatisieren Sie ActiveCampaign CRM- und Marketing-Automation-Vorgänge über das Composio ActiveCampaign-Toolkit via Rube MCP.
Voraussetzungen
- Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
- Aktive ActiveCampaign-Verbindung via
RUBE_MANAGE_CONNECTIONSmit Toolkitactive_campaign - Rufen Sie immer zuerst
RUBE_SEARCH_TOOLSauf, um die aktuellen Tool-Schemas zu erhalten
Einrichtung
Rube MCP abrufen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es sind keine API-Schlüssel erforderlich – fügen Sie einfach den Endpunkt hinzu, und es funktioniert.
- Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass
RUBE_SEARCH_TOOLSantwortet - Rufen Sie
RUBE_MANAGE_CONNECTIONSmit dem Toolkitactive_campaignauf - Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die ActiveCampaign-Authentifizierung abzuschließen
- Bestätigen Sie, dass der Verbindungsstatus AKTIV ist, bevor Sie Workflows ausführen
Kern-Workflows
1. Kontakte erstellen und finden
Wann verwenden: Benutzer möchten neue Kontakte erstellen oder bestehende suchen
Werkzeugsequenz:
ACTIVE_CAMPAIGN_FIND_CONTACT– Nach einem bestehenden Kontakt suchen [Optional]ACTIVE_CAMPAIGN_CREATE_CONTACT– Einen neuen Kontakt erstellen [Erforderlich]
Wichtige Parameter für die Suche:
email: Suche nach E-Mail-Adresseid: Suche nach ActiveCampaign-Kontakt-IDphone: Suche nach Telefonnummer
Wichtige Parameter zum Erstellen:
email: E-Mail-Adresse des Kontakts (erforderlich)first_name: Vorname des Kontaktslast_name: Nachname des Kontaktsphone: Telefonnummer des Kontaktsorganization_name: Organisation des Kontaktsjob_title: Berufsbezeichnung des Kontaktstags: Komma-getrennte Liste von Tags, die angewendet werden sollen
Fallstricke:
emailist das einzige Pflichtfeld für die Kontakterstellung- Die Telefonsuche verwendet intern einen allgemeinen Suchparameter; sie kann Teilübereinstimmungen zurückgeben
- Wenn
emailundphonein FIND_CONTACT kombiniert werden, werden die Ergebnisse clientseitig gefiltert - Tags, die während der Erstellung angegeben werden, werden sofort angewendet
- Das Erstellen eines Kontakts mit einer vorhandenen E-Mail kann den vorhandenen Kontakt aktualisieren
2. Kontakt-Tags verwalten
Wann verwenden: Benutzer möchten Tags zu Kontakten hinzufügen oder entfernen
Werkzeugsequenz:
ACTIVE_CAMPAIGN_FIND_CONTACT– Kontakt per E-Mail oder ID finden [Voraussetzung]ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG– Tags hinzufügen oder entfernen [Erforderlich]
Wichtige Parameter:
action: 'Add' oder 'Remove' (erforderlich)tags: Tag-Namen als komma-getrennter String oder Array von Strings (erforderlich)contact_id: Kontakt-ID (entweder dies oder contact_email angeben)contact_email: E-Mail-Adresse des Kontakts (Alternative zu contact_id)
Fallstricke:
action-Werte sind großgeschrieben: 'Add' oder 'Remove' (nicht kleingeschrieben)- Tags können ein komma-getrennter String ('tag1, tag2') oder ein Array (['tag1', 'tag2']) sein
- Entweder
contact_idodercontact_emailmuss angegeben werden;contact_idhat Vorrang - Das Hinzufügen eines nicht existierenden Tags erstellt es automatisch
- Das Entfernen eines nicht existierenden Tags ist ein Nullvorgang (kein Fehler)
3. Listen-Abonnements verwalten
Wann verwenden: Benutzer möchten Kontakte für Listen abonnieren oder abbestellen
Werkzeugsequenz:
ACTIVE_CAMPAIGN_FIND_CONTACT– Kontakt finden [Voraussetzung]ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION– Abonnieren oder abbestellen [Erforderlich]
Wichtige Parameter:
action: 'subscribe' oder 'unsubscribe' (erforderlich)list_id: Numerischer Listen-ID-String (erforderlich)email: E-Mail-Adresse des Kontakts (entweder dies oder contact_id angeben)contact_id: Numerischer Kontakt-ID-String (Alternative zu email)
Fallstricke:
action-Werte sind kleingeschrieben: 'subscribe' oder 'unsubscribe'list_idist ein numerischer String (z.B. '2'), nicht der Listenname- Listen-IDs können über den Endpunkt GET /api/3/lists abgerufen werden (nicht als Composio-Tool verfügbar; ActiveCampaign-UI verwenden)
- Wenn sowohl
emailals auchcontact_idangegeben werden, hatcontact_idVorrang - Das Abbestellen ändert den Status auf '2' (abbestellt), aber der Beziehungsdatensatz bleibt bestehen
4. Kontakte zu Automationen hinzufügen
Wann verwenden: Benutzer möchten einen Kontakt in einen Automationsworkflow einschreiben
Werkzeugsequenz:
ACTIVE_CAMPAIGN_FIND_CONTACT– Überprüfen, ob Kontakt existiert [Voraussetzung]ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION– Kontakt in Automation einschreiben [Erforderlich]
Wichtige Parameter:
contact_email: E-Mail des einzuschreibenden Kontakts (erforderlich)automation_id: ID der Zielautomation (erforderlich)
Fallstricke:
- Der Kontakt muss bereits in ActiveCampaign existieren
- Automationen können nur über die ActiveCampaign-Benutzeroberfläche erstellt werden, nicht über die API
automation_idmuss auf eine bestehende, aktive Automation verweisen- Das Werkzeug führt einen zweistufigen Prozess durch: Kontakt per E-Mail suchen, dann einschreiben
- Automations-IDs finden Sie in der ActiveCampaign-UI oder über GET /api/3/automations
5. Kontaktaufgaben erstellen
Wann verwenden: Benutzer möchten Folgeaufgaben erstellen, die mit Kontakten verknüpft sind
Werkzeugsequenz:
ACTIVE_CAMPAIGN_FIND_CONTACT– Kontakt finden, dem die Aufgabe zugeordnet werden soll [Voraussetzung]ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK– Aufgabe erstellen [Erforderlich]
Wichtige Parameter:
relid: Kontakt-ID, der die Aufgabe zugeordnet werden soll (erforderlich)duedate: Fälligkeitsdatum im ISO-8601-Format mit Zeitzone (erforderlich, z.B. '2025-01-15T14:30:00-05:00')dealTasktype: Aufgaben-Typ-ID basierend auf verfügbaren Typen (erforderlich)title: Aufgabentitelnote: Aufgabenbeschreibung/Inhaltassignee: Benutzer-ID, der die Aufgabe zugewiesen werden solledate: Enddatum im ISO-8601-Format (muss später als duedate sein)status: 0 für unvollständig, 1 für abgeschlossen
Fallstricke:
duedatemuss ein gültiges ISO-8601-Datum mit Zeitzonenoffset sein; KEINE Platzhalterwerte verwendenedatemuss später alsduedateseindealTasktypeist ein String-ID, der auf in ActiveCampaign konfigurierte Aufgabentypen verweistrelidist die numerische Kontakt-ID, nicht die E-Mail-Adresseassigneeist eine Benutzer-ID; lösen Sie Benutzernamen über die ActiveCampaign-UI in IDs auf
Häufige Muster
Kontakt-Lookup-Ablauf
1. ACTIVE_CAMPAIGN_FIND_CONTACT mit E-Mail aufrufen
2. Wenn gefunden, Kontakt-ID für nachfolgende Operationen extrahieren
3. Wenn nicht gefunden, Kontakt mit ACTIVE_CAMPAIGN_CREATE_CONTACT erstellen
4. Kontakt-ID für Tags, Abonnements oder Automationen verwenden
Bulk-Kontakt-Tagging
1. Für jeden Kontakt ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG aufrufen
2. contact_email verwenden, um separate Lookup-Aufrufe zu vermeiden
3. In Batches mit angemessenen Verzögerungen arbeiten, um Ratenlimits einzuhalten
ID-Auflösung
Kontakt-E-Mail -> Kontakt-ID:
1. ACTIVE_CAMPAIGN_FIND_CONTACT mit E-Mail aufrufen
2. id aus der Antwort extrahieren
Bekannte Fallstricke
Groß-/Kleinschreibung von Aktionen:
- Tag-Aktionen: 'Add', 'Remove' (großgeschrieben)
- Abonnement-Aktionen: 'subscribe', 'unsubscribe' (kleingeschrieben)
- Verwechslung der Groß-/Kleinschreibung verursacht Fehler
ID-Typen:
- Kontakt-IDs: numerische Strings (z.B. '123')
- Listen-IDs: numerische Strings
- Automations-IDs: numerische Strings
- Alle IDs sollten als Strings übergeben werden, nicht als Ganzzahlen
Automationen:
- Automationen können nicht über die API erstellt werden; nur die Anmeldung ist möglich
- Automation muss aktiv sein, um neue Kontakte anzunehmen
- Das Einschreiben eines bereits in der Automation befindlichen Kontakts kann wirkungslos sein
Ratenlimits:
- Die ActiveCampaign-API hat Ratenlimits pro Konto
- Backoff bei 429-Antworten implementieren
- Batch-Operationen sollten angemessen zeitlich verteilt werden
Antwort-Parsing:
- Antwortdaten können unter
dataoderdata.dataverschachtelt sein - Defensiv mit Fallback-Mustern parsen
- Kontaktsuche kann mehrere Ergebnisse zurückgeben; zur Genauigkeit nach E-Mail abgleichen
Kurzreferenz
| Aufgabe | Tool-Slug | Wichtige Parameter |
|---|---|---|
| Kontakt finden | ACTIVE_CAMPAIGN_FIND_CONTACT | email, id, phone |
| Kontakt erstellen | ACTIVE_CAMPAIGN_CREATE_CONTACT | email, first_name, last_name, tags |
| Tags hinzufügen/entfernen | ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG | action, tags, contact_email |
| Abonnieren/abbestellen | ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION | action, list_id, email |
| Zu Automation hinzufügen | ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION | contact_email, automation_id |
| Aufgabe erstellen | ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK | relid, duedate, dealTasktype, title |
Wann verwenden
Diese Fähigkeit ist anwendbar, um den in der Übersicht beschriebenen Workflow oder die Aktionen auszuführen.
Einschränkungen
- Verwenden Sie diese Fähigkeit nur, wenn die Aufgabe eindeutig mit dem oben beschriebenen Umfang übereinstimmt.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
- Halten Sie an und fragen Sie nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.