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

Rendez-vous ensuite dans la section “Engagement” > Stratégies d’engagement

• Ensuite créez votre stratégie 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 : Vous pouvez copier cet identifiant dans votre presse-papiers en cliquant sur le carré noir à sa droite.

 
 

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 

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 Application mobile Android, cliquez sur Ajouter un fichier de clé privée (ou Remplacer le fichier de clé privée), puis déposez le fichier JSON téléchargé à l'étape précédente dans la zone Glissez votre fichier de clé privée ici. Pensez à cliquer sur Enregistrer. Pour mettre à jour le fichier 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équate 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 Promoter Score) et leur donner la possibilité de laisser un commentaire libre en fin de conversation. 

Rendez-vous dans l’admin dans la section Paramètres > Paramètres avancés > 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