Installer le chat iAdvize sur votre app mobile - Mobile SDK V2

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

1. En amont de l’implémentation

  • Avant de commencer l'implémentation de votre côté, assurez-vous auprès de votre CSM que la fonctionnalité Mobile SDK V2 soit activée pour votre site
  • 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

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 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 Messenger dans votre application mobile, vous devez configurer certaines informations relatives aux notifications push sur le site d'administration d'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

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

Pour Android, vous devrez fournir la clé du serveur Firebase Cloud Messaging (FCM). Depuis votre console FCM cliquez sur le bouton Paramètres (A droite de Vue d'ensemble du projet) Puis Paramètres de Projet :
 

⚠️ 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 Messenger dans vos applications. N'oubliez pas de lui fournir :