Passer au contenu principal

Utilisez le Messenger dans votre application mobile

Comment installer et utiliser la prochaine génération de Messenger sur mobile.

Écrit par Beth-Ann Sher

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 le panneau de paramètres Intercom. 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 le Messenger pour mobile

Vous pouvez personnaliser et prévisualiser votre Messenger sur mobile depuis Paramètres > Canaux > Messenger > SDK mobiles 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 SDK mobiles 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 du Mobile Messenger prennent également en charge le multi-brand Help Center, 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 répondre aux besoins de votre entreprise. Personnalisez-le avec votre logo et une couleur ou une image de fond pour l'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 > SDK mobiles > 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 Home en ajoutant/supprimant les Tickets et/ou les espaces Help sous Messenger > SDK mobiles > Contenu > Espaces. (Les Messages ne peuvent pas être désactivés).

Les clients pourront démarrer des conversations avec vous depuis les espaces Home 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éfinissez votre message de bienvenue

Décidez comment vous souhaitez accueillir les clients sur l'espace Home du Messenger en définissant votre message de bienvenue. Votre message de bienvenue peut être configuré pour toutes vos langues prises en charge.

Personnalisez Home avec des applications

Depuis Messenger > SDK mobiles > Contenu > Personnaliser Home avec des applications, vous pouvez ajouter des applications supplémentaires à l'espace Home, 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.

  • SDK mobiles - Les espaces apparaissent comme des boutons en haut de l'espace Home uniquement. 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.

  • SDK mobiles - Les clients peuvent revenir à l'espace Home depuis n'importe quel autre espace en utilisant le bouton « retour » (ou le bouton « retour » système sur Android).

Notifications

  • Web - Les onglets d'espace afficheront des badges de notification s'ils contiennent du nouveau contenu (par exemple un nouveau message dans une conversation).

  • SDK mobiles - Les boutons d'espace 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. (Home, Messages, Help Center). Par défaut, l'espace Home.

fun present()

Ouvrir Intercom - par défaut l'espace Home.

fun presentContent(content: IntercomContent)

Présenter le contenu Intercom. Les types de contenu valides sont Article, Carrousel, Collections Help Center.

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. (Home, Messages, Help Center).

func present()
+ (void)presentIntercom

Ouvrir Intercom - par défaut l'espace Home.

func presentContent(_ content: Content)
+ (void)presentContent:(IntercomContent *)content

Présenter le contenu Intercom. Les types de contenu valides sont Article, Carrousel, Collections 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 les SDK mobiles ne soient pas synchronisés. Par exemple, vous pouvez avoir le nouveau Messenger activé dans vos paramètres mais ne pas encore avoir mis à jour les SDK mobiles dans votre application. Voici comment cela fonctionnera :

Paramètres Messenger précédents

(Vous n'avez pas opté.)

Nouveaux paramètres Messenger

(Vous avez opté.)

SDK mobile Messenger précédent

(moins que v14.0.1)

Fonctionne comme avant. Tous les paramètres Messenger précédents sont respectés.

Les nouveaux paramètres Messenger seront appliqués de manière cohérente pour rendre l'expérience Messenger précédente dans l'application mobile.

Certaines des nouvelles fonctionnalités Messenger ne fonctionneront pas dans le SDK mobile Messenger précédent :

  • Au lieu d'afficher un arrière-plan d'en-tête en dégradé, il affichera une couleur unie en utilisant votre couleur de secours prédéfinie.

  • Au lieu d'afficher une image d'arrière-plan d'en-tête, il affichera une couleur unie en utilisant votre couleur de secours prédéfinie.

  • Les cartes de lien externe ne s'afficheront pas dans l'espace Home.

Nouveau SDK mobile Messenger

(v14.0.1 et supérieur)

Les paramètres Messenger précédents seront appliqués de manière cohérente pour rendre la nouvelle expérience Messenger dans l'application mobile.

Par exemple :

  • Il utilisera par défaut un en-tête de couleur unie, avec un style coupé (pas de fondu).

Tous les nouveaux paramètres Messenger sont respectés.

Avez-vous trouvé la réponse à votre question ?