In-app-inkorg

Inte alla meddelanden förtjänar ett avbrott. In-app-inkorgen är ett meddelandecenter du bäddar in i din egen webbapp — tillkännagivanden, funktionsnyheter och kontonotiser landar där och väntar tills användaren loggar in.

Varför en inkorg-kanal

• Noll trötthet — den surrar aldrig en telefon. Perfekt för "bra att veta"-innehåll som annars skulle skada din push-anmälningsfrekvens.
• Garanterad räckvidd — inget spamfilter, ingen notistillåtelse behövs; varje aktiv användare ser den.
• Ett journey-steg som alla andra — journeys kan leverera till inapp precis som SMS eller e-post, så "tillkännage in-app, eskalera till e-post om oläst efter 3 dagar" är ett standardmönster.

Inbäddning

Inkorgen kan läsas på två sätt. Från din backend hämtar du en kontakts inkorg och renderar den i ditt eget UI — endpointen kräver en dashboard-session (en JWT från POST /v1/auth/login), inte en API-nyckel. Lägg till ?unread=1 för endast olästa meddelanden:

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 }

Eller direkt från webbläsaren med din publika spårningsnyckel (wz_pk_…) och den inloggade användarens e-post — ingen hemlighet når någonsin klienten:

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

Rapportera läst-status tillbaka så att oläst-märken förblir korrekta (skicka ett meddelande-id, eller "all" för att rensa allt):

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

Utskick

In-app är inte en kanal på POST /v1/messages/send — använd det dedikerade endpointet (dashboard-session), riktat mot ett contact_id eller en känd email:

curl -X POST https://api.wezend.com/v1/inapp/send \
  -H "Authorization: Bearer $WEZEND_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "email": "anvandare@example.com", "title": "Ny funktion", "body": "Kundresor stöder nu push.", "url": "https://app.example.com/nyheter" }'

Eller lägg till ett in-app-steg i en kundresa. Varje meddelande består av en titel, en brödtext och en valfri call-to-action-URL.