Conversations

Quickchat AI fångar och analyserar automatiskt varje konversation din AI Agent har över alla kanaler — widget, Slack, WhatsApp, Telegram med mera. Conversations API:et ger dig programmatisk åtkomst till denna rika datamängd för att bygga egna dashboards, mata nedströms analyspipelines, utlösa CRM-workflows eller integrera med dina befintliga business intelligence-verktyg.

Varje konversation inkluderar AI-driven analys: sentimentdetektering, ämnesklassificering, resolutionsspårning och automatisk flaggning av konversationer som kan behöva mänsklig uppmärksamhet. Tillsammans med fullständig meddelandehistorik, spårade länkklick och anpassad metadata har du allt du behöver för att förstå hur besökare interagerar med din AI Agent.

Konversationsdata är fördelad över flera endpoints:

• List Conversations — Grundläggande info, besökaruppgifter, status. Använd för dashboards, översikter och filtrerade förfrågningar
• Get Conversation Details — Fullständig info inklusive unified_analysis (AI-genererade insikter) och client_metadata
• Get Conversation Events — Komplett meddelandehistorik, spårade länkklick och loggposter
• Get/Set Metadata — Anpassad nyckel-värde-data som du kopplar till konversationer (se Conversation Metadata)

List Conversations

Scope: read_all

GET https://app.quickchat.ai/v1/api_core/conversations

Query Parameters

Parameter	Description
limit integer	Objekt per sida
offset integer	Objekt att hoppa över
query string	Sök efter ordningsnummer, UUID eller meddelandetext
assignee_type string	"ai_assistant", "human_operator" eller "unassigned"
source string	"widget", "slack", "telegram", "whatsapp" osv.
resolution_status string	"open" eller "resolved"
created_timestamp_start_date datetime	Filtrera efter skapandedatum (start)
created_timestamp_end_date datetime	Filtrera efter skapandedatum (slut)
last_message_at_start_date datetime	Filtrera efter senaste meddelandedatum (start)
last_message_at_end_date datetime	Filtrera efter senaste meddelandedatum (slut)
most_frequent_language string	Filtrera efter detekterat språk

Shell

curl 'https://app.quickchat.ai/v1/api_core/conversations?limit=10&resolution_status=open' \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    params={"limit": 10, "resolution_status": "open"},
)
data = response.json()

Response 200 OK

{
  "items": [
    {
      "id": "conv-uuid-1234",
      "ord": 42,
      "created_at": "2026-01-15T10:30:00Z",
      "last_message_at": "2026-01-15T10:35:00Z",
      "title": "Return policy question",
      "source": "widget",
      "terminated": false,
      "resolution_status": "open",
      "has_unread_messages": true,
      "supports_inbox_control": true,
      "last_message_content": "What is your return policy?",
      "most_frequent_language": "en",
      "assignee": {
        "type": "ai_assistant"
      },
      "visitor_name": "John",
      "visitor_email": "john@example.com",
      "visitor_phone_number": null,
      "visitor_label": null
    }
  ],
  "offset": 0,
  "limit": 10,
  "count": 42
}

Field	Description
id string	Konversations-UUID
ord integer	Sekventiellt konversationsnummer
created_at string	Tidsstämpel för konversationens skapande
last_message_at string	Tidsstämpel för det senaste meddelandet
title string	AI-genererad konversationstitel
source string	Kanal som konversationen kom från (t.ex. "widget", "slack", "whatsapp")
terminated boolean	Om konversationen har avslutats
resolution_status string	"open" eller "resolved"
has_unread_messages boolean	Om det finns olästa meddelanden
supports_inbox_control boolean	Om konversationskällan stöder inbox-kontroll (tilldela, handoff)
last_message_content string	Innehållet i det sista meddelandet i konversationen
most_frequent_language string	Det mest frekvent detekterade språket i konversationen
assignee object	Aktuell ansvarig (type: "ai_assistant", "human_operator" eller "unassigned")
visitor_name string or null	Besökarens namn (från formulär före chatten eller kanalprofil)
visitor_email string or null	Besökarens e-postadress
visitor_phone_number string or null	Besökarens telefonnummer
visitor_label string or null	Anpassad etikett som tilldelats besökaren

Get Conversation Details

Scope: read_all

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

Shell

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

Python

import requests

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

Response 200 OK

