-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Formats de données d’interactions numériques
À propos des formats de données des interactions numériques
XM Discover vous permet de charger des interactions numériques (c’est-à-dire des conversations) via CSV, Excel ou JSON. Les interactions numériques identifient les participants dans une conversation et attribuent chaque message à un participant.
En règle générale, les interactions numériques contiennent un certain nombre de zones de données structurées et non structurées qui représentent une conversation entre un client et une entité de votre société (par exemple, la transcription entre un client et un chatbot sur votre site Web ou la transcription de la discussion en direct entre un client et un représentant du support en direct). Les champs structurés peuvent contenir des dates, des nombres ou des données de texte avec un degré élevé d’organisation (comme les noms des marques, les noms des participants et les produits). Les champs non structurés contiennent des notes, des commentaires et d’autres champs de texte libre.
Vous pouvez charger des interactions numériques aux formats suivants :
- CSV
- XLS ou XLSX (Microsoft Excel)
- JSON
Formatage CSV et Excel pour les interactions numériques
Cette section traite de la mise en forme des avis individuels pour les fichiers CSV et Excel. La mise en forme et les exigences pour les deux types de fichiers sont identiques.
Dans les fichiers CSV et Excel, les interactions numériques sont définies à l’aide de plusieurs lignes. Découvrez l’univers de de l’XM :
- Chaque ligne contient une ligne de dialogue individuelle dans une conversation avec les données des participants et un horodatage.
- Les lignes séparées sont regroupées en une seule conversation en partageant le même ID de conversation.
- Les valeurs de champ à l’échelle de la conversation (telles que Date du document ou attributs personnalisés) sont extraites de la première ligne de la conversation.
- Les en-têtes de colonne doivent correspondre exactement aux champs de la table ci-dessous.
Le tableau suivant décrit les zones d’une interaction numérique.
| En-tête de colonne | Description |
| ID de conversation
(obligatoire) |
ID unique pour l’ensemble de la conversation. Chaque ligne ayant le même ID est traitée comme une ligne distincte dans une seule conversation.
Vous pouvez mapper cette zone à l’attribut natural_id pour l’utiliser comme ID naturel du document. |
| conversationTimestamp
(Requis) |
Date et heure de toute la conversation. Habituellement, c’est à ce moment que la conversation commence. Utilisez le format ISO 8601 avec une précision en secondes.
Vous pouvez mapper ce champ à l’attribut document_date pour l’utiliser comme date du document. |
| participantId
(obligatoire) |
ID du participant. Chaque participant unique d’une conversation doit avoir un ID différent.
Vous pouvez avoir le même ID de participant dans plusieurs conversations (par exemple, le même agent dans de nombreuses interactions), mais dans une conversation, il ne peut pas être le même. |
| participantType
(Required) |
Type du participant. Valeurs possibles :
Ces valeurs sont transmises à l’attribut Type de participant CB pour le reporting et la visualisation des participants. S’il n’est pas spécifié, le type de participant CB n’aura pas de valeur à déclarer. |
| is_bot
(facultatif) |
Champ booléen qui indique si un participant est un chatbot ou une personne.
Ces valeurs sont transmises à l’attribut Type de participant CB pour le reporting et la visualisation des participants. S’il n’est pas spécifié, le type de participant CB n’aura pas de valeur à déclarer. |
| texte
(obligatoire) |
Texte du message.
Attention : la somme de tous les éléments de texte ne doit pas dépasser 100 000 caractères. Si c’est le cas, la conversation est ignorée.
|
| horodatage
(obligatoire) |
Date et heure du message. Utilisez le format ISO 8601 avec une précision en secondes. |
| champs personnalisés
(facultatif) |
Vous pouvez fournir plusieurs champs pour ajouter des attributs structurés à la conversation. |
Mise en forme JSON pour les interactions numériques
Objets de niveau supérieur
Le tableau suivant décrit les objets de niveau supérieur d’un nœud de document.
| Élément | Description |
| ID de conversation | ID unique pour l’ensemble de la conversation.
Vous pouvez mapper cette zone à l’attribut natural_id pour l’utiliser comme ID naturel du document. |
| Horodatage de la conversation | Date et heure de toute la conversation. Habituellement, c’est à ce moment que la conversation commence. Utilisez le format ISO 8601 avec une précision en secondes.
Vous pouvez mapper ce champ à l’attribut document_date pour l’utiliser comme date du document. |
| contenu | Objet contenant le contenu de la conversation. Inclut ces objets imbriqués :
|
| Zones personnalisées (attributs) | Vous pouvez fournir plusieurs paires clé-valeur pour ajouter des attributs structurés à la conversation. |
Objet de contenu
Le tableau suivant décrit les objets imbriqués dans l’objet de contenu.
| Élément | Description |
| participants | Un tableau d’objets qui fournit des informations sur les participants de la conversation. Inclut les zones suivantes :
|
| ConversationContent | Tableau d’objets contenant les lignes de la conversation. Inclut les zones suivantes :
|
participants Objet
Le tableau suivant décrit les champs imbriqués dans l’objet participants.
| Élément | Description |
| participantId
(obligatoire) |
ID du participant. Chaque participant unique d’une conversation doit avoir un ID différent.
Vous pouvez avoir le même ID de participant dans plusieurs conversations (par exemple, le même agent dans de nombreuses interactions), mais dans une conversation, il ne peut pas être le même. |
| participantType
(Required) |
Type du participant. Valeurs possibles :
Ces valeurs sont transmises à l’attribut Type de participant CB pour le reporting et la visualisation des participants. S’il n’est pas spécifié, le type de participant CB n’aura pas de valeur à déclarer. |
| is_bot
(facultatif) |
Champ booléen qui indique si un participant est un chatbot ou une personne.
Ces valeurs sont transmises à l’attribut Type de participant CB pour le reporting et la visualisation des participants. S’il n’est pas spécifié, le type de participant CB n’aura pas de valeur à déclarer. |
objet conversationContent
Le tableau suivant décrit les champs imbriqués dans l’objet conversationContent.
| Élément | Description |
| participantId
(obligatoire) |
ID du participant qui prend la parole. Doit correspondre à l’un des ID fournis dans le tableau des participants. |
| texte
(obligatoire) |
Transcription vocale.
Attention : la somme de tous les éléments de texte ne doit pas dépasser 100 000 caractères. Si c’est le cas, la conversation est ignorée.
|
| horodatage
(obligatoire) |
Date et heure du message. Utilisez le format ISO 8601 avec une précision en secondes. |
| id
(Obligatoire) |
ID unique du message. |
Exemple JSON
Voici un exemple de transcription d’
appel entre un agent et un client.
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"content": {
"participants": [
{
"participantId": "1",
participENT Type": "AGisant_
": "content"
: "participantbot",
"participantType": "AGisant_
": "AGisant_
": "participantbot",participENT Type: "AGisant_
": "AGisant_
": "participantbot",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"participantId": "2",
"text": "Hi, are you open Today?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785202"
},
"
participantId": "1",
"text": "We're open from 17:00 to 23:00.",
"timestamp": "2020-07-30T12 participamp:15.000Z": "
"
"id":
"2020-07-30T12
" Quel nom puis-je utiliser?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
] }
,
"city": "Boston",
"source": "Facebook"
}
]