การสนทนา

Quickchat AI บันทึกทุกบทสนทนาจากทุกช่องทาง เอนด์พอยต์เหล่านี้ช่วยให้แสดงรายการและดึงข้อมูลบทสนทนาได้

Quickchat AI บันทึกและวิเคราะห์ทุกบทสนทนาของ AI Agent จากทุกช่องทางโดยอัตโนมัติ ทั้งวิดเจ็ต Slack, WhatsApp, Telegram และอื่น ๆ API การสนทนาช่วยให้เข้าถึงข้อมูลเหล่านี้ด้วยโปรแกรมเพื่อสร้างแดชบอร์ดเฉพาะ ส่งข้อมูลต่อให้ระบบวิเคราะห์ เริ่มกระบวนการ CRM หรือเชื่อมกับเครื่องมือวิเคราะห์ธุรกิจที่ใช้อยู่

ทุกบทสนทนามีการวิเคราะห์ด้วย AI: ตรวจจับความรู้สึก, จัดประเภทหัวข้อ, ติดตามผลการแก้ไข และ ตั้งค่าสถานะอัตโนมัติ สำหรับบทสนทนาที่อาจต้องการความช่วยเหลือจากเจ้าหน้าที่ เมื่อรวมกับประวัติข้อความทั้งหมด การติดตามการคลิกลิงก์ และเมทาดาทาที่กำหนดเอง คุณจะมีข้อมูลครบสำหรับเข้าใจการโต้ตอบของผู้เยี่ยมชมกับ AI Agent

ข้อมูลบทสนทนาอยู่ในหลายเอนด์พอยต์:

แสดงรายการบทสนทนา: ข้อมูลพื้นฐาน รายละเอียดผู้เยี่ยมชม และสถานะ ใช้สำหรับแดชบอร์ด ภาพรวม และการค้นหาแบบกรอง
ดึงรายละเอียดบทสนทนา: ข้อมูลครบถ้วนรวมถึง unified_analysis (ข้อมูลเชิงลึกที่ AI สร้าง) และ client_metadata
ดึงเหตุการณ์ของบทสนทนา: ประวัติข้อความทั้งหมด การคลิกลิงก์ที่ติดตาม และรายการบันทึก
ดึง/กำหนดเมทาดาทา: ข้อมูลแบบคีย์และค่าที่คุณแนบกับบทสนทนา (ดู เมทาดาทาของบทสนทนา)

แสดงรายการบทสนทนา

ขอบเขตสิทธิ์: read_all

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

พารามิเตอร์การค้นหา

