Guide d'Implémentation de l'App Salesforce (Lightning)

Prérequis

Si vous souhaitez utiliser les composants Lightning d'iAdvize, les conditions suivantes doivent être remplies avant l'installation du package :

  • L'expérience Lightning doit avoir été activée dans l'organisation cible
  • Vous devez vous connecter à l'environnement Salesforce avec un compte d'administrateur système pour installer le package
  • Le domaine de l'organisation doit être validé par l'enregistrement d'un nom de domaine dans l'écran de configuration de Mon domaine.
Capture_d_e_cran_2022-05-31_a__13.46.48.png
  • Vous devez utiliser une application lightning de type "console" pour pouvoir bénéficier de l'ensemble des fonctionnalités. Si ce n'est pas le cas une erreur apparaitra : 
 

1. Installer l'application Salesforce sur la plateforme iAdvize

La première étape consiste à installer l'application Salesforce sur votre compte iAdvize :

  • Allez dans la plateforme d'administration d'iAdvize > Apps
  • Sélectionnez Salesforce, cliquez sur Découvrir

Capture_d_e_cran_2022-05-31_a__14.13.39.png

 
  • Cliquez sur Installer et suivez les 3 étapes

Capture_d_e_cran_2022-05-31_a__14.43.11.png

 

2. Installation du package iAdvize sur Salesforce

2.1. Obtenez le package iAdvize

Afin de déployer votre package iAdvize sur un environnement cible, vous devez accéder à l'assistant d'installation du package.

La version actuelle du package est 2.17


Pour les environnements de production :

Cliquez pour installer le package sur un environnement de production

https://login.salesforce.com/packaging/installPackage.apexp?p0=04t1n000002NZyZ

Pour les environnements sandbox :

Cliquez pour installer le package sur un environnement sandbox

https://test.salesforce.com/packaging/installPackage.apexp?p0=04t1n000002NZyZ

⚠️ Comme nous sommes en train de soumettre à nouveau notre application sur le Salesforce App Exchange pour valider l'examen de sécurité, il est possible que le message d'avertissement suivant s'affiche lors de l'installation du package :

mceclip0.png

Ne vous inquiétez pas, le package que vous installez provient d'iAdvize et il est développé par un partenaire certifié Salesforce qui respecte les règles de révision de la sécurité.

 

2.2. Installez le package iAdvize

  • Choisissez l'option Install for Admins Only et cliquez sur Install
 
  • Cochez Yes, grant access to these third-party web sites afin d'autoriser les communications avec des applications tierces et cliquez sur Continue
 
  • Attendez que l'installation soit terminée

Si vous voyez l'écran ci-dessous, cliquez sur Done pour terminer le processus d'installation. Parfois, l'application prend du temps à s'installer, vous recevrez un e-mail lorsque l'installation sera terminée.

 

 

3. Étapes de configuration sur Salesforce

3.1. Attribuer les autorisations aux utilisateurs finaux

Des autorisations doivent être définies pour accéder aux fonctionnalités du pack iAdvize. Deux autorisations* sont fournies avec le package iAdvize :

  • iAdvize - Administrator : cette autorisation donne accès à l'ensemble des fonctionnalités de l'application iAdvize, y compris l'onglet Configuration.
  • iAdvize - User : cette autorisation donne accès à l'ensemble des fonctionnalités de l'application iAdvize, à l'exception de l'onglet Configuration. Vous devez accorder cette permission à vos agents.

*Vous avez le choix : soit vous ajoutez ces ensembles d'autorisations aux utilisateurs, soit vous créez des profils avec les mêmes droits que ceux existant dans ces ensembles d'autorisations.

 

Suivez ces étapes pour attribuer les autorisations à vos utilisateurs finaux :
  • Entrez dans le menu de configuration 
  • Allez dans Utilisateurs > Ensembles d'autorisations
  • Filtrez sur la lettre "i" puis cliquez sur iAdvize - Administrator or iAdvize - User - en fonction de l'autorisation à attribuer
Capture_d_e_cran_2022-05-31_a__14.58.53.png

 

  • Cliquez sur Gérer les attributions
Capture_d_e_cran_2022-05-31_a__15.49.30.png

 

  • Cliquez sur Ajouter des attributions
