Chat in deiner iOS- und Android-App: das Mobile SDK

Aktualisiert am 20.11.202613 Min. Lesezeit
Deutsch
Auf dieser Seite

Mit dem Mobile SDK von Deskwoot läuft dein Live-Chat in deiner eigenen iOS- und Android-App, als nativer Bildschirm und nicht als Webseite. Deine Kunden schreiben deinem Team und deinem KI-Bot direkt in der App, und dein Team antwortet wie gewohnt in Deskwoot. Ist die App geschlossen, kommen Antworten als Push-Benachrichtigung aufs Handy des Kunden. Dein Entwickler baut das SDK mit Hilfe der Entwicklerdokumentation in die App ein. Du erledigst in Deskwoot 2 Dinge, beide in deinem Live-Chat-Posteingang unter Chat in deiner iOS- und Android-App: Du kopierst den Widget-Token für deinen Entwickler, und du hinterlegst deinen Apple-Schlüssel und dein Firebase-Dienstkonto, damit Deskwoot die Push-Benachrichtigungen schicken kann.

Was deine Kunden in deiner App bekommen

Es ist derselbe Chat wie auf deiner Website. Die App liest dieselben Einstellungen des Posteingangs (deine Markenfarbe, deine Texte, dein Team, deinen KI-Bot und dein Hilfecenter) und zeigt das Design, das du für den Posteingang gewählt hast: Klartext, Empfang oder Direkt. Konversationen aus der App landen in diesem Posteingang, und dein Team beantwortet sie wie jeden anderen Chat.

  • Der Chat ist ein nativer Bildschirm deiner App auf iPhone, iPad und Android, keine Webseite. Nur der Text eines Hilfeartikels erscheint in einer Web View.
  • Deine Kunden schreiben deinem Team und deinem KI-Bot, durchsuchen dein Hilfecenter und lesen die Antworten, ohne die App zu verlassen. Sie können Fotos und Dateien schicken, und auch Fotos mit der Kamera, wenn deine App die Kamera erlaubt.
  • Der Chat spricht die 10 Besuchersprachen deines Website-Chats. Er nimmt die feste Sprache des Posteingangs, wenn du eine eingestellt hast, sonst die Sprache deiner App, sonst Englisch. Hell oder dunkel richtet er sich standardmäßig nach deiner App.
  • Kommt eine Antwort, während die App offen und der Chat geschlossen ist, gleitet unten in der App eine kleine Karte hoch: mit Bild und Namen der Person, die geschrieben hat, und 2 Zeilen der Antwort. Ein Tipp öffnet die Konversation. Dein Entwickler kann die Karte ausschalten.
  • Die App weiß, wie viele Antworten der Kunde noch nicht gelesen hat, zum Beispiel für eine Zahl an deinem Hilfe-Button. Sie kann auch den runden Chat-Button deiner Website über der App zeigen, aber der bleibt ausgeblendet, bis dein Entwickler ihn einschaltet.
  • Ist die App geschlossen, kommen Antworten als Push-Benachrichtigung, sobald du sie eingerichtet hast (Schritt 2 unten).

Deine App bestimmt, wo der Chat aufgeht: auf seiner Startseite, in der neuesten Konversation des Kunden, in einer neuen Konversation mit einem Text deiner Wahl, der schon im Eingabefeld steht (der Kunde kann ihn ändern und schickt ihn selbst ab), oder direkt im Hilfecenter. Die meisten Apps öffnen ihn über ihren eigenen Hilfe-Button.

Was du brauchst

  • Einen Live-Chat-Posteingang in Deskwoot. Die App nutzt seinen Widget-Token. Mit dem Token des Posteingangs auf deiner Website landen Chats aus der App und von der Website im selben Posteingang. Willst du sie trennen, leg für die App einen zweiten Live-Chat-Posteingang an.
  • Deine eigene App für iPhone und iPad (iOS 15 oder neuer), für Android (Android 5.0 oder neuer) oder für beides. Das SDK ist nativ: Swift auf iOS, Kotlin oder Java auf Android. Android-Apps mit Views und mit Jetpack Compose funktionieren beide. Ein Paket für React Native oder Flutter gibt es nicht (siehe die Fragen unten).
  • Einen Entwickler, der das SDK in deine App einbaut. Alles, was er dafür braucht, steht in der Entwicklerdokumentation.
  • Für Push-Benachrichtigungen auf dem iPhone: ein Apple-Developer-Konto, in dem du Schlüssel erstellen darfst. Apple erlaubt das dem Account Holder und Admins.
  • Für Push-Benachrichtigungen auf Android: Zugang zum Firebase-Projekt deiner Android-App. Die App braucht Firebase Cloud Messaging.
  • In Deskwoot das Recht, Posteingänge zu verwalten. Administratoren haben es, und Agenten, deren benutzerdefinierte Rolle Posteingänge verwalten enthält.

