Web- & Mobile-Push

Push ist der günstigste Kanal, den Sie haben — die Zustellung kostet nichts — und WeZend behandelt ihn als vollwertigen Bürger neben SMS, E-Mail und WhatsApp.

Web-Push mit einem einzigen Script

Fügen Sie das SDK zu Ihrer Website hinzu:

<script src="https://api.wezend.com/zc-push.js"></script>
<script>zcPush({ key: "wz_pk_IHR_PUBLIC_KEY" });</script>

Das Script definiert eine einzige globale Funktion, zcPush() — Sie bestimmen, wann sie aufgerufen wird (nach einer bedeutungsvollen Aktion, nicht beim Seitenaufruf, denn der Aufruf löst die Berechtigungsabfrage des Browsers aus). Sie registriert einen Service Worker (standardmäßig /zc-sw.js; überschreibbar mit der sw-Option), bittet den Besucher um Erlaubnis, holt Ihren öffentlichen VAPID-Schlüssel und registriert das Gerät über POST /v1/push/subscribe. Übergeben Sie email in den Optionen — zcPush({ key: "wz_pk_…", email: currentUserEmail }) — um das Gerät mit dem Kontaktprofil zu verknüpfen.

Web-Push nutzt den offenen VAPID-Standard — es funktioniert in Chrome, Edge, Firefox und Safari ganz ohne App-Store.

Mobile-Push (FCM)

Für iOS/Android-Apps verbinden Sie Ihren Firebase-Cloud-Messaging-Serverschlüssel unter Einstellungen → Kanäle → Push und registrieren dann Device Tokens mit demselben POST /v1/push/subscribe-Endpoint aus Ihrem App-Code — senden Sie { "kind": "fcm", "token": "…", "email": "…" } mit Ihrem öffentlichen Schlüssel (wz_pk_…) im X-ZC-Key-Header.

Versand

Push ist kein Kanal auf POST /v1/messages/send. An einen einzelnen Kontakt senden Sie mit POST /v1/push/test (per contact_id oder email) oder mit einem Push-Schritt in einer Journey. Für Eins-zu-viele erstellen Sie einen Broadcast — dieser Endpoint erfordert eine Dashboard-Session (ein JWT aus POST /v1/auth/login), keinen API-Key:

curl -X POST https://api.wezend.com/v1/push/broadcasts \
  -H "Authorization: Bearer $WEZEND_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Flash-Sale ⚡",
    "body": "25 % auf alles bis Mitternacht.",
    "url": "https://shop.example.com/sale",
    "segment_id": "seg_aktive_kaeufer"
  }'

Klicks werden über POST /v1/push/event zurückgemeldet (das SDK erledigt das für Sie), sodass die Broadcast-Analyse zugestellt → angezeigt → geklickt zeigt, und Klicks speisen Journey-Ziele genau wie E-Mail-Klicks.