Mobile Chat-SDKs

Wähle dein SDK

• iOS

  Swift-SDK mit Swift Package Manager und einem Xcode-Beispiel.

  iOS: Quellcode und InstallationiOS: Issues

• Android

  Kotlin-SDK mit einer Gradle-Beispiel-App.

  Android: Quellcode und InstallationAndroid: Issues

• React Native

  TypeScript-API und Beispiel-App auf Basis der Sonny-SDKs für iOS und Android.

  React Native: Quellcode und InstallationReact Native: Issues

Deine App verbinden

1. Öffne in einer Sonny-Umgebung mit aktivierter Mobile-Unterstützung Kanäle → Live-Chat → Mobile Apps. Ein Inhaber oder Admin erstellt für jede Plattform und jede Bundle- bzw. Application-ID einen App-Schlüssel.
2. Installiere das SDK gemäß der README im Repository. Konfiguriere es mit deiner Site-ID und dem öffentlichen App-Schlüssel für das jeweilige Build-Ziel. React Native braucht getrennte App-Schlüssel für iOS und Android.
3. Zeig den Chat als Vollbild-Unterhaltung an oder bette ihn in deine App ein. Halte immer nur eine Chat-Ansicht gleichzeitig aktiv.
4. Erstelle für angemeldete Kunden auf deinem Server ein Identitäts-JWT und übergib es an das SDK. Ruf beim Abmelden reset() auf, um eine neue Besuchersitzung zu starten.

App-Schlüssel sind öffentliche Kennungen. Signaturgeheimnisse für Identitäten und Schlüssel von Benachrichtigungsdiensten bleiben auf deinem Server oder in den geschützten Einstellungen von Sonny.

Push-Benachrichtigungen

Deine App kümmert sich um die Benachrichtigungsberechtigung und das Abrufen des Tokens. Das SDK nimmt unter iOS ein APNs-Token bzw. unter Android ein FCM-Token entgegen und verarbeitet Taps auf Sonny-Benachrichtigungen. Für die Zustellung brauchst du Zugangsdaten für deine eigene App: einen APNs-Signaturschlüssel samt Apple-Team- und Key-ID oder ein FCM-Dienstkonto für dein Firebase-Projekt. Die Zugangsdaten der Sonny-App für Agenten gehören zu einer separaten App. Die Push-Zustellung wird während dieser Preview noch geprüft.

1. Lade die Anbieter-Zugangsdaten deiner App unter Mobile Apps hoch. Wähle bei APNs die Sandbox- oder Produktionsumgebung passend zu deinem Build.
2. Öffne die App, erlaube Benachrichtigungen und übergib das Token an das SDK. Aktualisiere die Geräteliste in den Einstellungen und wähle dein Testgerät anhand seiner Registrierungszeit aus.
3. Schick die App in den Hintergrund und wähle Test-Push senden. Prüf, ob die Benachrichtigung auf dem Gerät ankommt. Der Status in den Einstellungen zeigt, ob der Anbieter sie angenommen hat, oder einen unbedenklichen Fehlercode; die Annahme allein bestätigt noch nicht die Zustellung.
4. Um Unterhaltungen zu testen, sende eine Agenten- oder KI-Antwort, während der Besucher nicht verbunden ist. Eine Antwort-Benachrichtigung öffnet diese Unterhaltung, wenn deine App den Tap an handlePush weiterreicht. Die allgemeine Testbenachrichtigung öffnet keine Unterhaltung.

Problem melden oder mitwirken

Eröffne ein Issue im Repository des SDKs, das du nutzt. Gib Version oder Commit, deine Betriebssystem- und Framework-Versionen sowie eine kleine Reproduktion an. Jedes Repository nimmt Pull Requests an und enthält Hinweise zum Mitwirken und zum Melden von Sicherheitslücken. Halte Kundendaten, Identitäts-JWTs, Geräte-Tokens und private Schlüssel aus öffentlichen Issues heraus.