ดูรายละเอียดการสนทนา

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

วิธีการร้องขอ

GET

URL สำหรับร้องขอ

https://api-${endpoint}.gptbots.ai/v1/messages

การยืนยันตัวตน

ดูรายละเอียดการยืนยันตัวตนได้ที่หน้า API Overview

การร้องขอ

ตัวอย่างการร้องขอ

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/messages?conversation_id=xxxxxx&user_id=123456&page=1&page_size=100' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/messages?conversation_id=xxxxxx&user_id=123456&page=1&page_size=100' \
-H 'Authorization: Bearer ${API Key}'

บล็อกโค้ดนี้ในหน้าต่างลอย

Request Headers

ชื่อฟิลด์	ประเภท	คำอธิบาย
Authorization	Bearer ${API Key}	ใช้ Authorization: Bearer ${API Key} สำหรับการยืนยันตัวตน สามารถรับ API Key ได้จากหน้า API Key

พารามิเตอร์ในการร้องขอ

ชื่อฟิลด์	ประเภท	จำเป็น	คำอธิบาย
conversation_id	string	ใช่	รหัสการสนทนา
page	int	ใช่	หมายเลขหน้าที่ต้องการดึงข้อมูล
page_size	int	ใช่	จำนวนผลลัพธ์ต่อหน้า สูงสุด 100 รายการ

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "total": 100, "messages": [ { "message_id": "645dd86906931c4a9e0ffb1f", "parent_message_id": "", "message_type": "ANSWER", "text": "สวัสดีค่ะ ฉันคือ customer service agent กรุณาสอบถามได้เลยค่ะ", "create_time": 1683871849906 }, { "message_id": "745dd86906931c4a9e0ffb1f", "parent_message_id": "645dd86906931c4a9e0ffb1f", "message_type": "QUESTION", "text": "ฟีเจอร์ของ JPush มีอะไรบ้าง?", "create_time": 1683871849906 }, { "message_id": "845dd86906931c4a9e0ffb1f", "parent_message_id": "745dd86906931c4a9e0ffb1f", "message_type": "ANSWER", "text": "JPush เป็นแพลตฟอร์มที่ทรงพลัง...", "create_time": 1683871849906 } ] }

                      
                      {
  "total": 100,
  "messages": [
    {
      "message_id": "645dd86906931c4a9e0ffb1f",
      "parent_message_id": "",
      "message_type": "ANSWER", 
      "text": "สวัสดีค่ะ ฉันคือ customer service agent กรุณาสอบถามได้เลยค่ะ",
      "create_time": 1683871849906
    },
    {  
      "message_id": "745dd86906931c4a9e0ffb1f",
      "parent_message_id": "645dd86906931c4a9e0ffb1f",
      "message_type": "QUESTION",
      "text": "ฟีเจอร์ของ JPush มีอะไรบ้าง?",
      "create_time": 1683871849906
    },
    {
      "message_id": "845dd86906931c4a9e0ffb1f",
      "parent_message_id": "745dd86906931c4a9e0ffb1f",
      "message_type": "ANSWER",
      "text": "JPush เป็นแพลตฟอร์มที่ทรงพลัง...",
      "create_time": 1683871849906
    }
  ] 
}

บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับสำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
total	string	จำนวนข้อความทั้งหมดในบทสนทนา
messages	JSON Array	รายละเอียดข้อความแต่ละรายการ
message_id	string	รหัสข้อความที่ไม่ซ้ำกัน
parent_message_id	string	รหัสข้อความต้นทาง (ถ้ามี)
message_type	string	ประเภทข้อความ ANSWER หรือ QUESTION
text	string	เนื้อหาข้อความ
create_time	long	เวลาที่สร้างข้อความ (timestamp)

การตอบกลับล้มเหลว

ฟิลด์	ประเภท	คำอธิบาย
code	int	รหัสข้อผิดพลาด
message	string	รายละเอียดข้อผิดพลาด

รหัสข้อผิดพลาด

รหัส	ข้อความ
40000	พารามิเตอร์ไม่ถูกต้อง
40005	หมายเลขหน้ามากกว่าจำนวนหน้าทั้งหมด
40127	ยืนยันตัวตนล้มเหลว
40356	ไม่พบการสนทนา
20059	ลบ Agent แล้ว