Standard-InboxKit-Feed mit Banner-, Untertitel-, Klassik-, Karussell-, Video- und Apple Wallet-Karten.

for an

. */}

InboxKit Banner-Karte — **Banner-Karte**

InboxKit Untertitel-Karte — **Untertitel-Karte**

InboxKit Klassik-Karte — **Klassik-Karte**

InboxKit Karussell-Karte — **Karussell-Karte**

InboxKit Apple Wallet-Karte — **Apple Wallet-Karte**

Banner-, Untertitel- und Klassik-Karten werden durch die Standard-Nachrichtenfelder (Bild, Titel, Text) sowie das optionale `buttons`-Array gesteuert – siehe [Inline-CTA-Schaltflächen hinzufügen](#add-inline-cta-buttons). Die Karussell-, Video- und Apple Wallet-Karten enthalten zusätzliche strukturierte Daten in `data`, die unten dokumentiert sind. ### Karussell-Karte Ein Karussell rendert mehrere Bilder aus einer einzigen Nachricht – eine wischbare Galerie mit optionalen Bildunterschriften pro Folie und Zielen beim Tippen. Die Folien befinden sich in `data.carousel`. Jede Folie benötigt ein `image`; `title` (Untertitel-Overlay) und `url` (Deep Link, der beim Tippen geöffnet wird) sind optional. Eine Folie ohne Bild wird verworfen; ein Tippen auf eine Folie ohne `url` fällt auf die Standard-Zeilenaktion der Nachricht zurück. ```json title="POST https://api.pushwoosh.com/json/1.3/createMessage" { "request": { "application": "XXXXX-XXXXX", "auth": "API_TOKEN", "notifications": [{ "send_date": "now", "ios_title": "New arrivals", "content": "Swipe through this week's drops", "inbox_days": 7, "data": { "displayType": "carousel", "carousel": [ { "image": "https://cdn.example.com/inbox/1.jpg", "title": "New in", "url": "myapp://product/1" }, { "image": "https://cdn.example.com/inbox/2.jpg", "title": "On sale", "url": "myapp://product/2" }, { "image": "https://cdn.example.com/inbox/3.jpg" } ] }, "platforms": [1] }] } } ``` ### Video-Karte Eine Video-Karte zeigt ein Posterbild mit einem Play-Badge; ein Tippen darauf öffnet einen Vollbild-Player (Ton an, auch bei aktiviertem Stummschalter). Der Deskriptor befindet sich in `data.video`: `url` ist erforderlich und muss ein `http`/`https`-Stream oder eine Datei sein; `poster` ist ein optionales Vorschaubild. ```json title="POST https://api.pushwoosh.com/json/1.3/createMessage" { "request": { "application": "XXXXX-XXXXX", "auth": "API_TOKEN", "notifications": [{ "send_date": "now", "ios_title": "Watch the reveal", "content": "Tap to play", "inbox_days": 7, "data": { "displayType": "video", "video": { "url": "https://cdn.example.com/inbox/clip.mp4", "poster": "https://cdn.example.com/inbox/poster.jpg" } }, "platforms": [1] }] } } ``` ### Apple Wallet-Karte Die Apple Wallet-Karte zeigt ein optionales Hero-Bild, einen Titel und einen Text über der offiziellen **Zu Apple Wallet hinzufügen**-Schaltfläche. Ein Tippen auf die Schaltfläche lädt die `.pkpass`-Datei herunter und präsentiert das Systemblatt zum Hinzufügen von Pässen. Verwenden Sie es, um Gutscheine, Kundenkarten, Tickets oder Bordkarten direkt aus dem Posteingang zu liefern. Die Karte ist nur für iOS / Mac Catalyst verfügbar – auf anderen Plattformen wird die Nachricht als Klassik-Karte gerendert. Die Pass-URL befindet sich in `data.wallet`, entweder als reiner String oder als Objekt mit einem `pass`-Feld. Ein optionales `data.image` fügt das Hero-Bild hinzu. Die Schaltfläche blendet sich automatisch aus, wenn keine Pass-URL vorhanden ist oder das Gerät keine Pässe hinzufügen kann. ```json title="POST https://api.pushwoosh.com/json/1.3/createMessage" { "request": { "application": "XXXXX-XXXXX", "auth": "API_TOKEN", "notifications": [{ "send_date": "now", "ios_title": "Your loyalty card is ready", "content": "Add it to Apple Wallet in one tap", "inbox_days": 7, "data": { "displayType": "wallet", "image": "https://cdn.example.com/inbox/loyalty.png", "wallet": "https://passes.example.com/v1/passes/pass.com.example.loyalty/abc123?token=…" }, "platforms": [1] }] } } ``` Das Ergebnis wird an Ihren Delegate gemeldet: ```swift extension MyInboxHost: PushwooshInboxKitDelegate { func inboxKit(_ vc: PushwooshInboxKitViewController, didAddWalletPassFor message: PWInboxMessageProtocol) { // The pass is now in the user's Wallet — show a confirmation if you like. } func inboxKit(_ vc: PushwooshInboxKitViewController, didFailToAddWalletPassFor message: PWInboxMessageProtocol, error: Error?) { // Download failed — surface a retry, log, etc. } } ``` Beide Callbacks sind optional (sie haben standardmäßig leere Implementierungen). Wenn ein Benutzer das Systemblatt abbricht, ist dies weder ein Erfolg noch ein Fehlschlag, daher wird in diesem Fall kein Callback ausgelöst. ## Barrierefreiheit InboxKit-Zellen sind von Haus aus VoiceOver-fähig. Banner-, Untertitel- und Klassik-Karten stellen ihren Titel, Text und ihr Datum über die zugrunde liegenden Labels zur Verfügung, und Inline-CTA-Schaltflächen lesen ihre eigenen Titel vor. Die Rich-Karten fügen explizite Semantik hinzu: - **Video** – das Poster wird als einzelnes Schaltflächenelement mit der Bezeichnung "Video abspielen" (Eigenschaften `.button` + `.startsMediaSession`) bereitgestellt, sodass VoiceOver es als Mediensteuerung anstelle eines einfachen Bildes ankündigt. - **Karussell** – jede Folie ist ein Schaltflächenelement, dessen Barrierefreiheits-Label die Bildunterschrift der Folie ist, oder "Folie", wenn keine vorhanden ist. Der Seitenindikator gibt die aktuelle Position als "*n* von *gesamt*" an. - **Apple Wallet** – die **Zu Apple Wallet hinzufügen**-Schaltfläche ist Apples Standard-`PKAddPassButton`, der sein eigenes lokalisiertes VoiceOver-Label trägt. Für UI-Tests und Automatisierung sind zwei stabile `accessibilityIdentifier` gesetzt: `inboxkit.video.play` auf dem Video-Poster und `inboxkit.wallet.add` auf der Wallet-Schaltfläche. ## Benutzerdefinierte Daten aus einer Nachricht lesen Damit ein Push im Posteingang erscheint, muss die [Messages API](/de/developer/api-reference/messages-api/) `createMessage`-Anfrage `inbox_image`, `inbox_date` oder `inbox_days` enthalten – ohne eines dieser Felder wird der Push als reguläre Benachrichtigung zugestellt und erreicht niemals den Posteingangs-Feed. Freiform-benutzerdefinierte Daten gehören unter den `data`-Schlüssel, den das SDK als `u`-Parameter an den Client liefert: ```json title="POST https://api.pushwoosh.com/json/1.3/createMessage" { "request": { "application": "XXXXX-XXXXX", "auth": "API_TOKEN", "notifications": [{ "send_date": "now", "ios_title": "Summer sale", "content": "30% off everything — limited time only", "inbox_image": "https://cdn.example.com/inbox/summer.png", "inbox_days": 7, "data": { "displayType": "captioned", "promo_id": "SUMMER2026", "screen": "promo_details" }, "platforms": [1] }] } } ``` Das SDK stellt dieses Objekt in der Posteingangsnachricht über `actionParams` zur Verfügung. Lesen Sie es aus dem Delegate, wenn der Benutzer auf die Zeile oder einen Inline-CTA tippt: ```swift extension MyInboxHost: PushwooshInboxKitDelegate { func inboxKit(_ vc: PushwooshInboxKitViewController, didSelect message: PWInboxMessageProtocol) -> Bool { guard let params = message.actionParams as? [String: Any] else { return true } // The custom `data` object arrives under the "u" key — // either as a nested dictionary or as a JSON-encoded string, // depending on how the payload was built upstream. let custom: [String: Any]? = { if let dict = params["u"] as? [String: Any] { return dict } if let raw = params["u"] as? String, let bytes = raw.data(using: .utf8), let parsed = try? JSONSerialization.jsonObject(with: bytes) as? [String: Any] { return parsed } return nil }() if let promoId = custom?["promo_id"] as? String { navigateToPromo(promoId) return false // we handled the tap; SDK should not run the default action } return true } } ``` Dieselbe `actionParams["u"]`-Suche funktioniert in `inboxKit(_:didTapButton:onMessage:)` für Inline-CTA-Schaltflächen. Für die typisierten CTA-Fälle (`openURL`, `dismiss`, `markRead`) führt das SDK bereits die Standardaktion aus – geben Sie `true` zurück, um dieses Verhalten beizubehalten, oder `false`, um es zu unterdrücken und Ihre eigene auszuführen. ## Inline-CTA-Schaltflächen hinzufügen Eine Nachricht kann bis zu drei Inline-Call-to-Action-Schaltflächen enthalten. Schaltflächen befinden sich zusammen mit anderen benutzerdefinierten Daten in `data` als `buttons`-Array. Das SDK rendert sie automatisch in den Untertitel- und Klassik-Zellen: ```json title="POST https://api.pushwoosh.com/json/1.3/createMessage" { "request": { "application": "XXXXX-XXXXX", "auth": "API_TOKEN", "notifications": [{ "send_date": "now", "ios_title": "New promo card", "content": "Tap a button to claim or save", "inbox_image": "https://cdn.example.com/inbox/promo.png", "inbox_days": 7, "data": { "displayType": "captioned", "promo_id": "SUMMER2026", "buttons": [ { "title": "Claim", "url": "https://example.com/promo/SUMMER2026" }, { "title": "Read", "action": "markRead" }, { "title": "Save", "action": "custom", "tag": "save_promo" } ] }, "platforms": [1] }] } } ``` Jedes Schaltflächenobjekt hat diese Felder: | Feld | Typ | Wann | |---|---|---| | `title` | string | Erforderlich. Sichtbares Schaltflächen-Label. | | `url` | string | Eine nicht leere, parsable URL erzeugt eine `openURL`-Aktion. Das SDK öffnet sie über `UIApplication.shared.open`, es sei denn, Ihr Delegate unterdrückt dies. | | `action` | string | Explizites Aktions-Token: `dismiss` (entfernt die Nachricht aus dem Feed), `markRead` (markiert die Nachricht als gelesen) oder `custom` (vom Host behandelt). Groß-/Kleinschreibung wird nicht beachtet. | | Alles andere | any | Wenn `action` `custom` ist, wird jeder Schlüssel im Schaltflächenobjekt außer `title` und `action` als benutzerdefinierter Payload an Ihren Delegate weitergeleitet – einigen Sie sich mit dem Marketer auf einen Schlüssel (z. B. `tag`) und führen Sie eine Verzweigung darauf aus. | Auflösungspriorität: zuerst das explizite `action`-Token, dann `url`, wenn nicht leer, andernfalls fällt die Schaltfläche in `custom` und trägt den vollständigen Payload (ohne `title` und `action`). Fangen Sie Taps von Ihrem Delegate ab. Die `button.action`-Eigenschaft ist die typisierte `PushwooshInboxButtonAction`-Enum: ```swift extension MyInboxHost: PushwooshInboxKitDelegate { func inboxKit(_ vc: PushwooshInboxKitViewController, didTapButton button: PushwooshInboxButton, onMessage message: PWInboxMessageProtocol) -> Bool { switch button.action { case .openURL(let url): // Default behavior is fine — let SDK open the URL. return true case .dismiss, .markRead: // SDK handles both. Return false if you want to override. return true case .custom(let payload): // Marketer-defined custom button. Dispatch on a key you agreed on. if let tag = payload["tag"] as? String { switch tag { case "save_promo": saveCurrentPromoLocally(message: message) default: break } } return true // ignored for custom — SDK never runs a default action here } } } ```