พารามิเตอร์	คำอธิบาย
`limit` จำนวนเต็ม	จำนวนรายการต่อหน้า
`offset` จำนวนเต็ม	จำนวนรายการที่จะข้าม
`query` สตริง	ค้นหาด้วยเลขลำดับ UUID หรือข้อความ
`assignee_type` สตริง	`"ai_assistant"`, `"human_operator"` หรือ `"unassigned"`
`source` สตริง	`"widget"`, `"slack"`, `"telegram"`, `"whatsapp"` เป็นต้น
`resolution_status` สตริง	`"open"` หรือ `"resolved"`
`created_timestamp_start_date` วันที่และเวลา	กรองตามวันที่สร้าง (เริ่มต้น)
`created_timestamp_end_date` วันที่และเวลา	กรองตามวันที่สร้าง (สิ้นสุด)
`last_message_at_start_date` วันที่และเวลา	กรองตามวันที่ข้อความล่าสุด (เริ่มต้น)
`last_message_at_end_date` วันที่และเวลา	กรองตามวันที่ข้อความล่าสุด (สิ้นสุด)
`most_frequent_language` สตริง	กรองตามภาษาที่ตรวจพบ
`order` สตริง	`"desc"` (ค่าเริ่มต้น ใหม่สุดก่อน) หรือ `"asc"` (เก่าสุดก่อน) ลำดับจากเก่าไปใหม่เหมาะสำหรับไล่ต่อจากบทสนทนาที่ทราบอยู่แล้ว จึงควรใช้ร่วมกับ `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()

การตอบกลับ 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
}

ฟิลด์	คำอธิบาย
`id` สตริง	UUID ของบทสนทนา
`ord` จำนวนเต็ม	เลขลำดับบทสนทนา
`created_at` สตริง	เวลาที่สร้างบทสนทนา
`last_message_at` สตริง	เวลาของข้อความล่าสุด
`title` สตริง	ชื่อบทสนทนาที่ AI สร้าง
`source` สตริง	ช่องทางต้นทางของบทสนทนา (เช่น `"widget"`, `"slack"`, `"whatsapp"`)
`terminated` บูลีน	บทสนทนาจบแล้วหรือไม่
`resolution_status` สตริง	`"open"` หรือ `"resolved"`
`has_unread_messages` บูลีน	มีข้อความที่ยังไม่อ่านหรือไม่
`supports_inbox_control` บูลีน	ช่องทางต้นทางรองรับการควบคุมจากกล่องข้อความหรือไม่ (การมอบหมาย การส่งต่อ)
`last_message_content` สตริง	เนื้อหาข้อความล่าสุดในบทสนทนา
`most_frequent_language` สตริง	ภาษาที่ตรวจพบบ่อยที่สุดในบทสนทนา
`assignee` ออบเจ็กต์	ผู้รับผิดชอบปัจจุบัน (`type`: `"ai_assistant"`, `"human_operator"` หรือ `"unassigned"`)
`visitor_name` สตริง หรือ null	ชื่อผู้เยี่ยมชม (จากแบบฟอร์มก่อนแชตหรือโปรไฟล์ในช่องทาง)
`visitor_email` สตริง หรือ null	ที่อยู่อีเมลของผู้เยี่ยมชม
`visitor_phone_number` สตริง หรือ null	หมายเลขโทรศัพท์ของผู้เยี่ยมชม
`visitor_label` สตริง หรือ null	ป้ายกำกับที่กำหนดเองสำหรับผู้เยี่ยมชม

ดึงรายละเอียดบทสนทนา

ขอบเขตสิทธิ์: 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()

การตอบกลับ 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
}

การตอบกลับรายละเอียดมีทุกฟิลด์ของการตอบกลับรายการ และเพิ่ม:

ฟิลด์	คำอธิบาย
`url` สตริง หรือ null	URL ของหน้าที่เริ่มบทสนทนา (เฉพาะวิดเจ็ต)
`client_metadata` ออบเจ็กต์ หรือ null	คู่คีย์และค่าที่กำหนดเองซึ่งแนบกับบทสนทนา
`last_visitor_message_at` สตริง	เวลาของข้อความล่าสุดจากผู้เยี่ยมชม
`unified_analysis` ออบเจ็กต์ หรือ null	การวิเคราะห์บทสนทนาที่ AI สร้าง (ดูด้านล่าง)

ฟิลด์ของ unified_analysis:

ฟิลด์	คำอธิบาย
`sentiment` สตริง	ความรู้สึกของบทสนทนาที่ AI ตรวจพบ (เช่น `"positive"`, `"neutral"`, `"negative"`)
`resolution_status` สตริง	สถานะการแก้ไขที่ AI ประเมิน (อาจต่างจาก `resolution_status` ระดับบนสุด)
`topic` สตริง	หัวข้อบทสนทนาที่ AI ตรวจพบ
`is_flagged` บูลีน	AI ตั้งค่าสถานะบทสนทนานี้ให้เจ้าหน้าที่ตรวจสอบหรือไม่
`flag_reason` สตริง หรือ null	เหตุผลที่ตั้งค่าสถานะบทสนทนา

ฟิลด์ resolution_status ระดับบนสุด ("open" หรือ "resolved") คือสถานะหลักที่กำหนดด้วยตนเองหรือโดยกฎอัตโนมัติ

unified_analysis.resolution_status คำนวณจากการวิเคราะห์ของ AI และอาจต่างกัน เช่น AI อาจจัดว่าบทสนทนาแก้ไขแล้วจากการวิเคราะห์เนื้อหา ทั้งที่สถานะระดับบนสุดยังเป็น "open" ใช้ฟิลด์ระดับบนสุดสำหรับกรองและจัดกระบวนการทำงาน ส่วน unified_analysis ใช้สำหรับการวิเคราะห์และข้อมูลเชิงลึก

ดึงเหตุการณ์ของบทสนทนา

ดึงเหตุการณ์ทั้งหมด (ข้อความ ลิงก์ที่ติดตาม บันทึก) ของบทสนทนา

ขอบเขตสิทธิ์: read_all

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

พารามิเตอร์การค้นหา

พารามิเตอร์	คำอธิบาย
`limit` จำนวนเต็ม	จำนวนรายการต่อหน้า
`offset` จำนวนเต็ม	จำนวนรายการที่จะข้าม

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

การตอบกลับ 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
}

ประเภทเหตุการณ์: message, tracked_link, log

ประเภทผู้เขียน: ai_assistant, visitor, human_operator

ฟิลด์	คำอธิบาย
`type` สตริง	ประเภทเหตุการณ์: `"message"`, `"tracked_link"` หรือ `"log"`
`data.id` สตริง	ตัวระบุข้อความที่ไม่ซ้ำ
`data.ord` จำนวนเต็ม	เลขลำดับข้อความ
`data.created_at` สตริง	เวลาของเหตุการณ์
`data.content` สตริง	เนื้อหาข้อความ
`data.author` สตริง	`"ai_assistant"`, `"visitor"` หรือ `"human_operator"`
`data.handoff_state` สตริง หรือ null	สถานะการส่งต่อ หากมี
`data.message_insights` ออบเจ็กต์ หรือ null	ข้อมูลเชิงลึกของข้อความที่ AI สร้าง
`data.feedback` ออบเจ็กต์ หรือ null	ความคิดเห็นของผู้ใช้ต่อข้อความ
`data.client_metadata` ออบเจ็กต์ หรือ null	เมทาดาทาที่กำหนดเองซึ่งแนบกับข้อความ
`data.sources_generated` อาร์เรย์	บทความในฐานความรู้ที่ AI ใช้สร้างคำตอบ
`data.is_welcome` บูลีน	เป็นข้อความต้อนรับหรือไม่
`data.attachments` อาร์เรย์	ไฟล์แนบ

การสนทนา

แสดงรายการบทสนทนา

ดึงรายละเอียดบทสนทนา

ดึงเหตุการณ์ของบทสนทนา

เริ่มต้นใช้งาน

AI Agent

Actions

บทสนทนา

Channels

เว็บไซต์ของคุณ

Helpdesk และ CRM

แอปส่งข้อความ

บัญชีและการเรียกเก็บเงิน

เริ่มต้นใช้งาน

การตั้งค่า

Knowledge Base

บทสนทนา