Installieren Sie Intercom in Ihrer iOS- oder Android-App, um zu sehen, wer Ihre users sind, und verbinden Sie sich mit ihnen an jedem Touchpoint:
Binden Sie sie mit automatisierten Push-Nachrichten ein.
Unterstützen Sie sie mit einem integrierten AI Agent, Help Center und dem Intercom Messenger.
Gehen Sie proaktiv auf users zu und verkaufen Sie mit ausgehenden Workflows mehr.
Onboarden und pflegen Sie sie mit Mobile Carousels.
Alles, ohne dass sie Ihre App jemals verlassen.
Intercom in Ihrer mobilen App installieren und konfigurieren
Die Installation von Intercom in Ihrer mobilen App dauert nur wenige Minuten mit unseren nativen SDKs für iOS, Android, React Native und Cordova.
Bei der Installation von Intercom in Ihrer mobilen App sollten Sie die benutzerdefinierten Daten konfigurieren, die Sie über Ihre users verfolgen möchten. So können Sie gezieltere und personalisierte Nachrichten und Carousels senden.
Sie oder Ihr Entwickler finden Anweisungen dazu in unserer Entwicklerdokumentation:
Die SDKs sind auch klein, sodass sie Ihre App nicht verlangsamen. 👌
Plattform-Auswahl
Auf der Seite Channels > Messenger > Install werden Sie gefragt, ob Sie den Messenger in einer Web- oder einer mobilen Umgebung installieren möchten.
Die Auswahl von Für Web installieren zeigt den Installationsablauf für Websites, die Auswahl von Für mobile installieren zeigt den neuen Installationsablauf für mobile Apps. 👇
Der Status für mobile zeigt „Nicht installiert“ an, wenn weder Android noch iOS installiert sind, oder „Sicher installiert“, wenn beide installiert wurden.
Es gibt drei Schritte, die Sie abschließen müssen, um den Messenger in Ihren mobilen Apps zu installieren.
Erste Messenger-Installation
Wählen Sie Ihre bevorzugte Installationsplattform: iOS, Android oder React Native. Alle gewählten Plattformen haben plattformspezifische Schritte.
Sie erhalten Optionen, wie Sie Intercom in Ihre mobilen Apps installieren können, sowie einige Code-Snippets zur Unterstützung bei der Installation. Die für iOS bereitgestellten Code-Snippet-Optionen sind:
Swift Package Manager
Cocoapods
Manuelle Installation
Die für Android bereitgestellten Code-Snippet-Optionen sind:
Groovy
Kotlin
Hinweis: Der Schalter „Benutzerverkehr für Messenger aktivieren“ ist für die mobile Installation des Messengers erforderlich.
Die für React Native bereitgestellten Code-Snippet-Optionen sind:
Yarn
NPM
Expo
Der nächste Schritt ist die „Initialisierung von Intercom“ im Code Ihrer mobilen App. In diesem Schritt können Sie auch Ihre API-Schlüssel verwalten. Die für iOS bereitgestellten Code-Snippet-Optionen sind:
Swift
Swift UI
ObjectiveC
Die für Android bereitgestellten Code-Snippet-Optionen sind:
Kotlin
Java
Die Optionen für React Native sind:
iOS
Android
Die Schaltfläche Installation prüfen am Ende zeigt eine Erfolgsmeldung an, wenn der Messenger für Ihre gewählte Installation erfolgreich gefunden wurde, oder zeigt an, ob etwas schiefgelaufen ist.
Hinweis: Wenn Sie Ihre mobile App mit der Messenger API verbinden, stellen Sie sicher, dass der Endpunkt mit der Datenhosting-Region Ihres Workspaces übereinstimmt. Workspaces, die in den USA gehostet werden, sollten den Standard-API-Endpunkt (ohne ‚eu‘ in der URL) verwenden, während EU-gehostete Workspaces den EU-Endpunkt verwenden sollten. Die Verwendung des falschen Endpunkts führt zu 404-Fehlern.
Sichern Ihres Messengers mit JWTs
Wir haben kürzlich unser Messenger-Sicherheitsangebot verbessert, um JSON-Web-Tokens anstelle von HMACs zu verwenden. Dieses Update ersetzt die vorherige Identity Verification (IdV)-Methode durch Funktionen, die den Schutz von Benutzerdaten verbessern.
Mit JWTs profitieren Sie von:
✅ Datenschutz — Signieren und schützen Sie sowohl Benutzer-ID als auch E-Mail sowie alle anderen Benutzerattribute.
✅ Kurzlebige Tokens — JWTs können so eingestellt werden, dass sie ablaufen, wodurch das Risiko einer missbräuchlichen Verwendung kompromittierter Tokens verringert wird.
Um Ihren Messenger mit JWTs zu sichern, wählen Sie hier iOS oder Android aus und folgen Sie den Anweisungen.
Hinweis: Für React Native müssen Sie weiterhin Identity Verification verwenden, da die JWT-Unterstützung hier noch nicht verfügbar ist.
Sichern Ihres Messengers mit Identity Verification [Veraltet]
Identity Verification auf Mobilgeräten: Gehen Sie zu Einstellungen > Installation > Für mobile installieren und wählen Sie die Installationsplattform: iOS, Android oder React Native.
Ähnlich wie beim ersten Installationsschritt werden Sie aufgefordert, die Plattform auszuwählen, mit der Sie das React Native SDK installieren möchten (iOS oder Android).
Code-Snippets und Anweisungen werden bereitgestellt, wie Sie einen HMAC-Code (Hash-based Message Authentication Code) in Ihrem Backend-Code generieren und dem Intercom Messenger bereitstellen. Dieser HMAC-Code wird von Intercom verwendet, um die Authentizität von Benutzerinteraktionen im Messenger zu überprüfen.
Ein zusätzliches Code-Snippet wird bereitgestellt, damit Sie den HMAC beim Initialisieren von Intercom in Ihrer mobilen App einbinden können. Die für iOS bereitgestellten Code-Snippet-Optionen sind:
Swift
Swift UI
ObjectiveC
Die für Android bereitgestellten Code-Snippet-Optionen sind:
Kotlin
Java
Für React Native bieten wir ein Beispiel-Code-Snippet, wie Sie den HMAC-Code zur Initialisierung von Intercom mit Identity Verification verwenden können.
Der letzte Schritt im Identity Verification-Prozess besteht darin, die Identitätsprüfung durchzusetzen. Sobald dies erledigt ist, werden alle Anfragen vom Messenger, die den gültigen HMAC-Code nicht enthalten, abgelehnt.
Hinweis: Wenn Sie die Identitätsprüfung für eine iOS- oder Android-App durchsetzen, wird der zweite Schritt als abgeschlossen markiert.
⚠️ Beenden Sie Ihre Benutzersitzungen beim Logout
Stellen Sie sicher, dass Sie Intercom herunterfahren, um die Gespräche Ihrer Kunden zu löschen, wenn sie sich aus Ihrer App ausloggen.
So machen Sie es in Objective C
- (void)logout { [Intercom logout]; }So machen Sie es in Java
private void logout() {
Intercom.client().logout();
}Hinweis: Sie sollten sich nur als identifizierter Benutzer abmelden. Das Abmelden eines nicht identifizierten Benutzers führt zu verwaisten Datensätzen, die in Zukunft nicht zusammengeführt werden können.
Intercom erkennt, wenn Ihre App in den Hintergrund wechselt und wieder aktiv wird, sodass Sie Ihre users nicht erneut anmelden müssen.
Optional: Push-Benachrichtigungen einrichten
In diesem Schritt haben Sie erneut die Wahl der Installationsplattform: iOS oder Android. Sie können Push-Benachrichtigungen in diesem Abschnitt konfigurieren, aber es wird Sie nicht durch den Prozess führen. Stattdessen sollten Sie unsere Entwicklerdokumentation für die Einrichtung von Push-Benachrichtigungen verwenden:
Hinweis: React Native wird nicht als Option für mobile Push-Benachrichtigungen angeboten.
Hinweis: Dieser optionale Schritt wird als abgeschlossen markiert, wenn Push-Benachrichtigungen für eine iOS- oder Android-App erkannt wurden.
Wichtig: Xcode 14 ist jetzt erforderlich, um Intercom iOS SDK v13.0.0+ zu bauen.
In Xcode 14 werden beim Installieren des SDK mehrere Warnungen in der Konsole protokolliert. Die Warnungen stammen von der Verwendung von WKWebView durch Intercom. Es gibt einen bug in Xcode 14, der diese Warnungen auslöst, und es ist kein Problem, das Intercom beheben kann.
Es sind nur Warnungen, und Intercom funktioniert weiterhin normal, wenn sie vorhanden sind.
Hier sind die Warnmeldungen:
WKWebView-Fehler - Artikel anzeigen und Sie sehen dies in der Konsole: Fehler beim Abrufen der Assertion: <Error Domain=RBSServiceErrorDomain Code=1 "Ziel läuft nicht oder hat keine Berechtigung com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=Ziel läuft nicht oder hat keine Berechtigung com.apple.runningboard.assertions.webkit}>Diese Methode sollte nicht im Hauptthread aufgerufen werden, da dies zu UI-Unresponsiveness führen kann.[Sandbox] Konnte Mach-Bootstrap nicht aktivieren, errno = 22.
Integrieren Sie Ihr Help Center tief in Ihre mobile App
Das direkte Einbinden Ihres Articles Help Center in Ihre mobile App bietet Ihnen viele flexible Möglichkeiten, Hilfsinhalte Ihren users zu präsentieren. Egal, ob Sie die vorgefertigte UI von Intercom verwenden oder Ihre eigene benutzerdefinierte Präsentation entwickeln, Sie können Ihren Kunden genau die Unterstützung bieten, die sie benötigen.
Die Gespräche Ihrer users sicher halten
Wir empfehlen dringend, die Messenger-Sicherheit in Ihrer iOS- und/oder Android-App zu aktivieren. Dies hilft sicherzustellen, dass Gespräche zwischen Ihnen und Ihren users privat bleiben und dass sich ein user nicht als ein anderer ausgeben kann.
Für detaillierte Anweisungen zur Einrichtung siehe unsere Help Center-Dokumentation oder Ihre Sicherheitseinstellungen. Für mobile Anweisungen siehe unsere Entwicklerdokumentation für iOS und Android.