1. En amont de l’implémentation

• Veillez également à prendre connaissance avec votre équipe de développeur de la documentation technique du SDK V2 en amont de vos échanges : https://developers.iadvize.com/documentation/mobile-sdk
• Ainsi que de l’ensemble des articles SDK V2 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 12
• Android : minimum API 21

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 V2.

 

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 : Engagement > Paramètres > sélection du canal "App mobile"  

iOS

Sur iOS, vous devrez fournir un certificat et une paire de clés privées. En partant d'un fichier .p12, vous pouvez exécuter cette commande en terminal : openssl pkcs12 -in AppProductionPushCertificate.p12 -out Cert.pem -nodes -clcerts -legacy Ensuite vous pouvez exécuter : cat Cert.pem Copier/coller le certificat et la clé privée (y compris leurs séparateurs -----BEGIN----- / -----END-----) dans le formulaire tel qu'imprimé dans le terminal.

 

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