Zendesk Mobile SDK iOS Integration: Eine vollständige Anleitung für 2026

Wenn Ihre Kunden Hilfe benötigen, möchten sie Ihre App am wenigsten verlassen. Sie dazu zu bringen, einen Browser zu öffnen, nach Ihrer Support-Seite zu suchen oder E-Mails nach Ticket-Updates zu durchsuchen, erzeugt Reibungsverluste, die das Kundenerlebnis beeinträchtigen. Aus diesem Grund ist das Einbetten von Support direkt in Ihre iOS-App mit dem Zendesk Mobile SDK für modernen Kundenservice unerlässlich geworden.

Diese Anleitung führt Sie Schritt für Schritt durch die Integration des Zendesk iOS SDK. Egal, ob Sie eine neue App erstellen oder einer bestehenden App Support hinzufügen, Sie lernen die genauen Schritte, um Kunden-Messaging in Ihrer Anwendung zum Laufen zu bringen. Für Teams, die ihren mobilen Support um KI-gestützte Antworten erweitern möchten, behandeln wir auch, wie eesel AI zusammen mit dem Zendesk Mobile SDK funktioniert.

Was Sie benötigen

Bevor Sie beginnen, benötigen Sie Folgendes:

• Einen Zendesk Support- oder Suite-Plan
• Xcode 11.4 oder höher
• Eine iOS-App, die auf iOS 14 oder höher ausgerichtet ist
• Administratorzugriff auf Ihr Zendesk-Konto, um Kanalschlüssel abzurufen
• Swift 5.2.2+ oder Objective-C Projekt

Das SDK unterstützt sowohl Swift als auch Objective-C, sodass Sie es unabhängig davon integrieren können, welche Sprache Ihre App verwendet. Swift Package Manager funktioniert am besten für moderne Projekte, aber CocoaPods und Carthage bleiben verfügbar, wenn Ihr Projekt bereits von ihnen abhängt.

Schritt 1: Wählen Sie das richtige Zendesk SDK für Ihre Bedürfnisse

Viele Entwickler erkennen nicht, dass Zendesk mehrere SDKs für iOS anbietet. Die Wahl des falschen SDK kann später Probleme verursachen, daher lohnt es sich, die Unterschiede im Voraus zu verstehen.

Zendesk Messaging SDK (empfohlen für neue Projekte)

Dies ist das moderne SDK von Zendesk und das, das Sie für jede neue Integration verwenden sollten. Es bietet eine zeitgemäße Messaging-Erfahrung, bei der Benutzer fortlaufende Konversationen führen können, die im Laufe der Zeit bestehen bleiben. Das Messaging SDK wird aktiv gewartet, wobei die neueste Version (2.37.0) im Januar 2026 veröffentlicht wurde.

Zu den wichtigsten Funktionen gehören:

• Unterstützung für mehrere Konversationen (Benutzer können mehrere laufende Konversationen führen)
• Rich Messaging mit Karussells, Formularen und Dateianhängen
• Push-Benachrichtigungsunterstützung für Echtzeit-Updates
• Proaktives Messaging von Ihrem Unternehmen
• Wartezeit-Banner, die die Position in der Warteschlange anzeigen

Klassisches Support SDK (Legacy/Archiviert)

Wichtig: Das klassische Zendesk SDK für iOS wurde am 23. November 2024 archiviert. Das GitHub-Repository ist jetzt schreibgeschützt. Wenn Sie derzeit dieses SDK verwenden, sollten Sie eine Migration zum Messaging SDK planen. Detaillierte Schritte finden Sie im Migrationsleitfaden von Zendesk.

Sunshine Conversations SDK (erweiterte Anwendungsfälle)

Für Apps, die hochgradig angepasste Messaging-Erlebnisse benötigen, bietet Sunshine Conversations (ehemals Smooch) mehr Flexibilität. Es unterstützt erweiterte Funktionen wie benutzerdefinierte UI-Implementierungen und komplexe Konversations-Workflows. Für die meisten Standard-Support-Anwendungsfälle ist das Messaging SDK jedoch die bessere Wahl.

