Cuộc trò chuyện

Quickchat AI ghi nhận mọi cuộc trò chuyện trên tất cả kênh. Các endpoint này cho phép liệt kê và lấy chúng.

Quickchat AI tự động ghi nhận và phân tích mọi cuộc trò chuyện của AI Agent trên tất cả kênh: widget, Slack, WhatsApp, Telegram và nhiều kênh khác. Conversations API cho phép truy cập bộ dữ liệu phong phú này bằng lập trình để xây bảng điều khiển tùy chỉnh, đưa dữ liệu vào quy trình phân tích, kích hoạt quy trình CRM hoặc tích hợp công cụ phân tích kinh doanh hiện có.

Mỗi cuộc trò chuyện có phân tích bằng AI: phát hiện cảm xúc, phân loại chủ đề, theo dõi giải quyết và tự động gắn cờ cuộc trò chuyện có thể cần nhân viên chú ý. Kết hợp lịch sử tin nhắn đầy đủ, lượt nhấp liên kết được theo dõi và siêu dữ liệu tùy chỉnh, bạn có đủ thông tin để hiểu cách khách tương tác với AI Agent.

Dữ liệu cuộc trò chuyện nằm ở nhiều endpoint:

Liệt kê cuộc trò chuyện: thông tin cơ bản, chi tiết khách, trạng thái. Dùng cho bảng điều khiển, tổng quan và truy vấn đã lọc
Lấy chi tiết cuộc trò chuyện: thông tin đầy đủ gồm unified_analysis (phân tích AI) và client_metadata
Lấy sự kiện cuộc trò chuyện: toàn bộ lịch sử tin nhắn, lượt nhấp liên kết được theo dõi và bản ghi nhật ký
Lấy/Đặt siêu dữ liệu: dữ liệu khóa-giá trị tùy chỉnh gắn vào cuộc trò chuyện (xem Siêu dữ liệu cuộc trò chuyện)

Liệt kê cuộc trò chuyện

Phạm vi: read_all

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

Tham số truy vấn

Tham số	Mô tả
`limit` số nguyên	Số mục mỗi trang
`offset` số nguyên	Số mục bỏ qua
`query` chuỗi	Tìm theo số thứ tự, UUID hoặc văn bản tin nhắn
`assignee_type` chuỗi	`"ai_assistant"`, `"human_operator"` hoặc `"unassigned"`
`source` chuỗi	`"widget"`, `"slack"`, `"telegram"`, `"whatsapp"`, v.v.
`resolution_status` chuỗi	`"open"` hoặc `"resolved"`
`created_timestamp_start_date` ngày giờ	Lọc theo ngày tạo (bắt đầu)
`created_timestamp_end_date` ngày giờ	Lọc theo ngày tạo (kết thúc)
`last_message_at_start_date` ngày giờ	Lọc theo ngày tin nhắn cuối (bắt đầu)
`last_message_at_end_date` ngày giờ	Lọc theo ngày tin nhắn cuối (kết thúc)
`most_frequent_language` chuỗi	Lọc theo ngôn ngữ được phát hiện
`order` chuỗi	`"desc"` (mặc định, mới nhất trước) hoặc `"asc"` (cũ nhất trước). Thứ tự tăng dần dành cho việc duyệt tiến từ một cuộc trò chuyện đã biết, nên kết hợp với `last_message_at_start_date`

Shell
Python

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

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

Phản hồi 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
}

Trường	Mô tả
`id` chuỗi	UUID cuộc trò chuyện
`ord` số nguyên	Số thứ tự cuộc trò chuyện
`created_at` chuỗi	Dấu thời gian tạo cuộc trò chuyện
`last_message_at` chuỗi	Dấu thời gian tin nhắn gần nhất
`title` chuỗi	Tiêu đề cuộc trò chuyện do AI tạo
`source` chuỗi	Kênh nguồn cuộc trò chuyện (ví dụ `"widget"`, `"slack"`, `"whatsapp"`)
`terminated` boolean	Cuộc trò chuyện đã kết thúc chưa
`resolution_status` chuỗi	`"open"` hoặc `"resolved"`
`has_unread_messages` boolean	Có tin nhắn chưa đọc không
`supports_inbox_control` boolean	Nguồn cuộc trò chuyện có hỗ trợ điều khiển hộp thư (giao, chuyển giao) không
`last_message_content` chuỗi	Nội dung tin nhắn cuối cuộc trò chuyện
`most_frequent_language` chuỗi	Ngôn ngữ được phát hiện nhiều nhất trong cuộc trò chuyện
`assignee` đối tượng	Người được giao hiện tại (`type`: `"ai_assistant"`, `"human_operator"` hoặc `"unassigned"`)
`visitor_name` chuỗi hoặc null	Tên khách (từ biểu mẫu trước chat hoặc hồ sơ kênh)
`visitor_email` chuỗi hoặc null	Email khách
`visitor_phone_number` chuỗi hoặc null	Số điện thoại khách
`visitor_label` chuỗi hoặc null	Nhãn tùy chỉnh gán cho khách

