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.
- 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
- Cliquez sur Installer et suivez les 3 étapes
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.23
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.
- 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
- Cliquez sur Gérer les attributions
- Cliquez sur Ajouter des attributions
- Cochez les cases des utilisateurs sélectionnés et cliquez sur Attribuer
- 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).
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
- 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.
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.
- 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
- Changez l'option Utilisateurs autorisés en Les utilisateurs approuvés par l'administrateur sont pré-autorisés et cliquez sur Enregistrer
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.
- Cochez les profils à accorder (Utilisateur Standard et Administrateur système) puis cliquez sur Enregistrer.
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
3.6. Relier vos profils d'utilisateur iAdvize et Salesforce
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
3.7. Utilisez la barre d'outils (utility bar) pour vous concentrer sur le bon client
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.
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
- Paramètres de l'application -> Éléments utilitaires -> Ajoutez “chat iAdvize”
ℹ️ Les résolutions d'écran optimales à appliquer sont disponibles dans cet article. |
3.8. Utilisez les types d'enregistrement
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é.