Omnisend-Automation
Automatisieren Sie E-Commerce-Marketing-Abläufe – erstellen und aktualisieren Sie Kontakte, verwalten Sie Abonnentenlisten mit Cursor-Paginierung, führen Sie Massen-Batch-Operationen durch und segmentieren Sie Zielgruppen – alles orchestriert über die Composio MCP-Integration.
Toolkit-Dokumentation: composio.dev/toolkits/omnisend
Einrichtung
- Verbinden Sie Ihr Omnisend-Konto über den Composio MCP-Server unter
https://rube.app/mcp - Der Agent wird Sie mit einem Authentifizierungslink auffordern, falls keine aktive Verbindung besteht
- Nach der Verbindung stehen alle
OMNISEND_*-Tools zur Ausführung bereit
Kern-Workflows
1. Einen Kontakt erstellen oder aktualisieren
Fügen Sie einen Kontakt per E-Mail-Identifikator mit Abonnementstatus, Profilfeldern und optionaler Willkommensnachricht ein (Upsert).
Tool: OMNISEND_CREATE_OR_UPDATE_CONTACT
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
identifiers | array | Ja | Mindestens ein Identifier-Objekt mit id (E-Mail), type (email), optional channels.email.status (subscribed, nonSubscribed, unsubscribed) und sendWelcomeMessage (boolesch) |
firstName | string | Nein | Vorname des Kontakts |
lastName | string | Nein | Nachname des Kontakts |
gender | string | Nein | m oder f |
birthdate | string | Nein | Format: YYYY-MM-DD |
country | string | Nein | Vollständiger Ländername |
countryCode | string | Nein | ISO 3166-1 alpha-2-Code (z. B. US) |
city | string | Nein | Stadtname |
address | string | Nein | Straßenadresse |
postalCode | string | Nein | PLZ/Postleitzahl |
2. Kontakte mit Paginierung auflisten
Rufen Sie Kontakte in Stapeln mit optionalen Filtern nach E-Mail, Telefon, Status, Segment oder Tag ab.
Tool: OMNISEND_LIST_CONTACTS
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | integer | Nein | Ergebnisse pro Seite (Standard: 100, maximal: 250) |
after | string | Nein | Cursor für die nächste Seite (base64-kodierte ContactID) |
before | string | Nein | Cursor für die vorherige Seite |
email | string | Nein | Nach exakter E-Mail-Adresse filtern |
phone | string | Nein | Nach vollständiger Telefonnummer mit Ländervorwahl filtern |
status | string | Nein | Filtern nach: subscribed, nonSubscribed, unsubscribed |
segmentID | integer | Nein | Nach Segment-ID filtern |
tag | string | Nein | Nach Tag filtern (z. B. VIP) |
3. Kontaktdetails abrufen
Rufen Sie das vollständige Profil eines einzelnen Kontakts ab, wenn Sie bereits dessen Kontakt-ID haben.
Tool: OMNISEND_GET_CONTACT
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
contactId | string | Ja | Eindeutige Kontaktkennung (z. B. 60e7412b1234567890abcdef) |
4. Einen vorhandenen Kontakt aktualisieren
Patchen Sie bestimmte Felder eines Kontakts anhand der ID, ohne den gesamten Datensatz zu überschreiben.
Tool: OMNISEND_UPDATE_CONTACT
Erfordert die contactId und die zu aktualisierenden Felder. Rufen Sie die Kontakt-ID zunächst über OMNISEND_LIST_CONTACTS oder OMNISEND_GET_CONTACT ab.
5. Batch-Operationen in großen Mengen
Verarbeiten Sie viele Datensätze asynchron in einem einzigen Aufruf – Kontakte, Produkte, Bestellungen, Ereignisse oder Kategorien.
Tool: OMNISEND_CREATE_BATCH
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
method | string | Ja | POST oder PUT |
endpoint | string | Ja | Ziel: contacts, orders, products, events, categories |
items | array | Ja | Array von Nutzlastobjekten für jeden Vorgang |
eventID | string | Bedingt | Erforderlich, wenn der Endpunkt events ist |
Verwenden Sie Batch-Operationen, um Ratenbegrenzungen bei der Verarbeitung großer Datensätze zu vermeiden.
Bekannte Fallstricke
| Fallstrick | Details |
|---|---|
| Identifikator erforderlich | OMNISEND_CREATE_OR_UPDATE_CONTACT erfordert mindestens einen Identifikator im identifiers-Array – nur der Typ email wird unterstützt |
| Cursor-basierte Paginierung | OMNISEND_LIST_CONTACTS verwendet base64-kodierte after/before-Cursor, keine Seitennummern – folgen Sie den Cursorn, um unvollständige Daten zu vermeiden |
| Kontakt-ID-Auflösung | OMNISEND_UPDATE_CONTACT erfordert eine contactId – lösen Sie diese immer zuerst über Listen- oder Abrufoperationen auf |
| Batch-Methoden-Einschränkungen | OMNISEND_CREATE_BATCH akzeptiert nur die Methoden POST oder PUT – kein DELETE oder PATCH |
| Event-ID-Abhängigkeit | Bei der Stapelverarbeitung von Ereignissen ist der Parameter eventID obligatorisch – das Weglassen führt zum Fehlschlagen des Batch-Vorgangs |
Kurzreferenz
| Tool-Slug | Zweck |
|---|---|
OMNISEND_CREATE_OR_UPDATE_CONTACT | Kontakt per E-Mail erstellen oder aktualisieren (Upsert) |
OMNISEND_LIST_CONTACTS | Kontakte mit Filterung und Cursor-Paginierung auflisten |
OMNISEND_GET_CONTACT | Vollständiges Profil eines einzelnen Kontakts anhand der ID abrufen |
OMNISEND_UPDATE_CONTACT | Bestimmte Felder eines vorhandenen Kontakts patchen |
OMNISEND_CREATE_BATCH | Asynchrone Massenoperationen für Kontakte, Produkte, Bestellungen, Ereignisse |
Unterstützt von Composio