> For the complete documentation index, see [llms.txt](https://docs.dydu.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dydu.ai/livechat/connecteur-livechat-salesforce.md). # Connecteur Livechat Salesforce Cette documentation vous guide dans le paramétrage de l'escalade vers le Livechat Salesforce directement depuis votre interface Dydu (BMS). Elle se concentre exclusivement sur les réglages nécessaires côté Dydu pour établir la connexion entre votre chatbot et votre outil de centre de contact. Avant de procéder au paramétrage, vous devez activer le connecteur Salesforce en vous rendant dans **Préférences > Bot**. Une fois cette activation effectuée, vous retrouverez l'interface de configuration du connecteur externe directement dans vos **Paramètres Livechat**.
## Connecteur Salesforce Cette première étape permet d'établir la liaison de base entre le BMS de Dydu et votre environnement Salesforce. Vous devez y renseigner les trois informations fondamentales suivantes (qui sont à récupérer directement depuis votre interface d'administration Salesforce) : * **Adresse du serveur de chat (SCRT)** : L'URL spécifique de votre serveur de chat Salesforce, nécessaire pour le routage des conversations. * **Identifiant de l'organisation** : L'identifiant unique (ID) correspondant à votre environnement Salesforce. * **Nom technique de la configuration** : Le nom de développement (ou API name) de votre configuration Livechat créée au sein de Salesforce.
## Sécurité et authentification Cette deuxième étape permet de sécuriser les échanges entre le chatbot Dydu et les serveurs Salesforce en configurant les éléments d'authentification cryptographiques requis. Vous devrez y renseigner les éléments suivants : * **Identifiant de clé de sécurité (KID)** : L'identifiant de la clé utilisée pour signer les échanges. * **Émetteur du jeton (ISS)** : L'entité (issuer) responsable de l'émission du jeton d'authentification. * **Objet / Utilisateur cible (SUB)** : L'identité de l'utilisateur ou du système cible pour lequel le jeton est émis. Vous devez spécifier ici la variable de contexte correspondante. * **Import de la clé** : Le champ permettant de charger votre clé privée, qui doit impérativement être au format .PEM. * **Import du certificat** : Le champ permettant de charger votre certificat public, qui doit impérativement être au format .CER. * **Mot de passe de la clé** : À renseigner uniquement si la clé importée au format PEM est chiffrée.
## Identifiants de connexion Salesforce Cette troisième étape permet de configurer les identifiants nécessaires pour l'authentification API, ainsi que la gestion de la file d'attente pour le routage des utilisateurs vers vos agents. Vous devez y indiquer : * **Identifiant du client (Client ID)** : L'identifiant de votre application connectée Salesforce. * **Clé secrète (Client Secret)** : La clé secrète associée à votre application Salesforce. * Configuration de la file d'attente : * **Nom de la file d'attente** : Le nom exact de la file d'attente (queue) vers laquelle diriger les utilisateurs, tel qu'il a été défini dans votre environnement Salesforce. * **Capacité maximale de la file d'attente** : Le nombre maximum de personnes autorisées à patienter simultanément dans cette file.
## Variables de contexte vers jetons Salesforce Cette dernière étape n'est pas obligatoire, mais elle s'avère très utile. Elle vous permet d'associer des variables de contexte issues de la conversation avec le bot à des jetons (claims JWT) afin de les manipuler et, si besoin, de les transmettre à Salesforce. L'interface se présente sous la forme d'un tableau interactif dans lequel vous pouvez ajouter autant de lignes que nécessaire. Pour chaque nouvelle entrée, vous devez configurer : * **Nom de la variable (Claim JWT)** : Le nom de la donnée que vous souhaitez intégrer dans le jeton. * **Transmettre au conseiller (transmittorouting)** : Une option permettant de définir si cette variable doit être remontée à l'agent Salesforce. Ces variables étant souvent utilisées du côté de Dydu à des fins purement statistiques, vous pouvez choisir de ne pas les afficher au conseiller lors de l'escalade. **Gestion des variables** : Une fois une variable ajoutée au tableau, vous conservez un contrôle total dessus et avez la possibilité de la modifier ou de la supprimer à tout moment.