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

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

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

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é

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

• 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

• 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

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

3.5.4. Configuration du site Web

• Cliquez sur Add Website

• 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”

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