Conversation Metadata

Mit Conversation Metadata können Sie benutzerdefinierte Schlüssel-Wert-Daten an Konversationen anhängen und so eine leistungsstarke Brücke zwischen Ihren Systemen und Ihrem KI-Agenten schlagen. Metadaten fließen durch Ihren gesamten Quickchat-Workflow:

• Über die API einspeisen — Verwenden Sie diese Endpunkte, um Metadaten programmatisch an jede beliebige Konversation anzuhängen (z. B. aus Ihrem CRM, Helpdesk oder Backend)
• Über Widget/Embed einspeisen — Übergeben Sie Metadaten als Initialisierungsparameter beim Laden des Widgets oder injizieren Sie sie während einer aktiven Konversation dynamisch über das JavaScript-SDK
• Sichtbar im Dashboard — Metadaten erscheinen in der Detailansicht der Konversation in der Inbox, sodass Ihr Team immer den Kontext hat
• In Exporten enthalten — Metadaten werden einbezogen, wenn Sie Konversationen aus dem Dashboard exportieren, und stehen so für Offline-Analysen zur Verfügung
• In AI Actions verwendet — Metadaten-Werte können direkt als {{metadata_<key>}}-Platzhalter in AI Actions injiziert werden. Die vollständige Referenz der verfügbaren Platzhalter finden Sie unter AI Action Variables
• Für den KI-Agenten verfügbar — Ihr KI-Agent kennt die Metadaten-Werte und kann sie während Konversationen referenzieren. Übergeben Sie zum Beispiel den Namen oder die Plan-Stufe eines Kunden, und die KI personalisiert ihre Antworten entsprechend

Metadaten sind der Weg, jede Konversation dynamisch zu steuern und zu personalisieren. Übergeben Sie Kunden-IDs, Account-Stufen, Referral-Quellen, A/B-Test-Varianten oder jeden Kontext, den Ihr KI-Agent benötigt. Diese Funktion wird in zukünftigen Releases erheblich erweitert.

Metadaten werden gegen ein JSON-Schema validiert, sofern eines im Dashboard konfiguriert ist.

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()

Antwort 200 OK

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

Set Metadata

Metadaten für eine Konversation erstellen oder aktualisieren.

Scope: write_all

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

Request-Body

Parameter	Description
metadata object, required	Zu speichernde Schlüssel-Wert-Metadaten

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()

Antwort 200 OK

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

---