{
  "id": "conv-uuid-1234",
  "ord": 42,
  "created_at": "2026-01-15T10:30:00Z",
  "last_message_at": "2026-01-15T10:35:00Z",
  "title": "Return policy question",
  "source": "widget",
  "terminated": false,
  "resolution_status": "open",
  "has_unread_messages": true,
  "supports_inbox_control": true,
  "last_message_content": "What is your return policy?",
  "most_frequent_language": "en",
  "assignee": {
    "type": "ai_assistant"
  },
  "url": null,
  "client_metadata": {"userId": 12},
  "last_visitor_message_at": "2026-01-15T10:34:00Z",
  "unified_analysis": {
    "sentiment": "neutral",
    "resolution_status": "open",
    "topic": "Return policy",
    "is_flagged": false,
    "flag_reason": null
  },
  "visitor_name": "John",
  "visitor_email": "john@example.com",
  "visitor_phone_number": null,
  "visitor_label": null
}

Detaljsvaret inkluderar alla fält från listsvaret, plus:

Field	Description
url string or null	URL till sidan där konversationen startade (endast widget)
client_metadata object or null	Anpassade nyckel-värde-par som kopplats till konversationen
last_visitor_message_at string	Tidsstämpel för besökarens senaste meddelande
unified_analysis object or null	AI-genererad analys av konversationen (se nedan)

unified_analysis-fält:

Field	Description
sentiment string	AI-detekterat konversationssentiment (t.ex. "positive", "neutral", "negative")
resolution_status string	AI-bedömd resolutionsstatus (kan skilja sig från resolution_status på toppnivå)
topic string	AI-detekterat konversationsämne
is_flagged boolean	Om AI:n flaggade denna konversation för mänsklig granskning
flag_reason string or null	Anledningen till att konversationen flaggades

resolution_status vs unified_analysis.resolution_status

Fältet resolution_status på toppnivå ("open" eller "resolved") är den kanoniska statusen som sätts manuellt eller av automatiseringsregler.

unified_analysis.resolution_status beräknas av AI-analys och kan skilja sig — AI:n kan till exempel klassificera en konversation som löst baserat på innehållsanalys även om statusen på toppnivå fortfarande är "open". Använd fältet på toppnivå för filtrering och workflow; använd unified_analysis för analys och insikter.

Get Conversation Events

Hämta alla händelser (meddelanden, spårade länkar, loggar) för en konversation.

Scope: read_all

GET https://app.quickchat.ai/v1/api_core/conversations/{conversation_id}/events/

Query Parameters

Parameter	Description
limit integer	Objekt per sida
offset integer	Objekt att hoppa över

Shell

curl 'https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/events/?limit=20' \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

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

Response 200 OK

{
  "items": [
    {
      "type": "message",
      "data": {
        "id": "msg-uuid-001",
        "ord": 1,
        "created_at": "2026-01-15T10:30:00Z",
        "content": "Hello! How can I help you today?",
        "author": "ai_assistant",
        "handoff_state": null,
        "message_insights": null,
        "feedback": null,
        "client_metadata": null,
        "sources_generated": [],
        "is_welcome": true,
        "attachments": []
      }
    },
    {
      "type": "message",
      "data": {
        "id": "msg-uuid-002",
        "ord": 2,
        "created_at": "2026-01-15T10:31:00Z",
        "content": "What is your return policy?",
        "author": "visitor",
        "handoff_state": null,
        "message_insights": null,
        "feedback": null,
        "client_metadata": null,
        "sources_generated": [],
        "is_welcome": false,
        "attachments": []
      }
    }
  ],
  "offset": 0,
  "limit": 20,
  "count": 2
}

Event types: message, tracked_link, log

Author types: ai_assistant, visitor, human_operator

Field	Description
type string	Händelsetyp: "message", "tracked_link" eller "log"
data.id string	Unik meddelandeidentifierare
data.ord integer	Sekventiellt meddelandenummer
data.created_at string	Tidsstämpel för händelsen
data.content string	Meddelandeinnehåll
data.author string	"ai_assistant", "visitor" eller "human_operator"
data.handoff_state string or null	Handoff-tillstånd om tillämpligt
data.message_insights object or null	AI-genererade meddelandeinsikter
data.feedback object or null	Användarfeedback på meddelandet
data.client_metadata object or null	Anpassad metadata kopplad till meddelandet
data.sources_generated array	Knowledge Base-artiklar som AI:n använde när den genererade sitt svar
data.is_welcome boolean	Om detta är ett välkomstmeddelande
data.attachments array	Filbilagor

---