Comment intégrer le SDK mobile Zendesk dans Android : un guide complet

Ajouter le support client directement dans votre application Android est l'une de ces fonctionnalités qui semblent simples jusqu'à ce que vous essayiez réellement de l'implémenter. Les utilisateurs s'attendent à obtenir de l'aide sans quitter votre application, et les SDK mobiles de Zendesk sont conçus pour que cela se produise. Mais voici le problème : Zendesk propose plusieurs options de SDK, et choisir la mauvaise peut signifier un travail supplémentaire par la suite.

Dans ce guide, je vais vous expliquer comment intégrer le SDK mobile Zendesk dans votre application Android. Nous aborderons à la fois le SDK de messagerie moderne et le SDK de support classique, afin que vous puissiez choisir ce qui correspond à vos besoins. Je vais également vous présenter eesel AI, qui adopte une approche différente du support intégré à l'application et pourrait vous faire gagner du temps de développement.

Comprendre vos options de SDK pour l'intégration du SDK mobile Zendesk Android

Avant d'écrire du code, vous devez décider quel SDK utiliser. Zendesk maintient actuellement deux principaux SDK Android, chacun servant des cas d'utilisation différents.

SDK de messagerie Zendesk (recommandé)

Le SDK de messagerie est l'approche moderne de Zendesk. Il fournit une interface de chat conversationnelle où les utilisateurs peuvent envoyer des messages aux agents de support en temps réel. Considérez cela comme l'intégration d'une application de chat directement dans votre application.

Ce SDK fonctionne mieux lorsque :

• Vous souhaitez un support conversationnel en temps réel
• Votre équipe utilise Zendesk Agent Workspace
• Vous avez besoin de fonctionnalités telles que les indicateurs de frappe et les confirmations de lecture
• Les notifications push pour les nouveaux messages sont importantes pour vos utilisateurs

SDK de support Zendesk (classique)

Le SDK de support est l'option la plus ancienne, mais toujours maintenue. Il se concentre sur l'accès au centre d'aide et la création de tickets plutôt que sur le chat en direct.

Ce SDK fonctionne mieux lorsque :

• Vous souhaitez que les utilisateurs parcourent les articles d'aide avant de contacter le support
• Votre flux de travail est basé sur les tickets plutôt que sur le chat
• Vous avez besoin d'options de personnalisation d'interface utilisateur étendues
• Vous utilisez déjà l'interface Zendesk classique

SDK Sunshine Conversations

Pour des cas d'utilisation plus complexes, il existe également le SDK Sunshine Conversations. C'est généralement excessif pour le support d'application de base, mais cela vaut la peine d'être envisagé si vous avez besoin d'une messagerie omnicanale sur plusieurs plateformes.

En résumé ? Si vous partez de zéro, optez pour le SDK de messagerie. C'est là que Zendesk investit ses efforts de développement, et l'expérience utilisateur est plus moderne.

Prérequis pour l'intégration du SDK mobile Zendesk Android

Avant de commencer à coder, assurez-vous d'avoir :

• Un compte Zendesk Support ou Suite (vous pouvez commencer par un essai gratuit)
• Android Studio avec Gradle
• SDK minimum : niveau d'API 21 (Android 5.0) : cela couvre environ 95 % des appareils Android actifs
• Java 8 ou supérieur
• Votre clé de canal (pour le SDK de messagerie) ou vos informations d'identification d'application (pour le SDK de support) depuis votre administrateur Zendesk

Vous devrez également enregistrer votre application mobile dans le Centre d'administration Zendesk. Un administrateur Zendesk doit générer les informations d'identification d'initialisation que vous utiliserez dans votre code. Cette étape est facile à manquer, alors faites-la avant de commencer l'intégration.

Guide pas à pas d'intégration du SDK mobile Zendesk Android

Passons en revue l'intégration du SDK de messagerie, car c'est ce que la plupart des équipes devraient utiliser en 2026.

Étape 1 : Configurez votre compte Zendesk

Tout d'abord, connectez-vous à votre Centre d'administration Zendesk et accédez à la section Canaux. Vous devrez enregistrer votre application Android pour obtenir une clé de canal.

Pendant que vous y êtes, décidez de votre approche d'authentification :

• Anonyme : les utilisateurs n'ont pas besoin de se connecter (option la plus simple)
• JWT : pour les utilisateurs authentifiés, nécessitant que votre backend génère des jetons

Pour la plupart des applications, l'authentification anonyme est suffisante pour commencer. Vous pouvez toujours ajouter JWT plus tard.

Étape 2 : Ajoutez le SDK à votre projet

Ouvrez votre projet dans Android Studio. Tout d'abord, ajoutez le référentiel Maven Zendesk à votre settings.gradle.kts :

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://zendesk.jfrog.io/zendesk/repo") }
    }
}

Ensuite, ajoutez la dépendance à votre build.gradle au niveau de l'application :

