In-App-Posteingang

Nicht jede Nachricht verdient eine Unterbrechung. Der In-App-Posteingang ist ein Nachrichtenzentrum, das Sie in Ihre eigene Web-App einbetten — Ankündigungen, Feature-News und Kontohinweise landen dort und warten, bis sich der Nutzer anmeldet.

Warum ein Posteingang-Kanal

• Null Ermüdung — er lässt nie ein Telefon vibrieren. Perfekt für "gut zu wissen"-Inhalte, die sonst Ihrer Push-Anmelderate schaden würden.
• Garantierte Reichweite — kein Spamfilter, keine Benachrichtigungserlaubnis nötig; jeder aktive Nutzer sieht ihn.
• Ein Journey-Schritt wie jeder andere — Journeys können an inapp liefern, genau wie SMS oder E-Mail, sodass "In-App ankündigen, nach 3 Tagen bei Ungelesenheit auf E-Mail eskalieren" ein Standardmuster ist.

Einbettung

Der Posteingang lässt sich auf zwei Wegen lesen. Aus Ihrem Backend rufen Sie den Posteingang eines Kontakts ab und rendern ihn in Ihrem eigenen UI — dieser Endpoint erfordert eine Dashboard-Session (ein JWT aus POST /v1/auth/login), keinen API-Key. Hängen Sie ?unread=1 an, um nur ungelesene Nachrichten zu erhalten:

curl "https://api.wezend.com/v1/inapp/c_123" \
  -H "Authorization: Bearer $WEZEND_JWT"
# → { "messages": [ { "id": "…", "title": "…", "body": "…", "url": "…", "read_at": null, "created_at": "…" } ], "unread": 2 }

Oder direkt aus dem Browser mit Ihrem öffentlichen Tracking-Schlüssel (wz_pk_…) und der E-Mail des angemeldeten Nutzers — kein Geheimnis erreicht jemals den Client:

curl -X POST https://api.wezend.com/v1/inapp/feed \
  -H "Content-Type: application/json" \
  -d '{ "key": "wz_pk_…", "email": "nutzer@example.com", "unread_only": true }'

Melden Sie den Gelesen-Status zurück, damit Ungelesen-Badges korrekt bleiben (übergeben Sie eine Nachrichten-id oder "all", um alles zu leeren):

curl -X POST https://api.wezend.com/v1/inapp/read \
  -H "Content-Type: application/json" \
  -d '{ "key": "wz_pk_…", "email": "nutzer@example.com", "id": "msg_456" }'

Versand

In-App ist kein Kanal auf POST /v1/messages/send — nutzen Sie den dedizierten Endpoint (Dashboard-Session), gerichtet an eine contact_id oder eine bekannte email:

curl -X POST https://api.wezend.com/v1/inapp/send \
  -H "Authorization: Bearer $WEZEND_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "email": "nutzer@example.com", "title": "Neues Feature", "body": "Journeys unterstützen jetzt Push.", "url": "https://app.example.com/news" }'

Oder fügen Sie einen In-App-Schritt in eine Journey ein. Jede Nachricht besteht aus einem Titel, einem Text und einer optionalen Call-to-Action-URL.