Verwenden Sie diesen Artikel, um den Intercom Messenger in Ihrer mobilen App zu installieren, Ihre angemeldeten users sicher zu authentifizieren und zu bestätigen, dass alles funktioniert, bevor Sie live gehen.
Die Schritte für eine vollständige und sichere Messenger-Installation sind:
Wählen Sie Ihren Installationstyp.
Installieren und initialisieren Sie das SDK.
Authentifizieren Sie angemeldete users.
Testen Sie Ihre Installation.
Hinweis:
Dies ist die neue Messenger-Installationserfahrung, die schrittweise eingeführt wird. Wenn Ihr Workspace noch nicht umgestellt wurde, verwenden Sie stattdessen Install and use Intercom in your mobile app.
Sie benötigen einen Vertrags- oder Monatsplan, um den Messenger zu installieren, sowie Zugriff auf den Code Ihrer App (oder einen Entwickler, der dies hat). Der Messenger unterstützt iOS, Android und React Native.
Wählen Sie Ihren Installationstyp
Gehen Sie zu Einstellungen > Channels > Messenger Live Chat > Übersicht , suchen Sie die Karte Mobile app und wählen Sie Auf mobiler App installieren.
Wählen Sie Ihren Installationstyp aus
Sie werden gefragt „Welche Informationen benötigt Ihr Team in Ihrem inbox?“ und sehen zwei Optionen:
Nicht angemeldete users (am schnellsten zu installieren) – Gespräche sind nicht mit user-Details verknüpft. Sie können die zusätzliche Einrichtung später abschließen, um angemeldete users zu identifizieren.
Angemeldete users und nicht angemeldete users – Gespräche von angemeldeten users enthalten relevante Details, die Ihrem Team den Kontext geben, um personalisierten Support zu bieten. Erfordert Änderungen an App und Backend.
Wählen Sie die Option, die zu Ihrem Unternehmen passt, und klicken Sie dann auf Weiter, um mit den Installationsschritten unten fortzufahren.
Installieren und initialisieren Sie das SDK
Dieser Abschnitt behandelt die Schritte 1–3 der Installation. Es dauert nur wenige Minuten und gilt unabhängig davon, ob Sie angemeldete users identifizieren oder nicht.
1. Wählen Sie Ihre Plattform
Verwenden Sie das Dropdown Mobile app platform, um die Plattform auszuwählen, auf der Sie installieren: iOS, Android oder React Native. Die folgenden Schritte verwenden iOS als Beispiel – der Ablauf ist für andere Plattformen gleich, mit plattformspezifischem Code.
2. Fügen Sie die SDK-Abhängigkeit hinzu
Wählen Sie Ihre Installationsmethode aus dem Dropdown (für iOS umfasst dies Swift Package Manager und CocoaPods). Für Swift Package Manager:
Navigieren Sie in Xcode zu Datei > Pakete hinzufügen.
Geben Sie bei Aufforderung die Repository-URL des Intercom iOS SDK (Software Development Kit) ein:
.package(url: "https://github.com/intercom/intercom-ios", from: "18.0.0")
Wählen Sie die Version von Intercom, die Sie verwenden möchten. Wir empfehlen die neueste Version.
Klicken Sie auf Package hinzufügen und Intercom wird automatisch als Abhängigkeit für Ihr Projekt heruntergeladen.
3. Initialisieren Sie Intercom
Sie sehen in diesem Schritt Ihren plattformspezifischen API-Schlüssel (Application Programming Interface Key) – zum Beispiel Ihren iOS API Key. Klicken Sie auf Code kopieren, um ihn zu übernehmen, oder auf API-Schlüssel neu generieren, wenn Sie einen neuen benötigen.
Rufen Sie Folgendes in Ihrer Application Delegate-Methode auf:
import UIKit
import Intercom
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Intercom.setApiKey("YOUR_IOS_API_KEY", forAppId: "YOUR_APP_ID")
Intercom.setLauncherVisible(true)
// If you have identifying information for your user you can use
// `Intercom.loginUser(with:completion:)`
Intercom.loginUnidentifiedUser()
return true
}
}Authentifizieren Sie angemeldete users
Dieser Abschnitt behandelt die Schritte 4–7 und erfordert Änderungen sowohl an Ihrer mobilen App als auch an Ihrem Backend.
4. Wählen Sie Ihre Backend-Sprache
Verwenden Sie das Dropdown, um die Sprache auszuwählen, in der Ihr Backend geschrieben ist (zum Beispiel Node).
Tipp: Für diesen Schritt wird jemand benötigt, der serverseitig Tokens generiert. Wenn das nicht Sie sind, klicken Sie auf Entwickler einladen, um einen Teamkollegen hinzuzuziehen, der dies mit Ihnen abschließt.
5. Generieren Sie ein Token für jeden Kunden
Generieren Sie auf Ihrem Server für jeden angemeldeten user ein signiertes JSON Web Token (JWT):
const jwt = require('jsonwebtoken');
const token = jwt.sign(
{ user_id: user.id, email: user.email },
process.env.INTERCOM_SECRET_KEY,
{ algorithm: 'HS256', expiresIn: '1h' },
);
Sie benötigen dafür den geheimen Schlüssel Ihres Workspaces – dieser wird in diesem Schritt (maskiert) angezeigt. Bewahren Sie diesen Schlüssel auf Ihrem Server auf. Schließen Sie ihn niemals in Browser- oder App-Code ein.
Hinweis: Schlüssel sind plattformbezogen, und Ihr Workspace kann mehr als einen haben. Sie können einen Schlüssel in Ihren Messenger-Sicherheitseinstellungen erstellen, rotieren oder decodieren.
6. Konfigurieren Sie das JWT in Ihrer mobilen App
Übergeben Sie das von Ihrem Server generierte Token in Ihren bestehenden Intercom-Initialisierungsaufruf zusammen mit Ihrer app_id:
Intercom({
app_id: 'your_app_id',
intercom_user_jwt: user.jwt,
});
7. Identifizieren Sie users
Sobald das JWT eingebunden ist, identifizieren Sie den angemeldeten user mit:
Intercom.loginUser(
ICPRegistrationOptions.create(userJwt: user.jwt)
) { result in }Wichtig: Ältere App-Versionen senden keine signierten Tokens. Wenn Ihre App bereits live ist, werden Kundendaten erst verbunden, wenn Ihre users die App aktualisieren. Wir empfehlen ein erzwungenes Update, damit alle eine Version verwenden, die das JWT sendet.
Testen Sie Ihre Installation
Nachdem Sie die obigen Schritte abgeschlossen haben, klicken Sie auf Testen Sie Ihre Installation. Dies bestätigt, dass der Messenger und (falls zutreffend) Ihre JWT-Konfiguration vor dem Versand an Ihre users korrekt funktionieren.
Wenn etwas nicht funktioniert, überprüfen Sie:
Die app_id in Ihrem Init-Aufruf stimmt mit Ihrem Workspace überein.
Ihr geheimer Schlüssel wurde seit der Generierung Ihres letzten Tokens nicht rotiert oder widerrufen.
Die user_id, die Sie an das SDK übergeben, stimmt mit der im JWT-Payload codierten überein.
Wenn alles überprüft ist, sind Sie live. Sie können den Installationsstatus jederzeit unter Einstellungen > Channels > Messenger Live Chat > Übersicht unter Installationsorte prüfen.
Hinweis: Die Sitzungsdauer ist konfigurierbar unter Einstellungen > Channels > Messenger Live Chat > Sicherheit unter Sitzungsdauer. Kunden werden aufgefordert, sich nach Ablauf dieser Zeit erneut zu authentifizieren.
💡 Tipp: Brauchen Sie mehr Hilfe? Holen Sie sich Unterstützung in unserem Community Forum. Finden Sie Antworten und erhalten Sie Hilfe von Intercom Support und Community-Experten.