dependencies {
    implementation "zendesk.messaging:messaging-android:2.37.0"
}

N'oubliez pas de configurer la compatibilité Java 8 :

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Synchronisez votre projet avec les fichiers Gradle avant de passer à l'étape suivante.

Étape 3 : Initialisez le SDK

Créez ou ouvrez votre classe Application et ajoutez le code d'initialisation. Voici à quoi cela ressemble dans Kotlin :

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Zendesk.initialize(
            context = this,
            channelKey = "your_channel_key_here",
            successCallback = {
                // SDK initialized successfully
                Log.d("Zendesk", "Messaging SDK initialized")
            },
            failureCallback = { error ->
                // Handle initialization failure
                Log.e("Zendesk", "Failed to initialize: ${error.message}")
            }
        )
    }
}

Et en Java :

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Zendesk.initialize(
            this,
            "your_channel_key_here",
            () -> Log.d("Zendesk", "Messaging SDK initialized"),
            error -> Log.e("Zendesk", "Failed to initialize: " + error.getMessage())
        );
    }
}

Assurez-vous de remplacer "your_channel_key_here" par la clé de canal réelle de votre Centre d'administration Zendesk.

Étape 4 : Affichez l'interface de messagerie

Passons maintenant à la partie amusante : afficher l'interface de chat. Depuis n'importe quelle Activity, vous pouvez lancer la messagerie avec une seule ligne :

Kotlin :

Zendesk.instance.messaging.showMessaging(context)

Java :

Zendesk.instance.messaging().showMessaging(context);

Vous pouvez également obtenir un Intent si vous devez le lancer plus tard ou l'utiliser avec un PendingIntent :

val messagingIntent = Zendesk.instance.messaging.getMessagingIntent(context)
startActivity(messagingIntent)

Le SDK gère tout : l'historique des conversations, la disponibilité des agents et le fil de discussion des messages. Vos utilisateurs bénéficient d'une expérience de chat transparente sans que vous ayez à écrire de code d'interface utilisateur.

Étape 5 : Testez votre intégration

Avant de passer à la production, vérifiez que tout fonctionne :

1. Fonctionnalité de base : lancez l'application et ouvrez la messagerie. Vous devriez voir l'interface de chat se charger.
2. Flux de messages : envoyez un message de test. Il devrait apparaître dans votre Zendesk Agent Workspace.
3. Réponses des agents : répondez depuis Zendesk. Le message devrait apparaître dans votre application.
4. Notifications push : si vous avez configuré Firebase, testez que les notifications arrivent lorsque l'application est en arrière-plan.

Testez sur plusieurs versions d'Android si possible, surtout si vous prenez en charge des appareils plus anciens.

Problèmes courants et solutions d'intégration du SDK mobile Zendesk Android

Après avoir travaillé sur plusieurs intégrations, voici les problèmes qui surviennent le plus souvent :

Confusion concernant le format de l'URL Lors de la configuration du SDK de support, les développeurs utilisent parfois leur adresse e-mail au lieu du sous-domaine. Le format correct est votresousdomaine.zendesk.com, pas email@entreprise.zendesk.com.

Ordre d'initialisation Le SDK doit être initialisé avant que vous essayiez d'afficher la messagerie. Si vous voyez des erreurs « SDK non initialisé », vérifiez que vous appelez Zendesk.initialize() dans la méthode onCreate() de votre classe Application, et non dans une Activity.

Minification Proguard/R8 Si vous utilisez la réduction de code, vous devrez peut-être ajouter des règles Proguard pour conserver les classes Zendesk. La documentation du SDK contient des règles spécifiques à ajouter à votre proguard-rules.pro.

Configuration des notifications push Les notifications push nécessitent la configuration de Firebase Cloud Messaging. Assurez-vous d'avoir ajouté la dépendance FCM et téléchargé votre clé de serveur vers Zendesk. Il s'agit d'une étape courante qui est ignorée.

Erreurs de jeton d'authentification Si vous utilisez JWT, l'expiration du jeton peut entraîner des échecs mystérieux. Implémentez la logique d'actualisation des jetons et assurez-vous que votre backend génère des jetons valides.

Options de personnalisation pour votre intégration du SDK mobile Zendesk Android

Les SDK offrent plusieurs façons de faire correspondre l'apparence de votre application.

Pour le SDK de support, vous pouvez :

