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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FfWDaT5WAV10Zic7VmG8D%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-11-10%2013-57-42.png?alt=media&amp;token=8637b156-6159-4bfc-b85e-ff5c937876a4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fyaz4XwnYm3UEPKjz5Shz%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-07-08%2015-12-28.png?alt=media&amp;token=3cf36c9f-00d5-48ed-8d66-ce56f3165f22" alt="" width="563"><figcaption></figcaption></figure>

## Sécurité et authentification

Cette deuxième étape permet de sécuriser les échanges entre le chatbot Dydu et les serveurs Salesforce. Les jetons d'authentification (JWT) envoyés à Salesforce sont signés avec une clé privée générée par Dydu : vous n'avez plus à fournir de clé privée ni de certificat. Vous devez y renseigner les éléments suivants :

* **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.
* **Clé privée (format PEM)** : Le champ permettant de charger la clé privée générée par Dydu, au format .PEM. Ce champ est renseigné par l'équipe Dydu. Le message **Clé privée déjà définie** s'affiche lorsqu'une clé a déjà été chargée.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fv2USPE5FUy6JkQ6L9ekX%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-11-10%2013-57-03.png?alt=media&amp;token=bdd60903-75d3-472e-a9af-583e81cacb79" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
L'identifiant de clé (KID) et l'émetteur du jeton (ISS) ne sont plus à renseigner.
{% endhint %}

**Configuration côté Salesforce** : pour que Salesforce accepte les jetons signés par Dydu, effectuez les étapes suivantes dans votre environnement Salesforce :

1. Récupérez auprès de Dydu la clé publique au format JWK (fichier .json).
2. Ajoutez cette clé publique (JWK) dans la configuration de la vérification des utilisateurs de votre déploiement Messaging.
3. Renseignez « Dydu » comme émetteur (issuer) du jeton.

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fz7Zvu24NouCO6oAXjfvY%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-07-08%2015-16-45.png?alt=media&amp;token=b4bdde9c-ed7a-4b9d-8122-1a51943d93e9" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FjHeTeLmfXYZOffFhr0UO%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-07-08%2015-24-40.png?alt=media&amp;token=4ab231b2-9b27-4a12-849a-b0f05fc24fc5" alt="" width="563"><figcaption></figcaption></figure>

## Vérifier la disponibilité du livechat Salesforce

Avant de proposer une escalade vers Salesforce, vous pouvez vérifier si le livechat est ouvert et si un opérateur est disponible à l'aide des [conditions de contexte](https://docs.dydu.ai/contenus/conditions-de-contexte). Avec le connecteur Salesforce, ces vérifications s'appuient directement sur les informations de votre environnement Salesforce :

* **LiveChatOpen()** : vérifie si le livechat est ouvert selon les horaires d'ouverture (Business Hours) définis dans Salesforce. Les horaires utilisés sont ceux qui portent le même nom que la file d'attente renseignée dans le champ **Nom de la file d'attente**. Les jours fériés (Holidays) définis dans Salesforce sont également pris en compte : le livechat est considéré comme fermé ces jours-là.
* **LiveChatAvailable()** : vérifie uniquement si au moins un opérateur Salesforce est connecté et disponible. Cette condition ne vérifie pas les horaires d'ouverture.

{% hint style="info" %}
Avec le livechat Dydu, la condition **LiveChatAvailable()** vérifie à la fois l'ouverture du livechat et la disponibilité d'un opérateur. Avec le connecteur Salesforce, elle vérifie uniquement la disponibilité d'un opérateur : utilisez **LiveChatOpen()** pour vérifier les horaires.
{% endhint %}

Pour afficher une réponse différente selon que le livechat est fermé ou qu'aucun opérateur n'est disponible :

1. Dirigez-vous sur la page **Contenus > Conditions de contexte** et créez une condition utilisant **LiveChatOpen()** et une condition utilisant **LiveChatAvailable()**.
2. Dans votre connaissance d'escalade (par exemple « Je veux parler à un conseiller »), insérez la condition utilisant **LiveChatOpen()**.
3. Dans la branche d'échec, saisissez la réponse à afficher lorsque le livechat est fermé.

> Exemple : « Notre service est actuellement fermé. Nos conseillers sont disponibles du lundi au vendredi de 9 h à 18 h. »

4. Dans la branche de succès, insérez la condition utilisant **LiveChatAvailable()**.
5. Dans la branche d'échec de cette seconde condition, saisissez la réponse à afficher lorsqu'aucun opérateur n'est disponible.

> Exemple : « Tous nos conseillers sont actuellement occupés, merci de réessayer dans quelques instants. »

6. Dans la branche de succès, éditez la réponse puis cliquez sur **Plus d'options** puis sur **Autres options** et sur **Définir une action GUI**, et sélectionnez **Connexion Livechat**.
7. Cliquez sur **Mettre à jour**.

{% hint style="warning" %}
La vérification des horaires d'ouverture à partir de l'outil externe avec **LiveChatOpen()** est disponible uniquement pour le connecteur Salesforce.
{% endhint %}

## Utiliser la file d'attente Salesforce

Avec le connecteur Salesforce, vous pouvez placer l'utilisateur dans la file d'attente Salesforce même lorsqu'aucun opérateur n'est disponible, tant que cette file n'est pas pleine. Utilisez pour cela la condition de contexte suivante :

* **SpaceLeftInWaitingQueue()** : vérifie uniquement si la file d'attente renseignée dans le champ **Nom de la file d'attente** n'a pas atteint sa **Capacité maximale de la file d'attente**. Cette condition ne vérifie ni les horaires d'ouverture, ni la présence d'un opérateur connecté.

{% hint style="info" %}
Lorsque vous activez le connecteur Salesforce, la condition « Place disponible dans la file d'attente », qui utilise **SpaceLeftInWaitingQueue()**, est créée automatiquement dans **Contenus > Conditions de contexte**.
{% endhint %}

L'action GUI **Connexion Livechat** se comporte alors ainsi :

* si la condition **LiveChatAvailable()** a trouvé un opérateur disponible, l'utilisateur est mis directement en relation avec cet opérateur ;
* sinon, s'il reste de la place dans la file d'attente, l'utilisateur est placé dans la file d'attente Salesforce. Sa conversation est distribuée dès qu'un opérateur est disponible.

Pour placer l'utilisateur en file d'attente lorsqu'aucun opérateur n'est disponible :

1. Dans votre connaissance d'escalade, insérez la condition utilisant **LiveChatAvailable()**.
2. Dans la branche de succès, éditez la réponse puis cliquez sur **Plus d'options** puis sur **Autres options** et sur **Définir une action GUI**, et sélectionnez **Connexion Livechat**.
3. Dans la branche d'échec, insérez la condition « Place disponible dans la file d'attente ».
4. Dans la branche de succès de cette seconde condition, saisissez la réponse à afficher, puis définissez l'action GUI **Connexion Livechat** comme à l'étape 2.

> Exemple : « Tous nos conseillers sont occupés. Vous êtes placé en file d'attente, un conseiller vous répondra dès que possible. »

5. Dans la branche d'échec, saisissez la réponse à afficher lorsque la file d'attente est pleine.

> Exemple : « Notre file d'attente est complète, merci de réessayer dans quelques instants. »

6. Cliquez sur **Mettre à jour**.

{% hint style="warning" %}
La condition **SpaceLeftInWaitingQueue()** est disponible uniquement pour le connecteur Salesforce.
{% endhint %}