Das geht in jedem Deskwoot-Tarif. Deskwoot prüft für das SDK und für Push-Benachrichtigungen keinen Tarif, und jeder Tarif enthält Live-Chat-Posteingänge.

Schritt 1: Gib deinem Entwickler den Widget-Token

  1. Geh zu Einstellungen > Posteingänge und öffne den Live-Chat-Posteingang, den die App nutzen soll.
  2. Klicke unter Einbau und Datenschutz auf Chat in deiner iOS- und Android-App.
  3. Klicke oben unter Widget-Token auf Kopieren und schick den Token an deinen Entwickler. Die App gibt ihn beim Start mit einem einzigen Aufruf an Deskwoot weiter, Deskwoot.setup.
  4. Ganz unten im Bereich öffnet So baust du das SDK in deine App ein die Entwicklerdokumentation. Schick deinem Entwickler auch diesen Link: deskwoot.com/de/docs/mobile.

Mehr braucht der Chat selbst nicht: Er funktioniert in der App auch ohne Push-Benachrichtigungen. Push-Benachrichtigungen (Schritt 2) bringen dazu die Antworten, die kommen, während die App geschlossen ist.

Schritt 2: Richte die Push-Benachrichtigungen ein

Für Push-Benachrichtigungen braucht es beide Seiten. Dein Entwickler bereitet die App vor, wie es die Entwicklerdokumentation unter Push-Benachrichtigungen beschreibt. Du hinterlegst die Zugangsdaten, mit denen Deskwoot sendet: einen APNs-Schlüssel von Apple für iPhones und ein Dienstkonto aus Firebase für Android-Handys. Der Server von Deskwoot schickt dann jeden Push über deine eigenen Konten bei Apple und Google. Das SDK in der App spricht selbst nie mit Apple oder Google.

Du kannst iOS, Android oder beides einrichten. Jeder Block im Bereich hat seinen eigenen Button Speichern. Klickst du darauf, fragt Deskwoot zuerst bei Apple oder Google nach, ob sie deine Angaben annehmen, und speichert sie nur dann. Lehnen sie ab, steht unter dem Block, was nicht stimmt, und nichts wird gespeichert. Antworten Apple oder Google nicht, versuch es gleich noch einmal.

Push-Benachrichtigungen auf dem iPhone: dein APNs-Schlüssel

Du brauchst 4 Angaben aus deinem Apple-Developer-Konto:

  • Den APNs-Schlüssel, eine Datei mit der Endung .p8. Geh in deinem Apple-Developer-Konto zu Certificates, Identifiers & Profiles, klicke auf Keys und erstelle einen Schlüssel, bei dem der Apple Push Notification service eingeschaltet ist. Lade die Datei herunter und bewahre sie gut auf: Apple lässt dich sie nur ein einziges Mal herunterladen.
  • Die Schlüssel-ID. Apple zeigt sie unter dem Namen des Schlüssels, wenn du ihn unter Keys auswählst. Sie hat 10 Buchstaben und Ziffern.
  • Deine Team-ID. Sie steht in deinem Apple-Developer-Konto unter Membership details, ebenfalls 10 Buchstaben und Ziffern.
  • Die Bundle-ID deiner App, zum Beispiel com.example.app. Dein Entwickler kennt sie aus Xcode, und Apple führt sie unter Certificates, Identifiers & Profiles, Identifiers.

