Integrationen & eingehende Quellen

Die CDP ist nur so gut wie das, was in sie hineinfließt. Das Integrationsmodul verwaltet die Leitungen.

Eine Integration erstellen

Einstellungen → Integrationen → Neu, oder:

curl -X POST https://api.wezend.com/v1/integrations \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "shopify", "name": "Hauptshop", "config": { "shop_domain": "acme.myshopify.com", "access_token": "shpat_…" } }'

Eine Integration definiert, was sich verbindet (CRM, Shop, eigenes System), welche Events fließen und wie Kontakte auf Profile abgebildet werden. Zugangsdaten werden im Ruhezustand verschlüsselt.

Shopify: die App statt eines Tokens

Ein Access Token einzufügen funktioniert weiterhin, und für eine private App ist es der kürzeste Weg. Für einen normalen Shop hat die Shopify-App weniger bewegliche Teile: schicken Sie den Händler zu /v1/integrations/shopify/install?shop=acme.myshopify.com&customer_id=<Ihre Konto-ID>, er bestätigt auf Shopifys eigenem OAuth-Bildschirm, und der Callback tauscht den Code gegen ein Token und registriert die Webhooks — Bestellungen, Kunden und Produkte fließen also, ohne dass jemand ein Geheimnis zwischen zwei Dashboards kopiert. Angefragt werden die Scopes read_orders, write_orders, read_customers, read_products und write_script_tags; GET /v1/integrations/shopify/webhooks/:integrationId listet auf, was registriert wurde, begrenzt auf Ihr eigenes Konto.

WooCommerce kommt stattdessen von der Shop-Seite: richten Sie dessen Webhooks auf POST /v1/integrations/woocommerce/webhook. Beide Empfänger prüfen die Signatur des Shops selbst, keiner braucht also einen API-Key.

Eine bestehende Zielgruppe importieren

POST /v1/integrations/:id/import-audience startet einen Hintergrundjob, der die Kontakte des verbundenen Systems abruft (mit Einwilligungsstatus, sofern die Quelle ihn liefert), gegen bestehende Profile dedupliziert und den Fortschritt meldet — polle GET /v1/integrations/import-jobs/:jobId oder beobachte den Fortschrittsbalken im Dashboard. Große Zielgruppen werden importiert, ohne irgendetwas anderes zu blockieren.

Die Verdrahtung testen

Bevor Sie einer Integration vertrauen, klicken Sie auf Testevent senden (POST /v1/integrations/:id/test). Ein synthetisches Event durchläuft die gesamte Pipeline und zeigt Ihnen genau, was ankam und wie es abgebildet wurde — Debugging mit Taschenlampe statt Raten im Dunkeln.

Eigene Systeme: der Event-Feuerwehrschlauch

Alles, was eine HTTP-Anfrage senden kann, ist eine Integration. Streamen Sie Verhaltensevents aus Ihrem Backend oder Ihrer Website an POST /v1/events (siehe Events erfassen), und stelle den eingehenden Webhook bereit, um Antworten in Ihren eigenen Tools zu empfangen. Zwischen diesen beiden und der Reverse-ETL-Aktivierung hin zu Werbeplattformen sitzt WeZend mitten im Stack statt an seinem Ende.