Conversation Metadata

Conversation Metadata låter dig koppla anpassad nyckel-värde-data till konversationer och skapa en kraftfull brygga mellan dina system och din AI Agent. Metadata flödar genom hela ditt Quickchat-workflow:

• Mata via API — Använd dessa endpoints för att programmatiskt koppla metadata till valfri konversation (t.ex. från ditt CRM, helpdesk eller backend)
• Mata via widget/embed — Skicka metadata som initialiseringsparametrar när widgeten laddas, eller injicera den dynamiskt under en aktiv konversation med JavaScript-SDK:et
• Synlig i Dashboard — Metadata visas i konversationsdetaljvyn i Inbox, så att ditt team alltid har kontext
• Inkluderad i exporter — Metadata inkluderas när du exporterar konversationer från Dashboard, vilket gör den tillgänglig för offlineanalys
• Används i AI Actions — Metadatavärden kan injiceras direkt som {{metadata_<key>}}-platshållare i AI Actions. Se AI Action-variabler för den fullständiga referensen över tillgängliga platshållare
• Tillgänglig för AI Agenten — Din AI Agent är medveten om metadatavärden och kan referera till dem under konversationer. Skicka till exempel en kunds namn eller plannivå, så anpassar AI:n sina svar därefter

Metadata är sättet att dynamiskt styra och anpassa varje konversation. Skicka kund-ID:n, kontonivåer, hänvisningskällor, A/B-testvarianter eller vilken kontext din AI Agent än behöver. Denna funktion kommer att utökas betydligt i framtida releaser.

Metadata valideras mot ett JSON-schema om ett sådant är konfigurerat i 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

Skapa eller uppdatera metadata för en konversation.

Scope: write_all

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

Request Body

Parameter	Description
metadata object, required	Nyckel-värde-metadata att lagra

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

---