Utilisez cet article pour installer Intercom Messenger dans votre application mobile, authentifier vos users connectés en toute sécurité et vérifier que tout fonctionne avant la mise en production.
Les étapes pour une installation complète et sécurisée de Messenger sont :
Choisissez votre type d'installation.
Installez et initialisez le SDK.
Authentifiez les users connectés.
Testez votre installation.
Note :
Ceci est la nouvelle expérience d'installation de Messenger, déployée progressivement. Si votre espace de travail n'a pas encore été basculé, utilisez plutôt Installer et utiliser Intercom dans votre application mobile.
Vous aurez besoin d'un plan contractuel ou mensuel pour installer Messenger, ainsi que d'un accès au code source de votre application (ou d'un développeur qui l'a). Messenger prend en charge iOS, Android et React Native.
Choisissez votre type d'installation
Allez dans Paramètres > Canaux > Messenger Live Chat > Aperçu , trouvez la carte Mobile app et sélectionnez Installer sur l'application mobile.
Sélectionnez votre type d'installation
On vous demandera « Quelles informations votre équipe a-t-elle besoin dans votre inbox ? » et deux options vous seront présentées :
Users non connectés (installation la plus rapide) — Les conversations ne sont pas liées aux détails des users. Vous pouvez compléter la configuration supplémentaire plus tard pour identifier les users connectés.
Users connectés et users non connectés — Les conversations des users connectés incluent les détails pertinents, donnant à votre équipe le contexte nécessaire pour fournir un support personnalisé. Nécessite des modifications de l'application et du backend.
Sélectionnez l'option qui correspond à votre entreprise, puis cliquez sur Continuer pour passer aux étapes d'installation ci-dessous.
Installez et initialisez le SDK
Cette section couvre les étapes 1 à 3 de l'installation. Cela ne prend que quelques minutes et s'applique que vous identifiiez ou non les users connectés.
1. Choisissez votre plateforme
Utilisez le menu déroulant Mobile app platform pour choisir la plateforme sur laquelle vous installez : iOS, Android ou React Native. Les étapes ci-dessous utilisent iOS comme exemple — le déroulement est le même pour les autres plateformes, avec du code spécifique à chaque plateforme.
2. Ajoutez la dépendance SDK
Choisissez votre méthode d'installation dans le menu déroulant (pour iOS, cela inclut Swift Package Manager et CocoaPods). Pour Swift Package Manager :
Dans Xcode, allez dans Fichier > Ajouter des packages.
Lorsque vous y êtes invité, saisissez l'URL du dépôt du SDK Intercom iOS (software development kit) :
.package(url: "https://github.com/intercom/intercom-ios", from: "18.0.0")
Sélectionnez la version d'Intercom que vous souhaitez utiliser. Nous recommandons d'utiliser la dernière version.
Cliquez sur Ajouter le package et Intercom sera automatiquement téléchargé comme dépendance pour votre projet.
3. Initialisez Intercom
Vous verrez votre clé API spécifique à la plateforme à cette étape — par exemple, votre clé API iOS. Cliquez sur Copier le code pour la récupérer, ou sur Régénérer la clé API si vous en avez besoin d'une nouvelle.
Appelez ce qui suit dans la méthode déléguée de votre application :
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
}
}Authentifiez les users connectés
Cette section couvre les étapes 4 à 7, et nécessite des modifications à la fois sur votre application mobile et votre backend.
4. Choisissez votre langage backend
Utilisez le menu déroulant pour choisir le langage dans lequel votre backend est écrit (par exemple, Node).
Astuce : Cette étape nécessite que quelqu'un génère des tokens côté serveur. Si ce n'est pas vous, cliquez sur Inviter un développeur pour faire venir un coéquipier afin de la terminer avec vous.
5. Générez un token pour chaque client
Sur votre serveur, générez un JSON Web Token (JWT) signé pour chaque user connecté :
const jwt = require('jsonwebtoken');
const token = jwt.sign(
{ user_id: user.id, email: user.email },
process.env.INTERCOM_SECRET_KEY,
{ algorithm: 'HS256', expiresIn: '1h' },
);
Vous aurez besoin de la clé secrète de votre workspace pour cela — elle est affichée (masquée) à cette étape. Gardez cette clé sur votre serveur. Ne l'incluez jamais dans le code du navigateur ou de l'application.
Note : Les clés sont spécifiques aux plateformes, et votre workspace peut en avoir plusieurs. Vous pouvez créer, faire pivoter ou décoder une clé depuis les paramètres de sécurité de votre Messenger.
6. Configurez le JWT dans votre application mobile
Passez le token généré par votre serveur dans votre appel d'initialisation Intercom existant, avec votre app_id :
Intercom({
app_id: 'your_app_id',
intercom_user_jwt: user.jwt,
});
7. Identifiez les users
Une fois le JWT intégré, identifiez le user connecté avec :
Intercom.loginUser(
ICPRegistrationOptions.create(userJwt: user.jwt)
) { result in }Important : Les anciennes versions de l'application n'enverront pas de tokens signés. Si votre application est déjà en ligne, les données clients ne seront pas connectées tant que vos users ne mettront pas à jour l'application. Nous recommandons une mise à jour forcée pour que tout le monde utilise une version qui envoie le JWT.
Testez votre installation
Une fois les étapes ci-dessus terminées, cliquez sur Testez votre installation. Cela confirme que Messenger et (le cas échéant) votre configuration JWT fonctionnent correctement avant la mise en production auprès de vos users.
Si quelque chose ne fonctionne pas, vérifiez :
Le app_id dans votre appel d'init correspond à votre workspace.
Votre clé secrète n'a pas été modifiée ou révoquée depuis la génération de votre dernier token.
Le user_id que vous transmettez au SDK correspond à celui encodé dans la charge utile JWT.
Une fois tout vérifié, vous êtes en ligne. Vous pouvez vérifier le statut d'installation à tout moment depuis Paramètres > Canaux > Messenger Live Chat > Aperçu, sous Emplacements d'installation.
Note : La durée de session est configurable depuis Paramètres > Canaux > Messenger Live Chat > Sécurité, sous Durée de session. Les clients sont invités à se réauthentifier une fois cette période expirée.
💡 Astuce : Besoin d'aide supplémentaire ? Obtenez du support sur notre Forum Communautaire. Trouvez des réponses et obtenez de l'aide de la part du support Intercom et des experts de la communauté.