Customer.io Automatisierung
Automatisieren Sie Kundeninteraktionsvorgänge – lösen Sie zielgerichtete Broadcasts aus, rufen Sie Zustellmetriken ab, verwalten Sie Zielgruppensegmente, listen Sie Newsletter und Transaktionsvorlagen auf und prüfen Sie den Trigger-Ausführungsverlauf – alles orchestriert über die Composio MCP-Integration.
Toolkit-Dokumentation: composio.dev/toolkits/customerio
Einrichtung
- Verbinden Sie Ihr Customer.io-Konto über den Composio MCP-Server unter
https://rube.app/mcp - Der Agent fordert Sie mit einem Authentifizierungslink auf, falls keine aktive Verbindung besteht
- Nach der Verbindung stehen alle
CUSTOMERIO_*-Tools zur Ausführung bereit
Kern-Workflows
1. Einen Broadcast auslösen
Löst manuell einen vorkonfigurierten Broadcast an eine bestimmte Zielgruppe mit Personalisierungsdaten aus.
Tool: CUSTOMERIO_TRIGGER_BROADCAST
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
broadcast_id | integer | Ja | Broadcast-ID aus den Customer.io-Triggerdetails |
ids | array | Nein | Liste der anzusprechenden Kunden-IDs |
emails | array | Nein | Liste der anzusprechenden E-Mail-Adressen |
recipients | object | Nein | Komplexer Filter mit and/or/not/segment-Operatoren |
per_user_data | array | Nein | Pro-Benutzer-Personalisierung mit id/email + data |
data | object | Nein | Globale Schlüssel-Wert-Daten für Liquid-Vorlagen-Personalisierung |
data_file_url | string | Nein | URL zu einer JSON-Datei mit benutzerbezogenen Daten pro Zeile |
email_add_duplicates | boolean | Nein | Doppelte Empfänger zulassen (Standard: false) |
email_ignore_missing | boolean | Nein | Personen ohne E-Mail überspringen (Standard: false) |
id_ignore_missing | boolean | Nein | Personen ohne Kunden-ID überspringen (Standard: false) |
Wichtig: Geben Sie GENAU EINE Zielgruppenoption an: recipients, ids, emails, per_user_data oder data_file_url. Ratengrenze: 1 Anfrage pro 10 Sekunden pro Broadcast.
2. Nachrichten-Zustellmetriken abrufen
Ruft paginierte Zustellmetriken für Nachrichten mit Filterung nach Kampagne, Typ und Zeitfenster ab.
Tool: CUSTOMERIO_GET_MESSAGES
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
type | string | Nein | Nachrichtentyp: email, webhook, twilio, slack, push, in_app |
metric | string | Nein | Metrik: attempted, sent, delivered, opened, clicked, converted |
campaign_id | integer | Nein | Nach Kampagnen-ID filtern |
newsletter_id | integer | Nein | Nach Newsletter-ID filtern |
action_id | integer | Nein | Nach Aktions-ID filtern |
start_ts | integer | Nein | Beginn des Zeitfensters (Unix-Zeitstempel) |
end_ts | integer | Nein | Ende des Zeitfensters (Unix-Zeitstempel) |
limit | integer | Nein | Ergebnisse pro Seite, 1–1000 (Standard: 50) |
start | string | Nein | Paginierungstoken aus dem vorherigen Antwort-next-Wert |
drafts | boolean | Nein | Entwurfsnachrichten anstelle von aktiven/gesendeten zurückgeben |
3. Zielgruppensegmente auflisten
Ruft alle in Ihrem Arbeitsbereich definierten Segmente zur Zielgruppenanalyse und Broadcast-Ausrichtung ab.
Tool: CUSTOMERIO_GET_SEGMENTS
Keine Parameter erforderlich – gibt alle Segmente mit IDs und Metadaten zurück.
Verwenden Sie Segment-IDs, wenn Sie Broadcasts über den Filter recipients.segment.id ausrichten.
4. Newsletter auflisten
Blättert durch alle Newsletter-Metadaten zum Verfolgen und Analysieren.
Tool: CUSTOMERIO_LIST_NEWSLETTERS
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | integer | Nein | Maximal pro Seite, 1–100 |
sort | string | Nein | asc (chronologisch) oder desc (umgekehrt) |
start | string | Nein | Paginierungscursor aus dem vorherigen Antwort-next-Wert |
5. Transaktionsnachrichtenvorlagen entdecken
Listet alle Transaktionsnachrichtenvorlagen auf, um IDs zum Senden über die API zu finden.
Tool: CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES
Keine Parameter erforderlich – gibt Vorlagen-IDs und Triggernamen zurück.
6. Broadcast-Triggerverlauf prüfen
Überprüft alle Triggerausführungen für einen Broadcast und prüft einzelne Triggerdetails.
Tools: CUSTOMERIO_GET_TRIGGERS und CUSTOMERIO_GET_TRIGGER
Alle Trigger für einen Broadcast auflisten:
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
broadcast_id | integer | Ja | Die Broadcast-/Kampagnen-ID |
Einen bestimmten Trigger abrufen:
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
broadcast_id | integer | Ja | Die Kampagnen-/Broadcast-ID |
trigger_id | string | Ja | Trigger-Kennung (z. B. 456 oder 5-37) |
Bekannte Fallstricke
| Fallstrick | Details |
|---|---|
| Sich gegenseitig ausschließende Zielgruppenparameter | CUSTOMERIO_TRIGGER_BROADCAST erfordert GENAU EINE der Optionen recipients, ids, emails, per_user_data oder data_file_url – die Angabe mehrerer führt zu Fehlern |
| Ratenbegrenzung bei Broadcasts | Broadcasts sind auf 1 Triggeranfrage pro 10 Sekunden pro Broadcast-ID beschränkt |
| Unix-Zeitstempelformat | start_ts und end_ts in CUSTOMERIO_GET_MESSAGES müssen Unix-Zeitstempel sein, keine ISO-Strings |
| Paginierungstoken | Nachrichten und Newsletter verwenden cursor-basierte Paginierung über den Parameter start – verwenden Sie den next-Wert aus vorherigen Antworten |
| Segment-ID-Auflösung | Um ein Segment in einem Broadcast anzusprechen, rufen Sie zuerst die Segment-IDs über CUSTOMERIO_GET_SEGMENTS ab und referenzieren Sie sie dann per ID in recipients.segment.id |
Kurzreferenz
| Tool-Slug | Zweck |
|---|---|
CUSTOMERIO_TRIGGER_BROADCAST | Einen Broadcast an eine definierte Zielgruppe auslösen |
CUSTOMERIO_GET_MESSAGES | Nachrichtenzustellmetriken mit Filtern abrufen |
CUSTOMERIO_GET_SEGMENTS | Alle Zielgruppensegmente auflisten |
CUSTOMERIO_GET_SEGMENT_DETAILS | Details zu einem bestimmten Segment abrufen |
CUSTOMERIO_LIST_NEWSLETTERS | Durch Newsletter blättern |
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES | Transaktionsnachrichtenvorlagen auflisten |
CUSTOMERIO_GET_TRIGGERS | Alle Triggerausführungen für einen Broadcast auflisten |
CUSTOMERIO_GET_TRIGGER | Eine bestimmte Triggerausführung prüfen |
Bereitgestellt von Composio