Apple kann einen Schlüssel auf eine Umgebung beschränken, Sandbox oder Production. Apps aus dem App Store und aus TestFlight laufen in Production, Entwicklungs-Builds in der Sandbox. Wenn du den Schlüssel speicherst, fragt Deskwoot bei Apple nach, für welche Umgebungen er gilt, und ist es nur eine, sagt dir das eine Zeile im iOS-Block. Bei einem Schlüssel nur für die Sandbox ist die Zeile eine Warnung: iPhones mit deiner App aus dem App Store oder aus TestFlight bekommen keine Push-Benachrichtigungen, also erstelle zusätzlich einen Schlüssel für Production und speichere ihn. Bei einem Schlüssel nur für Production ist sie nur ein Hinweis: Entwicklungs-Builds deiner App bekommen keine Push-Benachrichtigungen. Der Block zeigt in beiden Fällen Verbunden, denn Apple hat den Schlüssel angenommen. Achte also darauf, dass dein Schlüssel für Production gilt, denn dort läuft die App deiner Kunden.

Dann in Deskwoot:

  1. Geh in Chat in deiner iOS- und Android-App zum Block iOS.
  2. Füge den Inhalt der .p8-Datei in APNs-Schlüssel (.p8) ein, oder klicke auf .p8-Datei hochladen und wähle die Datei aus.
  3. Trag die Schlüssel-ID, die Team-ID und die Bundle-ID ein.
  4. Klicke auf Speichern.

Apple prüft den Schlüssel, die Schlüssel-ID und die Team-ID zusammen. Alle 3 müssen also zum selben Schlüssel gehören, und die Bundle-ID muss zu deinem Team gehören. Nimmt Apple sie an, zeigt der Block Verbunden und darunter Schlüssel-ID, Team-ID und Bundle-ID. Push-Benachrichtigungen bekommen nur iPhones mit der App dieser Bundle-ID.

Push-Benachrichtigungen auf Android: dein Firebase-Dienstkonto

Push-Benachrichtigungen an Android-Handys laufen über Firebase Cloud Messaging, mit einem Dienstkonto aus dem Firebase-Projekt, das deine Android-App nutzt.

  1. Öffne in Firebase das Projekt deiner App, dann die Projekteinstellungen, dann Dienstkonten, und erzeuge einen neuen privaten Schlüssel. Firebase gibt dir eine JSON-Datei.
  2. Geh in Deskwoot in Chat in deiner iOS- und Android-App zum Block Android.
  3. Füge den Inhalt der Datei in JSON des Dienstkontos ein, oder klicke auf .json-Datei hochladen und wähle die Datei aus.
  4. Klicke auf Speichern.

Google prüft, ob dieses Dienstkonto in seinem Projekt Nachrichten senden darf. Dafür muss sein Schlüssel gültig sein, es braucht eine Rolle, die Nachrichten senden darf, und die Firebase Cloud Messaging API muss im Projekt aktiviert sein. Nimmt Google es an, zeigt der Block Verbunden und darunter das Projekt und die E-Mail-Adresse des Dienstkontos. Ob die Android-Handys wirklich zu diesem Projekt gehören, zeigt erst der erste echte Push (siehe den nächsten Abschnitt).

Was der Status bedeutet

In der Übersicht des Posteingangs zeigt die Zeile Chat in deiner iOS- und Android-App eins davon:

  • Nicht eingerichtet: Es sind keine Zugangsdaten für Push gespeichert. Der Chat in deiner App funktioniert trotzdem, nur ohne Push-Benachrichtigungen.
  • Push-Benachrichtigungen für iOS, Push-Benachrichtigungen für Android oder Push-Benachrichtigungen für iOS und Android: die Plattformen, deren Zugangsdaten gespeichert sind.
  • Sendet nicht: Apple oder Google hat die Pushes abgelehnt, die Deskwoot mit deinen gespeicherten Zugangsdaten schicken wollte.

Im Bereich zeigt jeder Block seinen eigenen Status: Verbunden, Nicht eingerichtet oder Sendet nicht. Bei Sendet nicht steht im Block, warum:

  • Apple lehnt den Schlüssel, die Schlüssel-ID oder die Team-ID ab. Speichere die richtigen.
  • Apple lehnt die Bundle-ID ab. Speichere die Bundle-ID deiner App.
  • Google sendet mit diesem Dienstkonto nicht. Prüfe, ob sein Schlüssel noch existiert, ob es eine Rolle hat, die Nachrichten senden darf, und ob die Firebase Cloud Messaging API in seinem Projekt aktiviert ist.
  • Die Android-Handys gehören zu einem anderen Firebase-Projekt als das Dienstkonto. Lade das Dienstkonto aus dem Firebase-Projekt deiner App hoch.

