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 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 > 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 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 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. Stylisez-le avec votre logo, et une couleur ou image d'arrière-plan 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 espaces Tickets et/ou 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.

Personnaliser 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 uniquement en haut de l'espace Home. 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, il y a quelques changements d'API 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 sur l'espace Home.

fun presentContent(content: IntercomContent)

Présenter le contenu Intercom. Les types de contenu valides sont Article, Carrousel, Collections du 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, il y a quelques changements d'API 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 sur 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 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 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 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 :

  • 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 liens externes ne s'afficheront pas dans l'espace Home.

Nouveau SDK mobile 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 :

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

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

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