Conversation Metadata

Conversation Metadata pozwala dołączać niestandardowe dane klucz-wartość do rozmów, tworząc potężny pomost między Twoimi systemami a Twoim AI Agentem. Metadane przepływają przez cały Twój workflow w Quickchat:

• Zasilanie przez API — Użyj tych endpointów, aby programistycznie dołączyć metadane do dowolnej rozmowy (np. z Twojego CRM, helpdesku lub backendu)
• Zasilanie przez widget/embed — Przekaż metadane jako parametry inicjalizacji podczas ładowania widgetu lub wstrzyknij je dynamicznie w trakcie aktywnej rozmowy za pomocą JavaScript SDK
• Widoczne w Dashboardzie — Metadane pojawiają się w widoku szczegółów rozmowy w Inboksie, więc Twój zespół zawsze ma kontekst
• Uwzględniane w eksportach — Metadane są uwzględniane przy eksporcie rozmów z Dashboardu, dzięki czemu są dostępne do analizy offline
• Używane w AI Actions — Wartości metadanych mogą być wstrzykiwane bezpośrednio jako placeholdery {{metadata_<key>}} do AI Actions. Pełną dokumentację dostępnych placeholderów znajdziesz w AI Action Variables
• Dostępne dla AI Agenta — Twój AI Agent zna wartości metadanych i może się do nich odwoływać podczas rozmów. Na przykład przekaż imię klienta lub poziom planu, a AI odpowiednio spersonalizuje swoje odpowiedzi

Metadane to sposób na dynamiczne sterowanie i personalizowanie każdej rozmowy. Przekazuj ID klientów, poziomy kont, źródła poleceń, warianty testów A/B lub dowolny kontekst, którego potrzebuje Twój AI Agent. Ta funkcja zostanie znacząco rozszerzona w przyszłych wydaniach.

Metadane są walidowane względem schematu JSON, jeśli taki jest skonfigurowany w Dashboardzie.

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

Utwórz lub zaktualizuj metadane dla rozmowy.

Scope: write_all

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

Request Body

Parameter	Description
metadata object, required	Metadane klucz-wartość do zapisania

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"
  }
}

---