Sendet nicht bleibt, bis wieder ein Push durchgeht oder du neue Zugangsdaten speicherst. Der Block iOS kann außerdem zeigen, dass iPhones eine andere Bundle-ID als die gespeicherte nutzen, und wie viele. Diese iPhones bekommen keine Push-Benachrichtigungen, prüf also, ob die gespeicherte Bundle-ID die deiner App ist.

Gespeicherte Schlüssel ersetzen oder entfernen

Nach dem Speichern ist das Feld für den Schlüssel oder das JSON wieder leer, mit dem Hinweis, dass einer gespeichert ist. Deskwoot speichert Schlüssel und JSON verschlüsselt und zeigt sie nie wieder an, weder auf dieser Seite noch über die API. Sichtbar bleiben Schlüssel-ID, Team-ID und Bundle-ID und für Android das Firebase-Projekt und die E-Mail-Adresse des Dienstkontos.

  • Um den Schlüssel oder das Dienstkonto zu ersetzen, füge den neuen ein oder lade ihn hoch und klicke auf Speichern. Deskwoot prüft ihn wieder bei Apple oder Google.
  • Um nur Schlüssel-ID, Team-ID oder Bundle-ID zu ändern, bearbeite das Feld und klicke auf Speichern. Der gespeicherte Schlüssel bleibt, du musst ihn also nicht noch einmal hochladen.
  • Um einen Block zu entfernen, klicke auf Entfernen und bestätige mit Entfernen. Ab dann bekommen iPhones (oder Android-Handys) keine Push-Benachrichtigungen mehr, bis du neue Zugangsdaten hinterlegst. Der Chat in deiner App funktioniert weiter.

Wann eine Push-Benachrichtigung rausgeht

Deskwoot schickt einen Push für jede Antwort, die der Kunde im Chat sieht: eine Antwort aus deinem Team, eine Antwort deines KI-Bots oder eine automatische Nachricht. Nie für die eigenen Nachrichten des Kunden, nie für private Notizen und nicht, solange der KI-Bot noch an seiner Antwort tippt. Als Spam markierte Konversationen und blockierte Kontakte bekommen keinen.

  • War der Kunde kurz vorher nicht online, geht der Push sofort raus.
  • War er kurz vorher online, wartet Deskwoot 12 Sekunden. Hat er die Antwort bis dahin gelesen, geht kein Push raus. Wer gerade in die Konversation schaut, wird also nicht gestört.
  • Jede Antwort meldet sich nur einmal. Sie geht an jedes Handy, auf dem der Kunde deine App mit diesem Posteingang nutzt, höchstens an 10 Handys.
  • Ist das Handy aus oder offline, heben Apple und Google den Push einen Tag lang auf und verwerfen ihn dann.

Der Titel der Benachrichtigung nennt, wer geschrieben hat: den Vornamen der Person aus deinem Team oder den Namen deines KI-Bots, sonst den Namen deines Unternehmens. Der Text zeigt die Antwort als reinen Text, bis zu 160 Zeichen. Bei einer Antwort, die nur eine Datei enthält, steht dort in der Sprache des Handys, dass eine Datei gesendet wurde (auf einem deutschen Handy „Datei gesendet“). Ein Tipp auf die Benachrichtigung öffnet die Konversation in deiner App.

Eingeloggte Kunden in deiner App

Ohne weitere Einrichtung chattet ein Kunde in der App als anonymer Besucher, und die Konversation bleibt auf diesem Handy. Loggen sich deine Kunden in deine App ein, kann die App dem Chat sagen, wer sie sind. Dann folgen ihnen ihre Konversationen auf jedes Gerät und in deinen Website-Chat desselben Posteingangs, und dein Team sieht, wer schreibt.