Schritt 2: Fügen Sie das SDK zu Ihrem Xcode-Projekt hinzu

Das Zendesk Messaging SDK unterstützt vier Installationsmethoden. Swift Package Manager ist der empfohlene Ansatz für die moderne iOS-Entwicklung.

Swift Package Manager (empfohlen)

1. Wählen Sie in Xcode Datei > Swift Packages > Add Package Dependency
2. Geben Sie die Repository-URL ein: https://github.com/zendesk/sdk_messaging_ios/
3. Befolgen Sie die Anweisungen von Xcode, um ZendeskMessagingSDK als Abhängigkeit hinzuzufügen

Xcode löst und lädt automatisch alle erforderlichen Abhängigkeiten herunter.

CocoaPods

Fügen Sie diese Zeile zu Ihrer Podfile hinzu:

pod 'ZendeskSDKMessaging'

Führen Sie dann pod install aus.

Carthage

Fügen Sie dies zu Ihrer Cartfile hinzu:

github "zendesk/sdk_messaging_ios"

Führen Sie carthage update --use-xcframeworks aus und ziehen Sie dann die Frameworks in Ihr Projekt.

Erforderliche Berechtigungen

Fügen Sie diese Schlüssel zur Info.plist Ihrer App hinzu, um den Zugriff auf Kamera, Mikrofon und Fotobibliothek zu aktivieren:

• NSCameraUsageDescription ermöglicht den Kamerazugriff für Bilder und Videos
• NSMicrophoneUsageDescription ermöglicht den Mikrofonzugriff für Videoaufnahmen
• NSPhotoLibraryUsageDescription ermöglicht den Lese-/Schreibzugriff auf die Fotobibliothek

Schritt 3: Initialisieren Sie das SDK in Ihrer App

Sobald das SDK zu Ihrem Projekt hinzugefügt wurde, müssen Sie es mit Ihrem Kanalschlüssel initialisieren.

Abrufen Ihres Kanalschlüssels

Ihr Kanalschlüssel wird im Zendesk Admin Center generiert:

1. Melden Sie sich im Zendesk Admin Center an
2. Navigieren Sie zu Kanäle > Messaging
3. Klicken Sie auf Kanal hinzufügen und wählen Sie iOS
4. Folgen Sie den Anweisungen, um Ihren Kanalschlüssel zu generieren

Initialisierungscode

Fügen Sie diese Importe zu Ihrer AppDelegate oder Haupt-App-Datei hinzu:

Swift:

import ZendeskSDKMessaging
import ZendeskSDK

Objective-C:

#import <ZendeskSDKMessaging/ZendeskSDKMessaging.h>
#import <ZendeskSDK/ZendeskSDK.h>

Initialisieren Sie das SDK beim Start der App:

Swift:

Zendesk.initialize(
    withChannelKey: "<your_channel_key>",
    messagingFactory: DefaultMessagingFactory()
) { result in
    if case let .failure(error) = result {
        print("Messaging did not initialize. Error: \(error.localizedDescription)")
    }
}

Objective-C:

[Zendesk initializeWithChannelKey:@"<your_channel_key>"
                 messagingFactory:[[ZDKDefaultMessagingFactory alloc] init]
                completionHandler:^(Zendesk * _Nullable zendesk, NSError * _Nullable error) {
    if (error != nil) {
        NSLog(@"Zendesk did not initialize. Error: %@", error.localizedDescription);
    }
}];

Die SDK-Größe beträgt ungefähr 7,5 MB für den XCFramework-Download, obwohl die endgültigen Auswirkungen auf Ihre App-Größe aufgrund von App-Thinning und Linker-Optimierungen geringer sein können.

Schritt 4: Richten Sie die Benutzerauthentifizierung ein

Das SDK unterstützt je nach Anwendungsfall zwei Authentifizierungsmethoden.

Anonyme Authentifizierung

Verwenden Sie für Benutzer, die sich nicht in Ihrer App angemeldet haben, die anonyme Authentifizierung:

Swift:

let identity = Identity.createAnonymous()
Zendesk.instance?.setIdentity(identity)