Capture_d_e_cran_2022-05-31_a__15.51.01.png

 

  • Cochez les cases des utilisateurs sélectionnés et cliquez sur Attribuer

Capture_d_e_cran_2022-05-31_a__15.54.58.png

  • Puis cliquez sur Terminé

 

3.2. Définir la mise en page de la page Utilisateur

Le paramétrage de la mise en page utilisateur permet d'ajouter les champs : iAdvize sync,

SSO Token, Group ID, Operator ID, Sync date, Sync status, Sync error, à vos pages utilisateurs. Ces champs vont permettre la synchronisation entre vos utilisateurs Salesforce et iAdvize.

  • Entrez dans le menu de Configuration
  • Allez dans Gestionnaire d'objet > Utilisateur > Présentations de page utilisateur

Une mise en page utilisateur iAdvize personnalisée est maintenant disponible. Vous pouvez soit utiliser cette mise en page (option 1), soit choisir de mettre à jour votre propre mise en page utilisateur (option 2).

Capture_d_e_cran_2022-06-01_a__11.23.39.png

 
Option 1 : Définir la mise en page utilisateur d'iAdvize par défaut

  • Cliquez sur Attribution de présentation de page
  • Puis cliquez sur Modifier l'attribution

 

 

Capture_d_e_cran_2022-06-01_a__11.29.54.png

  • Sélectionnez les profils que vous souhaitez modifier, puis dans le menu déroulant sélectionnez iAdvize User Layout et cliquez sur le bouton Enregistrer.

Capture_d_e_cran_2022-06-01_a__11.31.50.png

 

Option 2 : personnaliser une mise en page utilisateur existante

  • Sur la ligne de la mise en page à personnaliser, cliquez sur la flèche en bout de ligne puis sur Modifier.
  • Faites glisser et déposez l'ensemble des champs iAdvize : iAdvize sync, SSO Token, Group ID, Operator ID, Sync date, Sync status, Sync error.
  • Puis cliquez sur Enregistrer

 

3.3. Personnalisez la mise en page de vos objets Salesforce : Contact, Compte, Lead, Objet personnalisé, Case

Vous pouvez ajouter les objets Visitor ou Conversation d'iAdvize dans vos objets Contact, Compte, Lead ou tout autre objet personnalisé.

Pour ajouter ces champs, vous pouvez soit choisir d'utiliser les mises en page d'iAdvize qui ont été mises à disposition lors du téléchargement du package iAdvize, soit personnaliser vos propres mises en page avec les objets iAdvize : Visitor et Conversation.

Pour plus d'informations sur la façon de procéder, veuillez consulter cet article.

 

3.4. Donner accès aux apps connectées "iAdvize_canvas_prd" et "rest_api" aux données de votre organisation Salesforce

Cette étape permet à l'application iAdvize d'accéder aux données de votre organisation Salesforce, et elle permet à vos utilisateurs d'accéder à l'application iAdvize. Vous devez donner des autorisations à la fois à l'application iAdvize_canvas_prd et à l'application rest_api.

 

⚠️L'accès aux deux applications doit être ouvert

  • Entrez dans le menu Configuration
  • Allez dans Applications > Applications connectées > Gérer les applications connectées

 

3.4.1. Autoriser les apps à accéder aux données de votre organisation Salesforce

  • Cliquez sur Modifier des lignes iAdvize_canvas_prd et rest_api 
Capture_d_e_cran_2022-06-01_a__11.41.24.png

 

  • Changez l'option Utilisateurs autorisés en Les utilisateurs approuvés par l'administrateur sont pré-autorisés et cliquez sur Enregistrer
Capture_d_e_cran_2022-06-01_a__11.42.40.png

3.4.2. Autoriser les profils d'utilisateurs à accéder à ces applications

  • Cliquez sur les noms de iAdvize_canvas_prd et rest_api et ajoutez les profils autorisés en cliquant sur le bouton Gérer les profils.

 

Capture_d_e_cran_2022-06-01_a__11.45.00.png
 
  • Cochez les profils à accorder (Utilisateur Standard et Administrateur système) puis cliquez sur Enregistrer.
Capture_d_e_cran_2022-06-01_a__11.46.48.png

 

3.5. Configuration du connecteur iAdvize