Das funktioniert genau wie die Nutzer-Verifizierung auf deiner Website, mit demselben geheimen Schlüssel, den du im selben Live-Chat-Posteingang unter Eingeloggte Kunden erkennen erstellst. Dein Server signiert die Nutzer-ID des Kunden mit diesem Schlüssel, und nach deinem eigenen Login gibt die App den Nutzer und die Signatur an das SDK weiter. Wie du den Schlüssel erstellst und die Nutzer-ID signierst, steht in Nutzer-Verifizierung für eingeloggte Kunden. Den Aufruf in der App beschreibt die Entwicklerdokumentation.

Der Schlüssel gehört nur auf deinen Server. Bau ihn nie in die App ein: Wer die App entpackt, könnte ihn lesen und als jeder deiner Kunden chatten.

Loggt sich ein Kunde aus deiner App aus, sagt die App das dem SDK. Das SDK löscht dann, was es auf dem Handy über diesen Kunden gespeichert hat, das Handy bekommt keine Push-Benachrichtigungen mehr für ihn, und der nächste Chat beginnt mit einem neuen, anonymen Besucher. Seine Konversationen bleiben in Deskwoot und kommen zurück, wenn er sich wieder einloggt.

Häufige Fragen

Kostet das extra, und welchen Tarif brauche ich?

Das SDK und die Push-Benachrichtigungen haben keinen eigenen Preis, und Deskwoot prüft dafür keinen Tarif. Jeder Tarif enthält Live-Chat-Posteingänge, es geht also mit jedem Tarif. Für Push-Benachrichtigungen nutzt du dein eigenes Apple-Developer-Konto und dein eigenes Firebase-Projekt.

Gibt es ein SDK für React Native oder Flutter?

Nein. Deskwoot hat native SDKs für iOS (Swift) und für Android (Kotlin und Java) und kein Paket für React Native oder Flutter. In einer App, die damit gebaut ist, kannst du deinen Website-Chat mit dem Embedded-Modus des Widgets in einer Web View zeigen. Wie das geht, steht in Embedded-Modus: der Chat im Container oder im Vollbild.

Brauche ich Firebase auf iOS?

Nein. Deskwoot schickt Push-Benachrichtigungen für iPhones mit deinem APNs-Schlüssel direkt an Apple, und das SDK bringt kein Firebase mit. Firebase brauchst du nur für Android.

Wer schickt die Push-Benachrichtigungen, Deskwoot oder wir?

Der Server von Deskwoot schickt sie, mit deinem APNs-Schlüssel und deinem Firebase-Dienstkonto, also über deine eigenen Konten bei Apple und Google. Deine App gibt beim Start nur ihren Push-Token an das SDK. Deine eigenen Push-Benachrichtigungen bleiben deine: Das SDK nimmt nur die von Deskwoot und überlässt alle anderen deiner App.

Fragt das SDK meine Kunden nach Berechtigungen?

Nach der Erlaubnis für Benachrichtigungen fragt es nie. Das macht deine App, wenn es passt, so wie bei ihren eigenen Benachrichtigungen. Auf Android 13 und neuer erscheint ohne diese Erlaubnis keine Benachrichtigung. Sonst braucht das SDK auf dem iPhone keine Berechtigung und auf Android nur den Internetzugriff. Fotos und Dateien können deine Kunden ohne Berechtigung schicken. Die Kamera geht nur, wenn deine App sie erlaubt. Auch die Karte, die eine Antwort bei offener App zeigt, braucht keine Berechtigung.

Was sieht der Kunde, wenn die App geschlossen ist?

Eine Push-Benachrichtigung mit dem Namen der Person, die geschrieben hat, und bis zu 160 Zeichen der Antwort. Ein Tipp öffnet die Konversation in deiner App. Ist die App offen und der Chat geschlossen, zeigt stattdessen eine kleine Karte unten in der App die Antwort. Solange der Kunde in diese Konversation schaut, erscheint keine Benachrichtigung.

War diese Anleitung hilfreich?

Weiterlesen

Fynn zu dieser Anleitung fragen

Kurze Antwort aus dieser Anleitung und dem restlichen Hilfecenter.

Noch Hilfe nötig?

Fynn antwortet im Chat aus diesen Anleitungen, und dort erreichst du auch das Team.