Dadurch wird für jedes Gerät ein neuer Benutzerdatensatz in Zendesk erstellt.

JWT-Authentifizierung

Verwenden Sie für authentifizierte Benutzer JWT, um ihre Identität zu überprüfen:

Swift:

let identity = Identity.createJwt(token: "<your_jwt_token>")
Zendesk.instance?.setIdentity(identity)

Die JWT-Authentifizierung stellt sicher, dass Benutzer über mehrere Geräte hinweg auf ihre Konversationshistorie zugreifen können und verhindert Identitätsdiebstahl. Ab SDK-Version 2.34.0 gibt es auch einen AuthenticationDelegate für die nahtlose Handhabung der Token-Aktualisierung.

Schritt 5: Anzeigen der Messaging-Oberfläche

Nach der Initialisierung können Sie die Messaging-Oberfläche überall in Ihrer App präsentieren.

Grundlegende Präsentation

Swift:

if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
    self.navigationController?.show(viewController, sender: self)
}

Objective-C:

UIViewController *viewController = [Zendesk.instance.messaging messagingViewController];
if (viewController != NULL) {
    [self.navigationController showViewController:viewController sender:self];
}

Modale Präsentation

Für eine modale Erfahrung anstelle des Aufschiebens auf den Navigationsstack:

Swift:

if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
    let navigationController = UINavigationController(rootViewController: viewController)
    navigationController.modalPresentationStyle = .fullScreen
    present(navigationController, animated: true)
}

Standardmäßig navigiert das SDK zur zuletzt aktiven Konversation. Wenn in Ihrem Konto Multi-Konversationen aktiviert sind, können Benutzer mehrere laufende Konversationen gleichzeitig verwalten.

Schritt 6: Anpassen der UI und des Verhaltens

Das SDK bietet verschiedene Anpassungsoptionen, um dem Branding Ihrer App zu entsprechen.

Designfarben

Sie können Farben über das Zendesk Admin Center oder programmgesteuert für mehr Kontrolle anpassen. Legen Sie Ihre Primärfarbe mit Folgendem fest:

CommonTheme.currentTheme.primaryColor = .cyan

Anpassung der Navigationsleiste

Verwenden Sie für das Styling der Navigationsleiste den Standard-UIAppearance-Proxy:

UINavigationBar.appearance().barTintColor = .cyan

Pre-Chat-Formulare und Bot-Konfiguration

Sie können Pre-Chat-Formulare konfigurieren, um Benutzerinformationen zu sammeln, bevor Sie eine Konversation starten. Richten Sie Formulare über Ihr Zendesk Admin Center ein oder verwenden Sie die Konfigurationsoptionen des SDK, um die Erfahrung anzupassen.

Bekannte iOS-Einschränkungen

Beachten Sie diese Anpassungseinschränkungen unter iOS:

• Answer Bot-Avatar kann nicht geändert werden
• Die rechte Navigationsleisten-Schaltfläche kann nicht überschrieben werden
• Die Farbe des Navigationstitels hat begrenzte Anpassungsoptionen
• Die Chat-Textschriftart kann nicht geändert werden

Diese Einschränkungen sind in der iOS-Dokumentation von Zendesk dokumentiert und sind über iOS-Implementierungen hinweg konsistent.

Häufige Probleme und Fehlerbehebung

Hier sind Lösungen für Probleme, auf die Entwickler häufig stoßen:

Initialisierungsfehler

Wenn das SDK nicht initialisiert werden kann:

• Überprüfen Sie, ob Ihr Kanalschlüssel korrekt ist und mit der Bundle-ID Ihrer App übereinstimmt
• Stellen Sie sicher, dass Messaging in Ihrem Zendesk-Konto aktiviert ist
• Stellen Sie sicher, dass Sie den richtigen Regionsendpunkt (US oder EU) verwenden

Probleme mit Push-Benachrichtigungen

Push-Benachrichtigungen erfordern eine sorgfältige Einrichtung:

