zendesk-mobile-sdk-ios-integration
eesel Team
Last edited 26 février 2026
{
"title": "Intégration du SDK mobile Zendesk iOS : un guide complet pour 2026",
"slug": "zendesk-mobile-sdk-ios-integration",
"locale": "fr",
"date": "2026-02-26",
"updated": "2026-02-26",
"template": "default",
"excerpt": "Un guide pratique pour développeurs pour intégrer le SDK iOS de Zendesk, couvrant les méthodes d'installation, l'initialisation, l'authentification et la personnalisation de l'interface utilisateur.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"iOS SDK",
"Mobile Integration",
"Customer Support",
"App Development"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Intégration du SDK mobile Zendesk iOS : un guide complet pour 2026",
"description": "Un guide pratique pour développeurs pour intégrer le SDK iOS de Zendesk, couvrant les méthodes d'installation, l'initialisation, l'authentification et la personnalisation de l'interface utilisateur.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-423d5b0b-218b-41f8-bbbc-b17d7d8c284d"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-423d5b0b-218b-41f8-bbbc-b17d7d8c284d",
"coverImageAlt": "Image de bannière pour l'intégration du SDK mobile Zendesk iOS : un guide complet pour 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Foire aux questions",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "Quelle est la version minimale d'iOS requise pour l'intégration du SDK mobile Zendesk ?",
"answer": "Le SDK de messagerie Zendesk nécessite iOS 14 ou une version ultérieure à partir de la version 2.33.0. Le SDK de support classique prenait en charge iOS 12 et versions ultérieures, mais ce SDK est maintenant archivé et n'est plus maintenu."
},
{
"question": "Puis-je utiliser l'intégration du SDK mobile Zendesk iOS avec des projets Swift et Objective-C ?",
"answer": "Oui, le SDK prend en charge Swift et Objective-C. Tous les exemples de code de la documentation sont fournis dans les deux langues, et le SDK est conçu dans un souci d'interopérabilité."
},
{
"question": "Comment gérer les notifications push avec l'intégration du SDK mobile Zendesk iOS ?",
"answer": "Les notifications push nécessitent la création d'un certificat SSL Apple Push Notification service, le téléchargement du fichier .p12 vers le centre d'administration Zendesk, l'ajout de la fonctionnalité Notifications push dans Xcode et l'implémentation des méthodes UNUserNotificationCenterDelegate dans votre AppDelegate. Le SDK fournit des méthodes d'assistance pour vérifier si une notification push appartient à Zendesk et doit être affichée."
},
{
"question": "L'intégration du SDK mobile Zendesk iOS est-elle gratuite ?",
"answer": "Le SDK lui-même est gratuit, mais vous avez besoin d'un plan Zendesk Support ou Suite pour l'utiliser. La tarification de Zendesk commence à 19 $ par agent et par mois pour le plan Support Team. Les fonctionnalités du SDK disponibles dépendent du niveau de votre plan Zendesk."
},
{
"question": "Puis-je personnaliser l'apparence de l'intégration du SDK mobile Zendesk iOS pour qu'elle corresponde à mon application ?",
"answer": "Oui, vous pouvez personnaliser les couleurs du thème, le style de la barre de navigation et certains éléments de l'interface utilisateur. Cependant, il existe des limitations connues sur iOS : vous ne pouvez pas modifier l'avatar de l'Answer Bot, remplacer le bouton de navigation de droite ou personnaliser la police du texte de chat. La plupart de la personnalisation de la marque est gérée via le centre d'administration Zendesk."
},
{
"question": "Quelle est la différence entre l'authentification anonyme et l'authentification JWT dans l'intégration du SDK mobile Zendesk iOS ?",
"answer": "L'authentification anonyme crée un nouvel enregistrement d'utilisateur pour chaque appareil et convient aux utilisateurs d'applications non authentifiés. L'authentification JWT vérifie l'identité de l'utilisateur à l'aide d'un jeton signé et permet aux utilisateurs d'accéder à leur historique de conversation sur plusieurs appareils. JWT est recommandé pour les utilisateurs connectés."
}
],
"supportLink": null
}
}
---
Lorsque vos clients ont besoin d'aide, la dernière chose qu'ils souhaitent est de quitter votre application. Les obliger à ouvrir un navigateur, à rechercher votre page d'assistance ou à fouiller dans leurs e-mails pour trouver les mises à jour des tickets crée des frictions qui nuisent à l'expérience client. C'est pourquoi l'intégration de l'assistance directement dans votre application iOS avec le [SDK mobile Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) est devenue essentielle pour un service client moderne.
Ce guide vous explique comment intégrer le SDK iOS de Zendesk du début à la fin. Que vous construisiez une nouvelle application ou que vous ajoutiez une assistance à une application existante, vous apprendrez les étapes exactes pour que la messagerie client fonctionne dans votre application. Pour les équipes qui cherchent à ajouter des réponses basées sur l'IA à leur assistance mobile, nous verrons également comment [eesel AI](https://www.eesel.ai/integration/zendesk-ai) fonctionne avec le SDK mobile Zendesk.
## Ce dont vous aurez besoin
Avant de commencer, voici ce dont vous aurez besoin :
- Un [plan Zendesk Support ou Suite](https://www.zendesk.com/pricing/)
- Xcode 11.4 ou version ultérieure
- Une application iOS ciblant iOS 14 ou version ultérieure
- Un accès administrateur à votre compte Zendesk pour récupérer les clés de canal
- Projet Swift 5.2.2+ ou Objective-C
Le SDK prend en charge Swift et Objective-C, vous pouvez donc l'intégrer quelle que soit la langue utilisée par votre application. Swift Package Manager fonctionne mieux pour les projets modernes, mais CocoaPods et Carthage restent disponibles si votre projet en dépend déjà.
## Étape 1 : Choisissez le bon SDK Zendesk pour vos besoins
De nombreux développeurs ne réalisent pas que Zendesk propose plusieurs SDK pour iOS. Choisir le mauvais peut créer des problèmes plus tard, il est donc utile de comprendre les différences au préalable.
### SDK de messagerie Zendesk (recommandé pour les nouveaux projets)
Il s'agit du SDK moderne de Zendesk et celui que vous devez utiliser pour toute nouvelle intégration. Il offre une expérience de messagerie contemporaine où les utilisateurs peuvent avoir des conversations continues qui persistent dans le temps. Le SDK de messagerie est activement maintenu, avec la [dernière version (2.37.0)](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/release_notes/) publiée en janvier 2026.
Les principales fonctionnalités comprennent :
- Prise en charge de plusieurs conversations (les utilisateurs peuvent avoir plusieurs conversations en cours)
- Messagerie enrichie avec des carrousels, des formulaires et des pièces jointes
- Prise en charge des notifications push pour les mises à jour en temps réel
- Messagerie proactive de votre entreprise
- Bannières de temps d'attente indiquant la position dans la file d'attente
### SDK de support classique (hérité/archivé)
**Important :** Le [SDK Zendesk classique pour iOS](https://github.com/zendesk/zendesk_sdk_ios) a été archivé le 23 novembre 2024. Le référentiel GitHub est désormais en lecture seule. Si vous utilisez actuellement ce SDK, vous devez planifier une migration vers le SDK de messagerie. Consultez le [guide de migration](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/chat_migration/) de Zendesk pour connaître les étapes détaillées.
### SDK Sunshine Conversations (cas d'utilisation avancés)
Pour les applications nécessitant des expériences de messagerie hautement personnalisées, [Sunshine Conversations](https://docs.smooch.io/guide/native-ios-sdk/) (anciennement Smooch) offre plus de flexibilité. Il prend en charge des fonctionnalités avancées telles que les implémentations d'interface utilisateur personnalisées et les flux de travail conversationnels complexes. Cependant, pour la plupart des cas d'utilisation de support standard, le SDK de messagerie est le meilleur choix.
## Étape 2 : Ajoutez le SDK à votre projet Xcode
Le [SDK de messagerie Zendesk](https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/ios/getting_started/) prend en charge quatre méthodes d'installation. Swift Package Manager est l'approche recommandée pour le développement iOS moderne.
### Swift Package Manager (recommandé)
1. Dans Xcode, sélectionnez **Fichier > Swift Packages > Ajouter une dépendance de package**
2. Entrez l'URL du référentiel : `https://github.com/zendesk/sdk_messaging_ios/`
3. Suivez les instructions de Xcode pour ajouter ZendeskMessagingSDK en tant que dépendance
Xcode résoudra et téléchargera automatiquement toutes les dépendances requises.
### CocoaPods
Ajoutez cette ligne à votre Podfile :
pod 'ZendeskSDKMessaging'
Ensuite, exécutez `pod install`.
### Carthage
Ajoutez ceci à votre Cartfile :
github "zendesk/sdk_messaging_ios"
Exécutez `carthage update --use-xcframeworks`, puis faites glisser les frameworks dans votre projet.
### Autorisations requises
Ajoutez ces clés au fichier Info.plist de votre application pour activer l'accès à la caméra, au microphone et à la photothèque :
- `NSCameraUsageDescription` autorise l'accès à la caméra pour les images et les vidéos
- `NSMicrophoneUsageDescription` autorise l'accès au microphone pour la capture vidéo
- `NSPhotoLibraryUsageDescription` autorise l'accès en lecture/écriture à la photothèque
## Étape 3 : Initialisez le SDK dans votre application
Une fois le SDK ajouté à votre projet, vous devez l'initialiser avec votre clé de canal.
### Obtenir votre clé de canal
Votre clé de canal est générée dans le centre d'administration Zendesk :
1. Connectez-vous au [centre d'administration Zendesk](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Zendesk-Admin-Center)
2. Accédez à Canaux > Messagerie
3. Cliquez sur **Ajouter un canal** et sélectionnez iOS
4. Suivez les instructions pour générer votre clé de canal
### Code d'initialisation
Ajoutez ces importations à votre AppDelegate ou au fichier principal de votre application :
**Swift :**
```swift
import ZendeskSDKMessaging
import ZendeskSDK
Objective-C :
#import <ZendeskSDKMessaging/ZendeskSDKMessaging.h>
#import <ZendeskSDK/ZendeskSDK.h>
Initialisez le SDK au lancement de l'application :
Swift :
Zendesk.initialize(
withChannelKey: "<your_channel_key>",
messagingFactory: DefaultMessagingFactory()
) { result in
if case let .failure(error) = result {
print("La messagerie ne s'est pas initialisée. Erreur : \(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 ne s'est pas initialisé. Erreur : %@", error.localizedDescription);
}
}];
La taille du SDK est d'environ 7,5 Mo pour le téléchargement de XCFramework, bien que l'impact final sur la taille de votre application puisse être plus faible en raison de l'amincissement de l'application et des optimisations de l'éditeur de liens.
Étape 4 : Configurez l'authentification de l'utilisateur
Le SDK prend en charge deux méthodes d'authentification en fonction de votre cas d'utilisation.
Authentification anonyme
Pour les utilisateurs qui ne se sont pas connectés à votre application, utilisez l'authentification anonyme :
Swift :
let identity = Identity.createAnonymous()
Zendesk.instance?.setIdentity(identity)
Cela crée un nouvel enregistrement d'utilisateur dans Zendesk pour chaque appareil.
Authentification JWT
Pour les utilisateurs authentifiés, utilisez JWT pour vérifier leur identité :
Swift :
let identity = Identity.createJwt(token: "<your_jwt_token>")
Zendesk.instance?.setIdentity(identity)
L'authentification JWT garantit que les utilisateurs peuvent accéder à leur historique de conversation sur plusieurs appareils et empêche l'usurpation d'identité. À partir de la version 2.34.0 du SDK, il existe également un AuthenticationDelegate pour gérer l'actualisation des jetons de manière transparente.
Étape 5 : Affichez l'interface de messagerie
Une fois initialisé, vous pouvez présenter l'interface de messagerie n'importe où dans votre application.
Présentation de base
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];
}
Présentation modale
Pour une expérience modale au lieu d'être poussé sur la pile de navigation :
Swift :
if let viewController = Zendesk.instance?.messaging?.messagingViewController() {
let navigationController = UINavigationController(rootViewController: viewController)
navigationController.modalPresentationStyle = .fullScreen
present(navigationController, animated: true)
}
Par défaut, le SDK accède à la conversation la plus récemment active. Si la prise en charge de plusieurs conversations est activée sur votre compte, les utilisateurs peuvent gérer plusieurs conversations en cours à la fois.
Étape 6 : Personnalisez l'interface utilisateur et le comportement
Le SDK offre plusieurs options de personnalisation pour correspondre à l'image de marque de votre application.
Couleurs du thème
Vous pouvez personnaliser les couleurs via le centre d'administration Zendesk ou par programmation pour plus de contrôle. Définissez votre couleur principale à l'aide de :
CommonTheme.currentTheme.primaryColor = .cyan
Personnalisation de la barre de navigation
Pour le style de la barre de navigation, utilisez le proxy UIAppearance standard :
UINavigationBar.appearance().barTintColor = .cyan
Formulaires de pré-chat et configuration du bot
Vous pouvez configurer des formulaires de pré-chat pour collecter des informations sur l'utilisateur avant de démarrer une conversation. Configurez des formulaires via votre centre d'administration Zendesk ou utilisez les options de configuration du SDK pour personnaliser l'expérience.
Limitations iOS connues
Soyez conscient de ces limitations de personnalisation sur iOS :
- L'avatar de l'Answer Bot ne peut pas être modifié
- Le bouton de la barre de navigation de droite ne peut pas être remplacé
- La couleur du titre de la navigation a des options de personnalisation limitées
- La police du texte de chat ne peut pas être modifiée
Ces limitations sont documentées dans la documentation iOS de Zendesk et sont cohérentes entre les implémentations iOS.
Problèmes courants et dépannage
Voici des solutions aux problèmes que les développeurs rencontrent fréquemment :
Échecs d'initialisation
Si le SDK ne parvient pas à s'initialiser :
- Vérifiez que votre clé de canal est correcte et correspond à l'ID de bundle de votre application
- Assurez-vous que la messagerie est activée sur votre compte Zendesk
- Vérifiez que vous utilisez le point de terminaison de région correct (US ou EU)
Problèmes de notifications push
Les notifications push nécessitent une configuration minutieuse :
- Assurez-vous d'avoir téléchargé votre certificat .p12 vers le centre d'administration Zendesk
- Vérifiez que l'autorisation APS Environment est définie sur « production » (pas développement)
- Vérifiez que votre profil d'approvisionnement inclut les fonctionnalités de notification push
- Assurez-vous que vous utilisez un certificat Sandbox et Production combiné, pas uniquement Sandbox
Source : Guide de configuration des notifications push de Zendesk
Erreurs d'authentification
Les problèmes d'authentification JWT proviennent généralement de :
- Jetons expirés : implémentez l'actualisation des jetons à l'aide d'AuthenticationDelegate
- Format de jeton incorrect : assurez-vous que votre JWT respecte les revendications requises de Zendesk
- Décalage d'horloge : vérifiez que les heures du serveur et de l'appareil sont synchronisées
Mémoire et performances
Le SDK est léger, mais vous devez :
- L'initialiser une seule fois au lancement de l'application, pas à plusieurs reprises
- Gérer les avertissements de mémoire de manière appropriée
- Tester sur des appareils plus anciens si votre application prend en charge iOS 14
Améliorer l'assistance mobile avec eesel AI
Bien que le SDK mobile Zendesk fournisse la base du service client intégré à l'application, de nombreuses équipes souhaitent ajouter une automatisation intelligente pour traiter les questions courantes sans intervention humaine. C'est là que nous intervenons.
Chez eesel AI, nous avons créé une plateforme d'IA qui fonctionne avec votre configuration Zendesk pour automatiser les réponses et améliorer les taux de déviation. Au lieu de simplement acheminer les tickets, notre IA peut résoudre les problèmes courants en s'appuyant sur l'ensemble de votre base de connaissances, et pas seulement sur les articles du guide Zendesk.
Voici comment les équipes nous utilisent généralement avec leur intégration du SDK mobile Zendesk :
-
Connectez plusieurs sources de connaissances : nous extrayons les réponses de Confluence, Google Docs, Notion et d'autres plateformes où réside votre documentation, afin que les clients obtiennent des réponses complètes même lorsque les informations sont dispersées
-
Testez avant de passer en direct : notre mode de simulation vous permet de tester les réponses de l'IA par rapport à vos tickets passés pour prévoir les taux de déviation avant que les clients ne les voient
-
Déploiement progressif : commencez par faire rédiger des réponses par l'IA pour examen, puis passez à l'automatisation complète au fur et à mesure que la confiance augmente
Si vous prévoyez déjà une intégration du SDK mobile Zendesk, l'ajout de réponses basées sur l'IA peut réduire le volume de tickets qui atteignent vos agents humains. Consultez notre intégration Zendesk pour voir comment cela fonctionne.
Commencez à créer une meilleure assistance mobile dès aujourd'hui
L'intégration du SDK mobile Zendesk dans votre application iOS est simple une fois que vous connaissez les étapes. La clé est de choisir le bon SDK (SDK de messagerie pour les nouveaux projets), d'obtenir votre clé de canal auprès du centre d'administration et de gérer l'authentification de manière appropriée pour votre cas d'utilisation.
Le SDK vous offre une expérience d'assistance professionnelle avec un minimum d'efforts de développement. Et si vous voulez aller plus loin avec l'automatisation basée sur l'IA, eesel AI peut vous aider à dévier plus de tickets et à résoudre les problèmes plus rapidement.
Prêt à commencer ? Rendez-vous sur la documentation pour développeurs Zendesk pour obtenir la dernière version du SDK et des références d'API détaillées.
Partager cet article
Article by
