Vous souhaitez installer le chat iAdvize sur votre app mobile ? Cet article vous guidera pas à pas dans l'implémentation du mobile SDK.

1. En amont de l’implémentation

Veillez également à prendre connaissance avec votre équipe de développeur de la documentation technique du SDK en amont de vos échanges : https://developers.iadvize.com/documentation/mobile-sdk
Ainsi que de l’ensemble des articles SDK présents ici dans cette base de connaissance
Nous sommes à votre disposition en cas de questions pendant toute cette phase de préparation.

Une fois ces étapes validées vous pouvez vous lancer dans l’implémentation !

2. Pré-requis

Profil : administrateur et développeur
La version de votre application :
- iOS : minimum iOS 15
- Android : minimum API 24

3. Engagez vos visiteurs depuis votre application

Rendez-vous ensuite dans la section “Engagement” > Campagnes

Ensuite créer votre campagne et règle d’engagement mobile
Nommez-la et choisissez Inbound comme type de stratégie

Sélectionnez App Mobile comme point d'entrée pour engager votre audience

Créez votre règle de ciblage en cliquant sur Ajouter et nommez-la

Le développeur aura ensuite besoin de l’identifiant de la règle de ciblage (encadré en rouge ci-dessous) pour intégrer ces règles d’engagement au sein du SDK.

NB : Il vous Vous pouvez copier cet identifiant dans votre presse-papiers en cliquant sur le carré noir à sa droite.

À partir de la version 2.5, le SDK prend en charge les conversations vidéo. Le processus de création de la règle de ciblage est le même, mais vous devrez également noter pour quel type de canal de conversation la règle sera utilisée (chat ou vidéo), car l'intégrateur en aura besoin pour la déclencher.

Dans le cas d'une règle de ciblage vidéo, vous devrez vous assurer que les répondants dédiés sont configurés pour répondre aux conversations vidéo.

NB : Il vous faudra comme pour le web, distribuer votre conversation vers les bons répondants

4. Activez les notifications push du SDK mobile

Afin de recevoir les notifications relatives aux conversations du SDK iAdvize dans votre application mobile, vous devez fournir les éléments permettant à iAdvize d'envoyer ces notifications push à votre application :
- Android : la Clé Privée Firebase Cloud Messaging (FCM)
- iOS : le Certificat Push (APNs Certificate)

4.1 Android : Génération de la Clé Privée Firebase Cloud Messaging (FCM)

Tout d'abord, ouvrez la console Firebase.

Rendez-vous ensuite dans les paramètres projets puis dans l'onglet Cloud Messaging:

Dans Firebase Cloud Messaging API (V1) cliquez sur le lien Gérer les comptes de service qui redirige vers la console Google Cloud:

Choisissez le compte de service adéquat en cliquant sur le lien:

Enfin, rendez-vous dans l'onglet Clés, puis Ajouter une clé et finalement Créer une clé. Choisissez le type de clé JSON:

Le fichier de clé privée sera automatiquement téléchargé.

4.2 iOS : Génération du Certificat Push (APNs Certificate)

Vous devez fournir à iAdvize un certificat Sandbox & Production.

Si votre app ne dispose pas encore d'un Certificat Push, suivez les instructions de cet article d'Apple expliquant comment obtenir un certificat.

Une fois le certificat généré, téléchargez-le et utilisez le Trousseau d'accès pour l'exporter au format .p12:
1. Ouvrir Trousseau d’Accès.
2. Importer le fichier aps.cer téléchargé.
3. Aller dans la section Mes certificats, trouver le certificat correspondant.
4. Clic droit Exporter et choisir le format .p12.

4.3 Téléverser le fichier de clé privée sur l'administration iAdvize

Rendez-vous à la page suivante : Paramètres > Paramètres avancés > sélection du canal App mobile

Android

Dans la section Android vous devez remplir le champ texte avec le contenu JSON téléchargé à l'étape précédente. Pensez à enregistrer.

Pour mettre à jour le ficher de configuration de l'application Android, suivez ce pas à pas:

Ouvrez la console Firebase
Rendez-vous dans Paramètres Projet
Rendez-vous dans l'onglet Général
Dans la section Application, sélectionnez l'application mobile adéquat
Cliquez sur le bouton google-services.json pour le télécharger

Ce nouveau fichier doit remplacer celui déjà présent dans votre application.

⚠️ Attention, aucune conversation ne pourra être démarrée si aucune API n'est renseignée

5. Activez le questionnaire de satisfaction en fin de conversation

Vous pouvez mesurer la satisfaction de vos clients (CSAT: Customer Satisfaction), leur propension à vous recommander à leur entourage (NPS: Net Promoteur Score) et leur donner la possibilité de laisser un commentaire libre en fin de conversation.

Rendez-vous dans l’admin dans la section Engagement > Paramètres > Chat > Questionnaire de satisfaction et cochez la case “Soumettre le questionnaire de satisfaction à la fin d'une conversation.

Plus d’information sur le fonctionnement de ce questionnaire de satisfaction dans cet article dédié.

6. Trouvez l'identifiant de votre projet

En tant que client d'iAdvize, vous serez affecté à un ou plusieurs projets sur le site d'administration d'iAdvize. Un projet contient des configurations spécifiques pour un site web et/ou votre application mobile. Chaque projet est identifié par un identifiant unique que vous pouvez trouver sur le site d'administration d'iAdvize.

Sélectionnez d'abord votre projet à l'aide de la liste déroulante :

Ensuite, l'identifiant du projet peut être trouvé dans l'URL, encadré en rouge ci-dessous :

Enregistrez cet identifiant de projet, le développeur en aura besoin pour l'intégration du SDK.

7. Commencez à intégrer le SDK mobile dans vos applications.

Une fois ces étapes franchies, le développeur peut commencer à intégrer le SDK d'iAdvize dans vos applications. N'oubliez pas de lui fournir :

l'identifiant du projet
tous les identifiants de règles de ciblage pertinents
le guide d'intégration : https://developers.iadvize.com/documentation/mobile-sdk