Lấy chi tiết cuộc trò chuyện

Phạm vi: read_all

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

Shell
Python

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

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

Phản hồi 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
}

Phản hồi chi tiết bao gồm mọi trường của phản hồi danh sách, cộng thêm:

Trường	Mô tả
`url` chuỗi hoặc null	URL trang nơi cuộc trò chuyện bắt đầu (chỉ widget)
`client_metadata` đối tượng hoặc null	Cặp khóa-giá trị tùy chỉnh gắn vào cuộc trò chuyện
`last_visitor_message_at` chuỗi	Dấu thời gian tin nhắn cuối của khách
`unified_analysis` đối tượng hoặc null	Phân tích cuộc trò chuyện do AI tạo (xem dưới)

Các trường unified_analysis:

Trường	Mô tả
`sentiment` chuỗi	Cảm xúc cuộc trò chuyện do AI phát hiện (ví dụ `"positive"`, `"neutral"`, `"negative"`)
`resolution_status` chuỗi	Trạng thái giải quyết do AI đánh giá (có thể khác `resolution_status` cấp cao nhất)
`topic` chuỗi	Chủ đề cuộc trò chuyện do AI phát hiện
`is_flagged` boolean	AI có gắn cờ cuộc trò chuyện để nhân viên xem xét không
`flag_reason` chuỗi hoặc null	Lý do cuộc trò chuyện bị gắn cờ

Trường resolution_status cấp cao nhất ("open" hoặc "resolved") là trạng thái chính thức được đặt thủ công hoặc bởi quy tắc tự động.

unified_analysis.resolution_status do AI phân tích và có thể khác. Ví dụ AI có thể phân loại đã giải quyết dựa trên nội dung dù trạng thái cấp cao nhất vẫn là "open". Dùng trường cấp cao nhất cho lọc và quy trình; dùng unified_analysis cho phân tích và thông tin chuyên sâu.

Lấy sự kiện cuộc trò chuyện

Lấy mọi sự kiện (tin nhắn, liên kết được theo dõi, nhật ký) của cuộc trò chuyện.

Phạm vi: read_all

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

Tham số truy vấn

Tham số	Mô tả
`limit` số nguyên	Số mục mỗi trang
`offset` số nguyên	Số mục bỏ qua

Shell
Python

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

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

Phản hồi 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
}

Loại sự kiện: message, tracked_link, log

Loại tác giả: ai_assistant, visitor, human_operator

Trường	Mô tả
`type` chuỗi	Loại sự kiện: `"message"`, `"tracked_link"` hoặc `"log"`
`data.id` chuỗi	Định danh tin nhắn duy nhất
`data.ord` số nguyên	Số thứ tự tin nhắn
`data.created_at` chuỗi	Dấu thời gian sự kiện
`data.content` chuỗi	Nội dung tin nhắn
`data.author` chuỗi	`"ai_assistant"`, `"visitor"` hoặc `"human_operator"`
`data.handoff_state` chuỗi hoặc null	Trạng thái chuyển giao nếu có
`data.message_insights` đối tượng hoặc null	Phân tích tin nhắn do AI tạo
`data.feedback` đối tượng hoặc null	Phản hồi của người dùng về tin nhắn
`data.client_metadata` đối tượng hoặc null	Siêu dữ liệu tùy chỉnh gắn vào tin nhắn
`data.sources_generated` mảng	Bài viết Cơ sở kiến thức mà AI dùng khi tạo câu trả lời
`data.is_welcome` boolean	Đây có phải tin nhắn chào mừng không
`data.attachments` mảng	Tệp đính kèm

Cuộc trò chuyện

Liệt kê cuộc trò chuyện

Lấy chi tiết cuộc trò chuyện

Lấy sự kiện cuộc trò chuyện

Bắt đầu

AI Agent

Actions

Hội thoại

Channels

Trang web của bạn

Helpdesk & CRM

Ứng dụng nhắn tin

Tài khoản và thanh toán

Bắt đầu

Cấu hình

Knowledge Base

Hội thoại