Cette étape permet d'établir la communication entre iAdvize et votre organisation Salesforce.

  • Connectez-vous à votre environnement avec un utilisateur disposant de la permission iAdvize - Administration.
  • Cliquez sur le 'Lanceur d'applications' et choisissez iAdvize.
  • Cliquez ensuite sur l'onglet "Setup", voir la capture d'écran ci-dessous :

 

3.5.1. Configuration du connecteur

 

⚠️ Quel que soit l'environnement sur lequel vous installez l'application iAdvize, dans cette section vous devez choisir Production car cela signifie que l'application iAdvize est en production.

 
  • Sélectionnez Production dans le menu déroulant et cliquez sur Edit.

3.5.2. Authorization Salesforce

Vous devez autoriser la mise en œuvre du paquet dans Salesforce.

  • Cliquez sur Authorize
  • Le statut de la demande est indiqué par une pop-up, cliquez sur OK pour finaliser l'autorisation

Authorization not done or in error

Authorization done

 

3.5.3 Configuration API

Dans cette section, vous entrez les paramètres de votre compte iAdvize :

 

  

  • Cliquez sur Edit
  • Remplissez chaque section avec vos clés API envoyées par iAdvize et cliquez sur Save
 

ℹ️ La clé API d'iAdvize est la clé API Rest et la clé API File d'iAdvize est la clé API GraphQL.

 

3.5.4. Configuration du site Web

  • Cliquez sur Add Website

 

ℹ️. un site web (=SID = projet dans la plateforme iAdvize) ne peut être ajouté qu'une seule fois : cela signifie que si vous avez effectué un test en utilisant un SID dans votre environnement SF Sandbox, vous devrez supprimer ce site web de la configuration afin de pouvoir l'utiliser dans votre environnement SF de production.

 

  • Sélectionnez le site web de votre choix et cliquez sur Save
 

💡Pour personnaliser davantage...

Pour personnaliser davantage l'application en fonction des besoins de votre entreprise : lier les champs d'iAdvize à ceux de Salesforce et ajouter plus d'informations dans le formulaire de fermeture du chat de l'agent, lisez cet article.

 

Le paramétrage est presque terminé ! Avant de pouvoir commencer à utiliser l'application iAdvize dans salesforce, il vous suffit de lier vos profils utilisateurs Salesforce à iAdvize.

Il y a deux possibilités : 

  • vos utilisateurs ont à la fois un profil utilisateur dans iAdvize et dans Salesforce : vous pouvez relier manuellement leurs profils ensemble
  • vos utilisateurs Salesforce n'ont pas de profils utilisateurs iAdvize : vous pouvez créer automatiquement des profils utilisateurs iAdvize basés sur ceux de vos utilisateurs Salesforce

 

Lorsque l'on utilise la barre d'outils (c'est-à-dire iAdvize dans Salesforce) avec plusieurs conversations en même temps, l'écran de derrière suit : si l'agent passe d'une conversation A à une conversation B dans la barre d'outils, nous gardons le focus sur la bonne fiche client par rapport à la bonne conversation.

 

Capture_d_e_cran_2022-05-31_a__11.25.30.png


Pour adapter la taille de l'iframe, vous pouvez le faire en allant dans la section Configuration puis dans les outils de la plateforme

  • Gestionnaire d'applications -> trouver l'app "iAdvize - Utility bar" -> cliquez sur Modifier 

Capture_d_e_cran_2022-06-01_a__14.48.53.png

 

  • Paramètres de l'application -> Éléments utilitaires -> Ajoutez “chat iAdvize”

 

Capture_d_e_cran_2022-06-01_a__14.51.06.png

 

 

ℹ️ Les résolutions d'écran optimales à appliquer sont disponibles dans cet article.

 

Si votre configuration dans Salesforce enregistre plusieurs types d'enregistrement, lorsque vous cliquez sur "open a case", une petite fenêtre pop-up apparaît dans laquelle vous devez sélectionner l'un des types d'enregistrement existants. S'il n'y a pas de type d'enregistrement, le type d'enregistrement par défaut sera sélectionné.

 

⚠️L'utilisation des types d'enregistrement fonctionne uniquement avec un case avec un layout par défaut. Si vous souhaitez utiliser un layout custom pour vos cases, vous ne pourrez pas utiliser les types d'enregistrement.