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: anpassad metadata visas i konversationsdetaljerna i Inkorgen. Interna nycklar filtreras bort, och insamlade kontaktuppgifter och åtgärdsminne visas separat
• 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 när det är tillåtet: modellkontexten använder en filtrerad delmängd av metadata. Att lagra en nyckel garanterar inte att modellen får den eller nämner den

Använd metadata för kundreferenser, kontokontext, analys och indata till åtgärder. Lagring, visning i Inkorgen, ersättning i åtgärder och modellkontext är separata användningsområden för samma data.

Metadata valideras mot ett JSON-schema om ett sådant är konfigurerat i Dashboard.

Modellkontext och behörighetskontroll

På kanaler där besökaren styr indata, som webbplatsens Widget och Embed, kan besökarens kontaktnycklar (visitor_name, visitor_email, visitor_phone_number) och tillåtna nycklar som refereras till eller samlas in av aktiva åtgärder ingå i modellkontexten. Interna och reserverade värden filtreras bort; inställningar och storleksgränser gäller också. Andra integrationer har kanalspecifika regler för kontexten. En anpassad nyckel som customer_tier eller customer_id blir inte automatiskt synlig för modellen bara för att du har skickat den.

En åtgärd kan ersätta {{metadata_<key>}} när den bygger sin förfrågan utan att be AI:n generera värdet. Det gör inte vanlig metadata hemlig: ett tillåtet värde kan separat ingå i modellkontexten eller förekomma i ett åtgärdssvar. Spara inte API-nycklar eller lösenord i anpassad metadata.

Metadata som skickas från webbläsaren styrker inte identitet eller behörighet. Din mottagande tjänst måste verifiera identiteten och kontrollera behörigheten till privata uppgifter; ett kund-ID eller en plannivå som skickas från en webbläsare räcker inte. Testa både den resulterande förfrågan från åtgärden och agentens svar för din konfiguration.

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

---