Général

Quelle est la taille des Mobile SDKs d'Intercom ?

La taille des SDKs varie, mais les tailles des Mobile SDK sont approximativement :

iOS : ~9 Mo
Android : ~7 Mo (réduction à l'installation avec les dépendances partagées, etc.)

Cela dépendra de la configuration.

Plateformes et support

Avez-vous un support pour Xamarin ?

Non, vous devrez vous appuyer sur des bibliothèques communautaires si nécessaire.

Avez-vous un support pour React Native ?

Oui ! Notre wrapper React Native a été publié le 24 juin 2021. Les informations d'installation se trouvent dans nos Developer Docs ici.

Avez-vous un support pour Ionic ?

Officiellement, nous ne supportons pas Ionic. Cependant, Intercom peut fonctionner avec Ionic 1 et 2. Pour utiliser Intercom avec Ionic, exécutez ce qui suit :

cordova plugin add cordova-plugin-intercom

Assurez-vous d'initialiser Intercom correctement.

Ionic 1

Pour Ionic 1, vous pouvez utiliser Intercom ainsi :

.run(function($ionicPlatform) {

  $ionicPlatform.ready(function() {

    cordova.plugins.intercom.registerIdentifiedUser({userId: "123456"});

    cordova.plugins.intercom.setLauncherVisibility('VISIBLE');

  });

})

Ionic 2

Pour Ionic 2, vous devez ajouter la variable suivante à votre app.component.ts :

declare var cordova:any;

Vous pouvez ensuite utiliser Intercom ainsi :

this.platform.ready().then(() => {

    cordova.plugins.intercom.registerIdentifiedUser({userId: "12345"});

    cordova.plugins.intercom.setLauncherVisibility('VISIBLE');

});

Gardez à l'esprit que cette méthode d'installation n'est pas officiellement supportée.

Y a-t-il une version minimale requise du SDK iOS ?

Pour recevoir les mises à jour du SDK iOS d'Intercom, vous devez avoir au minimum iOS 13. Cela dit, nous continuerons à supporter les clients sur des versions antérieures, mais sans mises à jour pour ces versions legacy.

Créez-vous des correctifs pour les anciennes versions de vos SDKs ?

Nous ne fournissons pas de correctifs pour les anciennes versions de nos SDKs. Toutes les corrections et mises à jour sont incluses dans la dernière version.

Note : Les mises à jour des Mobile SDK ne se font pas automatiquement. Votre équipe de développement doit mettre à jour manuellement vers la dernière version du SDK pour accéder aux nouvelles fonctionnalités et corrections de bug.

Fonctionnalités

Le Messenger fonctionne-t-il dans les applications mobiles ?

Oui ! Mais le Messenger fonctionne légèrement différemment dans les applications mobiles comparé au bureau. Cet article explique comment mettre à jour vos SDKs pour fonctionner avec le nouveau Messenger, et quelles fonctionnalités sont supportées sur iOS et Android.

Qu'est-ce qui est disponible avec Messenger dans les applications mobiles ?

Lorsque les visiteurs ou users accèdent au Messenger sur votre application iOS ou Android, ils peuvent interagir avec les espaces Help et Messages si vous les avez activés, ainsi qu'avec les applications que vous ajoutez à votre Home Space - pour faire plus que discuter.

Ils peuvent aussi démarrer des conversations avec vous et soumettre des tickets.

Vos clients peuvent envoyer des images, GIFs et vidéos sur mobile. Sur iOS, le téléchargement de fichiers (au-delà des images/GIFs/vidéos) est supporté depuis la version 18.2.0 du SDK, avec le téléchargement multi-fichiers ajouté en v19.6.0.

En savoir plus sur la personnalisation et l'utilisation du nouveau Messenger sur mobile ici.

Le Mobile SDK d'Intercom supporte-t-il plusieurs langues ?

Quand Intercom est chargé dans votre application mobile, la langue de l'utilisateur est détectée selon la langue du système d'exploitation. Le Messenger s'affichera dans la langue de l'utilisateur si elle est supportée dans votre workspace. Si ce n'est pas le cas, le Messenger s'affichera dans la langue par défaut de votre workspace.

Intercom ne suit pas automatiquement la langue des users mobiles dans un attribut de leur profil comme nous le faisons pour le web. Pour les users chargés dans le Messenger sur le web, Intercom suit leur langue dans l'attribut « Browser language », qui est applicable uniquement aux intégrations web.

Si vous souhaitez cibler du contenu sortant vers les users mobiles selon la langue, vous devez configurer le suivi vous-même. Vous pouvez utiliser l'attribut language_override pour suivre la langue des users mobiles, ou créer un attribut personnalisé pour cela.

Le Mobile SDK d'Intercom supporte-t-il le téléchargement vidéo sur mobile ?

Le téléchargement vidéo est supporté sur les SDKs Android et iOS. Sur iOS, il est supporté depuis la version 10.3.1 du SDK, avec la capture photo et vidéo via caméra ajoutée en v13. Sur Android, le téléchargement vidéo est aussi supporté. Les utilisateurs finaux peuvent envoyer images, GIFs et vidéos sur les deux plateformes.

Les Mobile SDKs supportent-ils les langues de droite à gauche (RTL) ?

Actuellement, nous ne supportons pas officiellement RTL dans les Mobile SDKs. Cependant, des fonctionnalités récentes comme le Help Center le supportent, ce qui explique la référence à RTL dans les nouvelles versions des SDKs. Nous prévoyons un support complet de RTL à l'avenir, mais pour l'instant, ce n'est pas supporté.

Comment puis-je utiliser Intercom pour afficher des annonces comme un écran de démarrage ?

Intercom n'offre pas de fonctionnalité spécifique d'écran de démarrage, mais vous pouvez utiliser des messages sortants comme Chats et Posts pour un effet similaire. Les Chats peuvent annoncer quelque chose à vos clients via le Messenger Intercom et les inciter à démarrer une conversation. Les Posts peuvent faire une annonce dans votre produit qui captera immédiatement l'attention de vos clients et peuvent être envoyés en deux tailles, Petite ou Grande.

Puis-je envoyer des messages à des écrans spécifiques dans mon application mobile ?

Il n'est pas possible d'envoyer un message aux users de votre application mobile sur des écrans spécifiques.

Cependant, en contournement, vous pouvez commencer à suivre un attribut personnalisé, appelons-le « current_screen », puis mettre à jour cet attribut avec un identifiant (nom ou ID) de l'écran chaque fois que vos users naviguent vers un écran différent dans votre application mobile. Cela peut être fait pour tous les écrans, ou seulement ceux que vous prévoyez de cibler avec un message automatique.

Après avoir mis en place cet attribut, vous pouvez configurer la règle « current_screen est splashScreen » dans votre audience ciblée pour envoyer un message uniquement aux users qui sont sur l'écran de démarrage.

Intercom suit-il des attributs supplémentaires sur les users via les Mobile SDKs ?

Une fois que le SDK mobile est installé dans un workspace, des attributs supplémentaires seront principalement disponibles dans l'interface web.

Pour iOS/Android

Is mobile unidentified
- Les utilisateurs unidentified sont ceux qui ne se sont pas connectés avec un email/user_id (similaire aux leads dans l'intégration web mais rappelez-vous que tous les enregistrements du SDK mobile sont des users).
Enabled Push Messaging
- indique que l'enregistrement possède un device token et peut donc recevoir des push messaging/notifications.

Note : L'attribut du SDK mobile 'Enabled Push Messaging' est toujours défini sur 'True' ou 'Unknown'. Si un utilisateur a un device token attaché à son profil utilisateur, 'Enabled Push Messaging' renverra true. Sinon, il renverra 'Unknown'.

Pour Android

Dernière connexion sur android
Sessions Android
Version de l'application Android
Appareil Android
Version os Android

Pour iOS

Dernière connexion sur ios
Sessions Ios
Version de l'application Ios
Appareil Ios
Version os Ios

Quand les sessions mobiles sont-elles incrémentées ?

Voici un lien vers notre article qui explore ce sujet
iOS
- Nous incrémentons le nombre de sessions iOS la première fois qu'un utilisateur est enregistré.
- Et ensuite à chaque UIApplicationDidBecomeActiveNotification déclenchée par l'ouverture de votre app par un utilisateur, à condition qu'elles soient espacées de vingt secondes.
- Les ouvertures d'application dans un intervalle de vingt secondes ne sont pas comptées.
Android : suit des règles similaires.

Y a-t-il une différence dans les attributs de type `App Version` ?

La version de l'application iOS est de type chaîne de caractères.
La version de l'application Android est de type « version » permettant les comparaisons supérieur et inférieur.

Les Product Tours fonctionnent-ils sur mobile ?

Product Tours vous permettent de créer des expériences guidées dans l'application pour vos clients, afin de favoriser une meilleure adoption.

Product Tours fonctionne uniquement sur desktop. Il ne fonctionne pas actuellement sur les appareils mobiles (y compris les tablettes) dans le navigateur ou dans les applications mobiles.

Pour une expérience engageante et multi-étapes dans votre application mobile, essayez les Mobile Carousels.

Les Workflows fonctionnent-ils sur mobile ?

Oui, les Workflows fonctionnent sur mobile via les SDK iOS et Android. Certains types d'étapes ne sont pas disponibles sur mobile — pour une liste complète des actions compatibles, consultez la compatibilité des canaux dans l'article sur les Workflows.

Y a-t-il des problèmes de connectivité connus pour les clients au Vietnam ?

Oui, il y en a.

Si vous ou vos clients situés au Vietnam rencontrez des problèmes de connectivité avec le domain intercom.com dans nos SDK mobiles, vous pouvez remplacer le nom de domain par défaut en suivant ces étapes :

Android

Ajoutez les meta-data suivantes dans le AndroidManifest.xml de votre application :

<meta-data
android:name="io.intercom.android.sdk.host"
android:value=".intercom-messenger.com" />

iOS

Ajoutez cet attribut dans votre Info.plist :

Key: IntercomCustomURL
Type: String
Value: intercom-messenger.com

Avec ce changement, toutes les requêtes API passeront par intercom-messenger.com au lieu de mobile-messenger.intercom.com.

Cela est pris en charge sur Android SDK 9.1.2+ et iOS SDK 13+.

Comment les notifications push sont-elles envoyées depuis Intercom ?

Bien qu'il existe des différences dans la gestion des push entre Apple et Android, les principes sont les mêmes, illustrés ci-dessous.

Demande de push device token : Lorsqu'une application souhaite utiliser les notifications push et qu'un utilisateur accepte la boîte de dialogue des permissions, une demande est envoyée au service push concerné pour obtenir un push device token. Ce token est « l'adresse », permettant au service push de délivrer une notification push à un appareil spécifique lorsqu'elle est demandée (similaire à une adresse email).
Push device token envoyé : Si la demande est valide, le service push renverra un token valide à l'appareil.
Push device token transmis à Intercom Un token doit être envoyé depuis l'appareil vers un autre service pour être utilisé pour le push. Il peut être envoyé au serveur propre au développeur de l'application, à Intercom, à un tiers, ou à tous ces destinataires. Lorsque ce token est reçu par Intercom, nous l'attachons à l'enregistrement utilisateur.
Package push envoyé d'Intercom à Apple/Google Lorsqu'une notification push doit être envoyée, les informations suivantes doivent être transmises aux serveurs push Apple/Google :
1. Jeton d'appareil
2. Détails de la notification (par ex. logo, titre, corps)
3. Détails d'authentification (ce qui nous permet d'envoyer des push au nom de l'application : c'est là que les certificats Apple iOS et les clés Google Android GCM/FCM interviennent et doivent être mis à jour dans le tableau de bord des paramètres Intercom)
Notification push envoyée à l'appareil
1. Si Intercom s'authentifie auprès du service push pour un jeton donné, le push sera envoyé à l'appareil
2. Les services push utilisent la Qualité de Service (QOS)

Comment personnaliser l'icône push sur iOS ?

Les icônes de notification push sont configurables dans Xcode via Assets > AppIcon

Utilisation des SDK mobiles Intercom

Pouvez-vous initialiser / changer plusieurs app_ids dynamiquement ?

Il n'est actuellement pas possible de changer entre plusieurs ids sur Android. Intercom.registerForLaterInitialisation(this) permet seulement une initialisation ultérieure, mais n'est pas destiné à changer les app ids.

Cela fonctionnera cependant sur iOS.

Les SDK mobiles Android/iOS conservent-ils les données de session lors de la désinstallation et réinstallation de l'application ?

Non, ils ne le font pas.

Pour iOS : les applications sont en sandbox, donc la nouvelle installation n'aura pas connaissance d'une installation précédente.
Pour Android : toutes les données seront supprimées lors de la désinstallation.

Si une application est mise à jour, par exemple via App/Play Store ou en mode développement, les données de session seront conservées.

Comment Intercom stocke-t-il les données de session sur l'appareil mobile d'une application utilisant notre SDK ?

Nous stockons un fichier identity.icm qui contient un UserId anonyme pour les utilisateurs non identifiés. Pour les utilisateurs identifiés, nous stockons leur email (s'ils en ont fourni un), leur userid et intercom id. Nous utilisons cela pour éviter de réenregistrer un utilisateur déjà enregistré. En ce qui concerne une session et la création d'une nouvelle, cela est déterminé par l'intervalle de temps depuis la dernière session. La valeur par défaut est de 20 secondes. Nous ne stockons rien sur le disque pour suivre cela.

Le SDK Android peut-il être installé sur une application qui n'a pas Google Play Services, c'est-à-dire que l'application est installée via Huawei App Gallery au lieu de Google Play Store ?

Non, Google Play Services sont requis pour notre SDK Android.

Où puis-je trouver ma clé Mobile API ?

Vos clés Mobile API se trouvent en survolant la photo de profil de votre avatar en bas à gauche de l'écran lorsque vous êtes connecté à Intercom, puis en choisissant Paramètres > Installation > iOS / Android :

Aussi, si vous n'avez pas encore consulté nos guides d'installation pour iOS, Android, et/ou Cordova, React Native, nous vous recommandons de les lire ! 😊

Puis-je importer des device tokens dans Intercom ?

Non, les device tokens ne peuvent pas être importés dans Intercom.

Comment gérer les sessions utilisateur et l'authentification avec le SDK Android Intercom, et quelles sont les meilleures pratiques pour gérer l'état utilisateur ?

Le SDK Android Intercom gère les sessions utilisateur en interne. Une fois qu'un utilisateur est connecté via Intercom.loginIdentifiedUser(), la session est conservée, et il n'est pas nécessaire de réauthentifier l'utilisateur à chaque démarrage de l'application. Le SDK met en cache l'état de connexion localement et le maintient jusqu'à ce que vous appeliez explicitement Intercom.logout().

Pour garder la logique de votre application synchronisée avec Intercom, assurez-vous de connecter l'utilisateur à Intercom en même temps que dans votre application, et appelez Intercom.logout() lorsqu'il se déconnecte. Cela maintient l'état d'authentification aligné entre votre système et Intercom.

Vous pouvez éventuellement stocker les données utilisateur (par ex. ID, email) dans votre application pour aider à gérer l'état de session actuel, mais Intercom ne vous oblige pas à re-stocker ou ré-identifier l'utilisateur sauf si l'application est réinstallée ou que l'utilisateur se déconnecte explicitement.

Pourquoi le bouton « retour » renvoie-t-il l'utilisateur à l'écran d'accueil lorsqu'il sélectionne une notification push depuis sa barre de notification ?

L'activité de lancement de votre application n'est pas ajoutée à la pile de retour, donc en sélectionnant le bouton retour après avoir sélectionné une notification d'un message Intercom, le client revient à l'écran d'accueil au lieu de l'écran de l'application qui a lancé le Messenger.

Pourquoi les utilisateurs finaux ne peuvent-ils pas télécharger d'images sur le SDK Mobile Android ?

Si un utilisateur final ne peut pas télécharger d'images sur le SDK mobile, c'est généralement un problème d'autorisations pour accéder à la bibliothèque de photos de l'appareil. Lorsque le SDK tente d'ouvrir le sélecteur, iOS/Android indique que l'accès a été refusé, donc les téléchargements ne peuvent pas continuer.

Les versions récentes d'Android demandent la permission lors de la sélection de fonctionnalités supplémentaires comme l'accès aux fichiers / images.

Si elle est refusée, la demande peut réapparaître, sinon les clients devront vérifier manuellement les autorisations de leur application pour l'activer.

Aucune autorisation de stockage supplémentaire n'est requise pour les pièces jointes d'images sur Android 10 et versions ultérieures. Le SDK utilise le sélecteur de photos système et les API de stockage limité, qui gèrent l'accès sans nécessiter d'autorisations explicites. Vérifiez que votre application ne refuse pas explicitement l'accès à la bibliothèque de photos dans sa gestion des autorisations.