• Appliquer des thèmes Material Design (clair, foncé ou clair avec barre d'action foncée)
• Personnaliser les couleurs via colorPrimary, colorPrimaryDark et colorAccent
• Remplacer le CSS pour le style des articles du centre d'aide
• Remplacer les icônes par défaut par vos propres drawables

Le SDK de messagerie a moins d'options de personnalisation de par sa conception. Vous pouvez configurer le thème pour qu'il corresponde aux couleurs de votre marque, mais l'interface est plus standardisée. C'est en fait un avantage : moins à configurer, et les utilisateurs bénéficient d'une expérience de chat familière.

La localisation est gérée automatiquement si votre application prend en charge plusieurs langues. Le SDK détecte les paramètres régionaux de l'appareil et affiche les chaînes traduites lorsqu'elles sont disponibles.

Quand envisager une alternative basée sur l'IA à l'intégration du SDK mobile Zendesk Android

Voici quelque chose qui vaut la peine d'être considéré : l'intégration du SDK n'est pas la seule façon de fournir un excellent support mobile. Chez eesel AI, nous adoptons une approche différente qui pourrait mieux répondre à vos besoins.

Au lieu d'intégrer un SDK dans votre application, notre agent IA s'intègre directement à votre centre d'assistance. Cela signifie :

• Aucun développement mobile requis : votre équipe de support peut déployer l'IA sans attendre les approbations de l'app store
• Fonctionne sur tous les canaux : e-mail, chat, réseaux sociaux et tickets simultanément
• Apprend de plusieurs sources : nous nous entraînons sur vos tickets passés, votre centre d'aide, Confluence, Google Docs, et plus encore
• Testez avant de passer en direct : exécutez des simulations sur des milliers de tickets passés pour mesurer les performances

Notre IA gère le support de première ligne de manière autonome, en escaladant vers les humains uniquement lorsque cela est nécessaire. Vous définissez les règles d'escalade en langage clair, comme « Toujours escalader les litiges de facturation vers un humain » ou « Pour les clients VIP, mettre le gestionnaire de compte en copie. »

Les prix commencent à 299 $/mois pour le plan Team, qui comprend AI Copilot pour la rédaction des réponses et l'intégration de Slack. Le plan Business à 639 $/mois ajoute l'agent IA complet pour le support autonome.

Si vous utilisez déjà Zendesk, nous nous intégrons en un seul clic. Pas de SDK, pas de mises à jour d'application, pas d'attente.

Commencez à créer un meilleur support mobile dès aujourd'hui avec l'intégration du SDK mobile Zendesk Android

Vous avez maintenant tout ce dont vous avez besoin pour intégrer Zendesk dans votre application Android. Récapitulons les points clés :

• Choisissez le SDK de messagerie pour un support moderne basé sur le chat
• Assurez-vous d'avoir votre clé de canal du Centre d'administration Zendesk avant de coder
• Initialisez le SDK dans votre classe Application, pas dans une Activity
• Testez minutieusement, en particulier les notifications push si vous les utilisez

Le processus d'intégration prend généralement quelques heures pour une configuration de base, ou un jour ou deux si vous personnalisez beaucoup et testez sur différents appareils.

Si vous vous retrouvez à vouloir plus d'automatisation que ce que le SDK fournit, ou si vous avez besoin de réponses basées sur l'IA qui apprennent de votre historique de support existant, essayez eesel AI. Nous complétons votre configuration Zendesk existante sans aucun travail de développement mobile.

Quelle que soit l'approche que vous choisissez, vos utilisateurs apprécieront d'obtenir de l'aide sans quitter votre application. C'est le but, après tout.

Questions fréquemment posées sur l'intégration du SDK mobile Zendesk Android

Q1 : Combien de temps dure une intégration typique du SDK mobile Zendesk Android ? R1 : Une intégration de base prend 2 à 4 heures. La personnalisation, les tests sur différents appareils et la configuration des notifications push peuvent prolonger cette durée à 1 à 2 jours.

Q2 : Quelle est la version minimale d'Android requise pour l'intégration du SDK mobile Zendesk Android ? R2 : Le SDK de messagerie et le SDK de support nécessitent le niveau d'API 21 (Android 5.0) ou supérieur. Cela couvre environ 95 % des appareils Android actifs.

Q3 : Puis-je utiliser l'intégration du SDK mobile Zendesk Android sans compte Zendesk ? R3 : Non, vous avez besoin d'un compte Zendesk Support ou Suite actif. Vous pouvez commencer par un essai gratuit si vous évaluez la plateforme.

Q4 : Quelle est la taille ajoutée par l'intégration du SDK mobile Zendesk Android à la taille de mon application ? R4 : Le SDK de messagerie ajoute environ 7,5 Mo à votre APK avant la minification Proguard/R8. L'impact réel est généralement plus faible après l'optimisation.

Q5 : Puis-je personnaliser l'apparence du SDK mobile Zendesk dans mon application Android ? R5 : Le SDK de support offre une personnalisation étendue grâce aux thèmes Material Design et au CSS. Le SDK de messagerie offre des options de thème plus limitées, mais fournit une interface de chat moderne et cohérente.

Q6 : Que dois-je faire si l'initialisation de mon intégration du SDK mobile Zendesk Android échoue ? R6 : Vérifiez que vous utilisez la clé de canal correcte, que vous initialisez dans votre classe Application (pas dans une Activity) et que votre appareil dispose d'une connectivité Internet. Consultez le message d'erreur de rappel d'échec pour obtenir des détails spécifiques.