Le Messenger nécessite les derniers SDK mobiles pour offrir aux clients la meilleure expérience sur mobile. Cet article explique comment personnaliser le Messenger pour mobile et quelles fonctionnalités sont prises en charge sur les applications iOS et Android.
Note : Pour utiliser le dernier Mobile Messenger, vous devez utiliser les derniers SDK mobiles. Les détails d'installation se trouvent dans nos Developer Docs :
Vous devez vous assurer que le Mobile Messenger est activé depuis Paramètres > Canaux > Messenger > Installer. Lorsqu'il est désactivé, toutes les requêtes vers Intercom échoueront et une erreur liée à la méthode loginUnidentifiedUser ou loginUser peut être renvoyée.
Personnaliser Messenger pour mobile
Vous pouvez personnaliser et prévisualiser votre Messenger sur mobile depuis Paramètres > Canaux > Messenger > Mobile SDKs puis sélectionner la prévisualisation de l'appareil pour iOS ou Android.
Disponible dans les applications mobiles
Lorsque les users accèdent au Messenger sur votre application iOS ou Android, il se lance comme une feuille native en bas de l'écran. Cela permet au Messenger d'avoir l'apparence et la sensation d'être intégré de manière organique, offrant un parcours client cohérent et fluide. L'utilisateur peut toujours voir exactement où il se trouve dans votre application puis décider comment il souhaite interagir avec vous dans le Messenger.
Configurer les styles du Messenger
Les Mobile SDKs du Messenger peuvent prendre en charge plusieurs marques que vous pourriez avoir. Sélectionnez ou ajoutez un nouveau style de Messenger depuis l'onglet Styles.
Les styles Mobile Messenger prennent également en charge le Help Center multi-marques, assurez-vous donc d'avoir connecté le bon Help Center à la marque que vous utilisez pour ce style de Messenger.
Concevez chaque style de Messenger pour correspondre aux besoins de votre entreprise. Stylisez-le avec votre logo et une couleur ou image de fond d'en-tête.
Lancer directement dans la Conversation
Décidez ensuite si vous souhaitez que le Messenger s'ouvre directement dans l'espace Messages (pour que les clients démarrent une nouvelle conversation ou consultent les messages précédents) en activant « Lancer directement dans une Conversation » dans Messenger > Mobile SDKs > Contenu.
Ce nouveau paramètre garantit à vos clients un accès plus rapide au support, supprimant les étapes supplémentaires pour démarrer un nouveau chat avec votre équipe.
Configurer les espaces du Messenger
Configurez maintenant les boutons avec lesquels les clients peuvent interagir dans l'espace Accueil en ajoutant/supprimant les espaces Tickets et/ou Help sous Messenger > Mobile SDKs > Contenu > Espaces. (Les Messages ne peuvent pas être désactivés).
Les clients pourront démarrer des conversations avec vous depuis les espaces Accueil et Messages s'ils correspondent à vos règles d'audience.
Ils peuvent également soumettre des tickets et suivre leur progression depuis l'espace dédié Tickets (si vous l'avez activé).
Définir votre message de bienvenue
Décidez comment vous souhaitez accueillir les clients sur l'espace Accueil du Messenger en configurant votre message de bienvenue. Votre message de bienvenue peut être configuré pour toutes vos langues prises en charge.
Personnaliser l'accueil avec des applications
Depuis Messenger > Mobile SDKs > Contenu > Personnaliser l'accueil avec des applications, vous pouvez ajouter des applications supplémentaires à l'espace Accueil, telles que Send us a message ou Search for help, ainsi que d'autres applications que vous avez installées sur votre espace de travail.
Différences entre les SDK web et mobiles
Espaces
Web - Les espaces apparaissent comme des onglets en bas du Messenger. Cette barre d'onglets est toujours visible depuis le niveau supérieur de chaque espace.
Mobile SDKs - Les espaces apparaissent comme des boutons uniquement en haut de l'espace Accueil. Ils n'apparaissent pas dans les autres espaces.
Navigation
Web - La barre d'onglets disparaît lorsque les clients naviguent dans le contenu d'un espace (par exemple un article, une conversation ou un ticket). Un bouton « retour » apparaît en haut du Messenger.
Mobile SDKs - Les clients peuvent revenir à l'espace Accueil depuis n'importe quel autre espace en utilisant le bouton « retour » (ou le bouton système « retour » sur Android).
Notifications
Web - Les onglets d'espaces afficheront des badges de notification s'ils contiennent du nouveau contenu (par exemple un nouveau message dans une conversation).
Mobile SDKs - Les boutons d'espaces afficheront des badges de notification s'ils contiennent du nouveau contenu (par exemple un nouveau message dans une conversation ou une mise à jour du statut d'un ticket).
Messages dans les SDK mobiles
Dans l'espace Messages, il y a un bouton dans l'en-tête sur iOS pour démarrer une nouvelle conversation. Sur Android, il y a un Floating Action Button à la place.
Android SDK
Comme il s'agit d'une mise à jour majeure, quelques changements d'API sont listés ci-dessous :
Méthode - Kotlin | Description |
fun present(space: IntercomSpace) | Ouvrir un espace spécifique dans Intercom. (Accueil, Messages, Help Center). Par défaut, l'espace Accueil. Retourne void — n'accepte pas de callback. |
fun present() | Ouvrir Intercom - par défaut sur l'espace Accueil. Retourne void — n'accepte pas de callback. |
fun presentContent(content: IntercomContent) | Présenter le contenu Intercom. Les types de contenu valides sont Article, Carrousel, Collections du Help Center. |
Note : Aucune des méthodes dans ce tableau n'accepte de paramètre callback ou listener. present(), present(space) et presentContent(content) retournent tous void — utilisez la note Important ci-dessous pour la seule chose qui affecte si present() réussit (l'appeler uniquement après que le onSuccess de loginIdentifiedUser soit déclenché).
Important : N'appelez present() ou present(space: IntercomSpace) qu'après que le callback onSuccess de loginIdentifiedUser (ou loginUnidentifiedUser) ait été déclenché. Appeler l'une ou l'autre méthode immédiatement après avoir initié la connexion — avant que l'appel asynchrone ne soit terminé — provoque un échec silencieux avec « Something went wrong », car le SDK n'est pas encore prêt à s'afficher.
Ces méthodes peuvent toujours être utilisées, mais seront supprimées dans une future version.
Méthode - Kotlin |
fun displayMessenger() |
fun displayHelpCenter() |
fun displayHelpCenterCollections(collectionIds: List<String>) |
fun displayArticle(articleId: String) |
fun displayCarousel(carouselId: String) |
fun displaySurvey(surveyId: String) |
iOS SDK
Comme il s'agit d'une mise à jour majeure, quelques changements d'API sont listés ci-dessous :
Méthode - Swift | Méthode - Obj-C | Description |
func present(_ space:Space) | + (void)presentIntercom:(Space)space | Ouvrir un espace spécifique dans Intercom. (Accueil, Messages, Help Center). |
func present() | + (void)presentIntercom | Ouvrir Intercom - par défaut sur l'espace Accueil. |
func presentContent(_ content: Content) | + (void)presentContent:(IntercomContent *)content | Présenter le contenu Intercom. Les types de contenu valides sont Article, Carrousel, Collections du Help Center. |
Les méthodes suivantes ont également été complètement dépréciées :
Méthode - Swift | Méthode - Obj-C |
func presentMessenger() | + (void)presentMessenger |
func presentHelpCenter() | + (void)presentHelpCenter |
func presentHelpCenterCollections(_ collectionIds: [String]) | + (void)presentHelpCenterCollections:(nonnull NSArray<NSString *> *)collectionIds |
func presentArticle(_ articleId: String) | + (void)presentArticle:(nonnull NSString *)articleId |
func presentCarousel(_ carouselId: String) | + (void)presentCarousel:(nonnull NSString *)carouselId |
func presentSurvey(_ surveyId: String) | + (void)presentSurvey:(nonnull NSString *)surveyId |
Compatibilité ascendante et descendante pour les SDK mobiles
Il est possible que votre espace de travail et vos SDK mobiles ne soient pas synchronisés. Par exemple, vous pouvez avoir activé le nouveau Messenger dans vos paramètres mais ne pas encore avoir mis à jour les SDK mobiles dans votre application. Voici comment cela fonctionnera :
| Paramètres du Messenger précédent (Vous n'avez pas opté.) | Nouveaux paramètres du Messenger (Vous avez opté.) |
SDK mobile du Messenger précédent (moins que v14.0.1) | Fonctionne comme avant. Tous les paramètres du Messenger précédent sont respectés. | Les nouveaux paramètres du Messenger seront appliqués de manière cohérente pour rendre l'expérience du Messenger précédent dans l'application mobile.
Certaines des nouvelles fonctionnalités du Messenger ne fonctionneront pas dans le SDK mobile du Messenger précédent :
|
Nouveau SDK mobile du Messenger (v14.0.1 et supérieur) | Les paramètres du Messenger précédent seront appliqués de manière cohérente pour rendre la nouvelle expérience Messenger dans l'application mobile.
Par exemple :
| Tous les nouveaux paramètres du Messenger sont respectés. |