1. Stellen Sie sicher, dass Sie Ihr .p12-Zertifikat in das Zendesk Admin Center hochgeladen haben
2. Stellen Sie sicher, dass die APS-Umgebungsberechtigung auf "Produktion" (nicht Entwicklung) gesetzt ist
3. Überprüfen Sie, ob Ihr Bereitstellungsprofil Push-Benachrichtigungsfunktionen enthält
4. Stellen Sie sicher, dass Sie ein kombiniertes Sandbox- und Produktionszertifikat verwenden, nicht nur Sandbox

Quelle: Zendesk Push-Benachrichtigungs-Einrichtungsanleitung

Authentifizierungsfehler

JWT-Authentifizierungsprobleme resultieren normalerweise aus:

• Abgelaufene Token Implementieren Sie die Token-Aktualisierung mithilfe von AuthenticationDelegate
• Falsches Token-Format Stellen Sie sicher, dass Ihr JWT die erforderlichen Zendesk-Claims befolgt
• Taktversatz Überprüfen Sie, ob die Server- und Gerätezeiten synchronisiert sind

Speicher und Leistung

Das SDK ist leichtgewichtig, aber Sie sollten:

• Initialisieren Sie es einmal beim Start der App, nicht wiederholt
• Behandeln Sie Speicherwarnungen angemessen
• Testen Sie auf älteren Geräten, wenn Ihre App iOS 14 unterstützt

Verbesserung des mobilen Supports mit eesel AI

Während das Zendesk Mobile SDK die Grundlage für den In-App-Kundenservice bietet, möchten viele Teams intelligente Automatisierung hinzufügen, um häufige Fragen ohne menschliches Zutun zu beantworten. Hier kommen wir ins Spiel.

Bei eesel AI haben wir eine KI-Plattform entwickelt, die zusammen mit Ihrem Zendesk-Setup funktioniert, um Antworten zu automatisieren und die Ablenkungsraten zu verbessern. Anstatt Tickets nur weiterzuleiten, kann unsere KI häufige Probleme lösen, indem sie aus Ihrer gesamten Wissensdatenbank schöpft, nicht nur aus Zendesk Guide-Artikeln.

So verwenden uns Teams typischerweise zusammen mit ihrer Zendesk Mobile SDK Integration:

• Verbinden Sie mehrere Wissensquellen Wir ziehen Antworten aus Confluence, Google Docs, Notion und anderen Plattformen, auf denen Ihre Dokumentation gespeichert ist, sodass Kunden vollständige Antworten erhalten, auch wenn Informationen verstreut sind

• Testen Sie, bevor Sie live gehen Unser Simulationsmodus ermöglicht es Ihnen, KI-Antworten anhand Ihrer vergangenen Tickets zu testen, um Ablenkungsraten vorherzusagen, bevor Kunden sie sehen

• Progressiver Rollout Beginnen Sie damit, dass KI Entwürfe für Antworten zur Überprüfung erstellt, und erweitern Sie sie dann auf die vollständige Automatisierung, wenn das Vertrauen wächst

Wenn Sie bereits eine Zendesk Mobile SDK Integration planen, kann das Hinzufügen von KI-gestützten Antworten das Volumen der Tickets reduzieren, die Ihre menschlichen Agenten erreichen. Sehen Sie sich unsere Zendesk Integration an, um zu sehen, wie sie funktioniert.

Beginnen Sie noch heute mit dem Aufbau eines besseren mobilen Supports

Die Integration des Zendesk Mobile SDK in Ihre iOS-App ist unkompliziert, sobald Sie die Schritte kennen. Der Schlüssel liegt darin, das richtige SDK (Messaging SDK für neue Projekte) auszuwählen, Ihren Kanalschlüssel aus dem Admin Center abzurufen und die Authentifizierung für Ihren Anwendungsfall entsprechend zu handhaben.

Das SDK bietet Ihnen ein professionelles Support-Erlebnis mit minimalem Entwicklungsaufwand. Und wenn Sie noch einen Schritt weiter gehen möchten mit KI-gestützter Automatisierung, kann eesel AI Ihnen helfen, mehr Tickets abzulenken und Probleme schneller zu lösen.

Bereit anzufangen? Gehen Sie zur Zendesk Entwicklerdokumentation für die neueste SDK-Version und detaillierte API-Referenzen.