> 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/developpeurs/reference-api/export-des-conversations.md).

# Export des Conversations

Vous pouvez exporter les conversations de votre bot au format XML, CSV ou Excel :

* toutes les conversations entre deux dates ;
* une seule conversation, à partir de son identifiant.

## Envoyer une requête

* **Adresse** : `https://<serveur>/servlet/dialogexport`, en remplaçant `<serveur>` par l'adresse de votre plateforme.
* **Méthode** : `GET` ou `POST`.
* **Authentification** : en-tête `Authorization` (voir [Authentification](https://docs.dydu.ai/developpeurs/reference-api/authentification)). Le compte utilisé doit avoir le droit d'exporter les conversations.

{% hint style="warning" %}
La période exportée est limitée à un mois (32 jours), quel que soit le format. Un même compte ne peut lancer qu'un export à la fois : si un export est déjà en cours, l'API renvoie une erreur « A request is already processing ».
{% endhint %}

## Paramètres

<table><thead><tr><th width="250">Paramètre</th><th width="100">Obligatoire</th><th>Description</th></tr></thead><tbody><tr><td><code>botUUID</code></td><td>Oui</td><td>Identifiant du bot. Il est affiché sur la page <strong>Préférences > Api > Accès aux APIs</strong>.</td></tr><tr><td><code>language</code></td><td>Oui</td><td>Langue des conversations : « fr », « en », « nl »… Le bot doit gérer cette langue.</td></tr><tr><td><code>startingDate</code></td><td>Oui</td><td>Date de début de l'export, au format <code>yyyy-MM-dd</code> ou <code>yyyy-MM-dd HH:mm:ss</code>.</td></tr><tr><td><code>endingDate</code></td><td>Oui</td><td>Date de fin de l'export, au même format.</td></tr><tr><td><code>contextId</code></td><td>Non</td><td>Identifiant d'une conversation, pour n'exporter que cette conversation. Les dates restent obligatoires.</td></tr><tr><td><code>format</code></td><td>Non</td><td>Format de sortie : « Xml » (par défaut), « Csv » ou « Excel ».</td></tr><tr><td><code>exportDialogIds</code></td><td>Non</td><td><code>true</code> pour exporter les identifiants des conversations, <code>false</code> (par défaut) sinon.</td></tr><tr><td><code>onlyLivechat</code></td><td>Non</td><td><code>true</code> pour n'exporter que les conversations passées par le livechat.</td></tr><tr><td><code>currentDialogs</code></td><td>Non</td><td><code>true</code> pour exporter les conversations en cours (formats Xml et Csv uniquement).</td></tr><tr><td><code>variableName</code>, <code>variableValue</code></td><td>Non</td><td>Pour n'exporter que les conversations où une variable a une valeur donnée.</td></tr></tbody></table>

Si les conversations sont chiffrées, ajoutez l'en-tête `DialogsPassword` avec le mot de passe de déchiffrement. Sans lui, le contenu des conversations est masqué dans l'export.

Exemple :

```
curl -X GET "https://<serveur>/servlet/dialogexport?botUUID=ef07a37a-2f38-44f1-a2c4-d2e71e7c6d20&language=fr&startingDate=2026-10-01&endingDate=2026-10-31&format=Csv" \
  -H "Authorization: Basic ZGVtb0BkeWR1LmFpOk15UGFzc3dvcmQ=" \
  -o export.zip
```

En cas d'erreur, l'API renvoie un message JSON, par exemple `{"type":"error","message":"...","status":"BAD_REQUEST"}`.

## Format XML

Pour un export entre deux dates, les conversations sont réparties dans un fichier XML par jour, compressés dans un fichier zip. Pour une seule conversation, le fichier XML n'est pas compressé.

```
<dialogsExport>
  <dialog>
    <length>...</length>
    <businessLength>...</businessLength>
    <userIdentification>...</userIdentification>
    <userLocation>...</userLocation>
    <browser>...</browser>
    <os>...</os>
    <serverName>...</serverName>
    <livechatType>...</livechatType>
    <interactions>
      <interaction>
        <userTalk>...</userTalk>
        <userUrl>...</userUrl>
        <interactionExternValuesString>...</interactionExternValuesString>
        <botAnswer>...</botAnswer>
        <date>...</date>
        <tags><tag>...</tag></tags>
        <typeResponse>...</typeResponse>
        <matches>
          <InteractionMatch>
            <actionId>...</actionId>
            <score>...</score>
            <scoreMatch>...</scoreMatch>
          </InteractionMatch>
        </matches>
        <businessInteraction>...</businessInteraction>
        <durationRuntime>...</durationRuntime>
        <language>...</language>
        <solutionUsed>
          <value>...</value>
          <name>...</name>
          <compatibleSolution>...</compatibleSolution>
        </solutionUsed>
        <encrypted>...</encrypted>
      </interaction>
    </interactions>
    <externValues>
      <externValue>
        <name>...</name>
        <value>...</value>
      </externValue>
    </externValues>
    <startDate>...</startDate>
    <testDialog>...</testDialog>
    <dialogType>...</dialogType>
    <consultationSpace id="...">...</consultationSpace>
    <alreadyCame>...</alreadyCame>
    <qualificationMode>...</qualificationMode>
  </dialog>
</dialogsExport>
```

## Format CSV

Comme pour le XML, un export entre deux dates fournit un fichier zip avec un fichier CSV par jour. Pour une seule conversation, le fichier CSV n'est pas compressé. Les colonnes sont séparées par des points-virgules.

<table><thead><tr><th width="250">Colonne</th><th>Description</th></tr></thead><tbody><tr><td><code>Date</code></td><td>Date de début de la conversation.</td></tr><tr><td><code>Space</code></td><td>Espace de consultation de la conversation.</td></tr><tr><td><code>Length</code></td><td>Nombre total d'interactions.</td></tr><tr><td><code>Qualification</code></td><td>Résultat de la conversation (voir ci-dessous).</td></tr><tr><td>Variables</td><td>Une colonne par variable présente dans les conversations exportées (par exemple <code>dialog_user_id</code>). Ces colonnes varient donc d'un export à l'autre.</td></tr><tr><td><code>Tags</code></td><td>Thématiques utilisées au cours de la conversation, séparées par des points-virgules : elles occupent donc plusieurs colonnes.</td></tr></tbody></table>

Valeurs de la colonne `Qualification` :

* **OnlyDirectMatches** : toutes les questions de l'utilisateur ont obtenu une réponse directe du bot. La conversation est réussie.
* **EndingWithDirectMatch** : certaines questions ont abouti à une reformulation ou n'ont pas été comprises, mais la dernière question a été comprise. La conversation est réussie.
* **Failed** : la dernière question n'a pas été comprise ou a abouti à une reformulation. La conversation est en échec.
* **WithLiveChat** : la conversation est passée par le livechat.
* **Unknown** : la qualification n'a pas pu être déterminée.

Exemples de colonnes de variables :

| Colonne                                    | Description                                                                      |
| ------------------------------------------ | -------------------------------------------------------------------------------- |
| `dialog_user_id`                           | Identifiant de l'utilisateur, s'il a été renseigné.                              |
| `dialog_nb_rewords`                        | Nombre de reformulations proposées pendant la conversation.                      |
| `dialog_nb_garbages`                       | Nombre de phrases incomprises pendant la conversation.                           |
| `dialog_nb_clicked_automatic_rewords`      | Nombre de reformulations sur lesquelles l'utilisateur a cliqué.                  |
| `dialog_nb_clicked_knowledge_redirections` | Nombre de clics sur un lien vers une autre connaissance dans une réponse du bot. |
| `dialog_context_id`                        | Identifiant de la conversation.                                                  |
| `dialog_user_question`                     | Dernière question de la conversation.                                            |

## Format Excel

L'export Excel fournit un fichier `.xlsx`. Il contient au maximum 10 000 conversations : au-delà, seules les 10 000 premières sont exportées.

Chaque conversation est exportée sous la forme suivante :

* date de début (dd/MM/yyyy HH:mm:ss) ;
* espace de consultation ;
* pour chaque interaction :
* question de l'utilisateur ;
* réponse du bot ;
* date (dd/MM/yyyy HH:mm:ss) ;
* qualification ;
* satisfaction : positive ou négative, si l'utilisateur a donné son avis ;
* raison d'insatisfaction, si l'utilisateur en a choisi une ;
* commentaire d'insatisfaction, si l'utilisateur en a laissé un.

### Qualifications

La qualification indique comment le bot a traité la question. Son préfixe donne la catégorie :

<table><thead><tr><th width="100">Préfixe</th><th>Signification</th></tr></thead><tbody><tr><td>DM</td><td><em>Direct Match</em> : la question a été comprise.</td></tr><tr><td>RW</td><td><em>Reword</em> : le bot a proposé une reformulation.</td></tr><tr><td>GB</td><td><em>Garbage</em> : la question n'a pas été comprise.</td></tr><tr><td>OP</td><td><em>Opérateur</em> : la réponse vient d'un opérateur humain.</td></tr><tr><td>NA</td><td><em>No Answer</em> : le bot n'a pas donné de réponse.</td></tr><tr><td>ERR</td><td><em>Error</em> : une erreur s'est produite pendant le traitement de la question.</td></tr></tbody></table>

Qualifications les plus fréquentes :

<table><thead><tr><th width="250">Qualification</th><th>Description</th></tr></thead><tbody><tr><td>DMUnderstoodQuestion</td><td>La question a été comprise et le bot a répondu.</td></tr><tr><td>DMDisabledKnowledge</td><td>La question a été comprise mais la connaissance n'est pas publiée : le bot a répondu qu'il ne pouvait pas répondre.</td></tr><tr><td>DMClickRedirectionLink</td><td>L'utilisateur a cliqué sur une URL de la réponse précédente du bot.</td></tr><tr><td>DMPushReplace</td><td>La réponse du bot a été entièrement remplacée par une réponse complémentaire.</td></tr><tr><td>DMRewordClicked</td><td>L'utilisateur a cliqué sur un lien de la réponse précédente du bot qui menait à la réponse d'une autre connaissance.</td></tr><tr><td>DMRewordClickedAuto</td><td>L'utilisateur a cliqué sur une reformulation de la réponse précédente du bot.</td></tr><tr><td>DMClickJavascriptLink</td><td>L'utilisateur a cliqué sur un lien de la réponse précédente du bot qui exécute du JavaScript.</td></tr><tr><td>RWOneReword</td><td>Reformulation avec une suggestion.</td></tr><tr><td>RWTwoRewords</td><td>Reformulation avec deux suggestions.</td></tr><tr><td>RWThreeRewords</td><td>Reformulation avec trois suggestions.</td></tr><tr><td>GBMisunderstoodQuestion</td><td>La question n'a pas été comprise.</td></tr><tr><td>GBTooManyMisunderstoodQuestions</td><td>La question n'a pas été comprise, et au moins deux autres questions de la conversation ne l'avaient pas été non plus.</td></tr><tr><td>NAWaitingForOperator</td><td>La conversation a été transférée au livechat : le bot indique à l'utilisateur d'attendre qu'un opérateur se connecte.</td></tr><tr><td>OPRegularOperatorAnswer</td><td>La réponse vient d'un opérateur humain.</td></tr><tr><td>ERRApplicationException</td><td>Une erreur d'application s'est produite.</td></tr><tr><td>ERRAPIException</td><td>Une erreur s'est produite lors de l'appel à un service web externe.</td></tr></tbody></table>
