Conversation Metadata

Conversation Metadata vous permet d’attacher des données clé-valeur personnalisées aux conversations, créant un pont puissant entre vos systèmes et votre AI Agent. Les métadonnées circulent dans l’ensemble de votre workflow Quickchat :

• Alimentation via l’API — Utilisez ces endpoints pour attacher par programmation des métadonnées à n’importe quelle conversation (p. ex. depuis votre CRM, votre helpdesk ou votre backend)
• Alimentation via le widget/embed — Passez des métadonnées comme paramètres d’initialisation lors du chargement du widget, ou injectez-les dynamiquement pendant une conversation active à l’aide du SDK JavaScript
• Visibles dans le Dashboard — Les métadonnées apparaissent dans la vue détaillée de la conversation dans l’Inbox, pour que votre équipe ait toujours le contexte
• Incluses dans les exports — Les métadonnées sont incluses lorsque vous exportez des conversations depuis le Dashboard, ce qui les rend disponibles pour une analyse hors ligne
• Utilisées dans les AI Actions — Les valeurs de métadonnées peuvent être injectées directement comme marqueurs {{metadata_<key>}} dans les AI Actions. Consultez AI Action Variables pour la référence complète des marqueurs disponibles
• Disponibles pour l’AI Agent — Votre AI Agent connaît les valeurs de métadonnées et peut y faire référence pendant les conversations. Par exemple, passez le nom d’un client ou son niveau d’abonnement, et l’IA personnalisera ses réponses en conséquence

Les métadonnées sont le moyen de piloter et de personnaliser dynamiquement chaque conversation. Passez des IDs de client, des niveaux de compte, des sources de parrainage, des variantes de test A/B, ou tout contexte dont votre AI Agent a besoin. Cette capacité sera considérablement étendue dans les prochaines versions.

Les métadonnées sont validées par rapport à un JSON schema si l’un est configuré dans le Dashboard.

Get Metadata

Scope: read_all

GET https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Shell

curl https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Response 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

Set Metadata

Créez ou mettez à jour les métadonnées d’une conversation.

Scope: write_all

POST https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Request Body

Parameter	Description
metadata object, required	Métadonnées clé-valeur à stocker

Shell

curl -X POST https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "metadata": {"ticket_id": "T-1234", "priority": "high"}
    },
)
data = response.json()

Response 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

---