การให้บริการแบบแมนนวล

เมื่อผู้พัฒนาเลือก Webhook เป็นวิธีการเชื่อมต่อบริการแบบแมนนวล จะต้องสร้างบริการ Webhook ในเซิร์ฟเวอร์ของตนเองก่อน ผู้พัฒนาต้องจัดเตรียม 3 อินเทอร์เฟซตามข้อกำหนด เพื่อรับคำขอบริการแบบแมนนวล ข้อความจากผู้ใช้ และข้อความตอบกลับจากเจ้าหน้าที่บริการลูกค้ามนุษย์ GPTBots ยังมี 2 อินเทอร์เฟซสำหรับรับข้อความตอบกลับจากเจ้าหน้าที่บริการลูกค้าและคำสั่งปิดการสนทนา

หมายเหตุสำคัญ:

1. ผู้พัฒนาต้องตรวจสอบให้แน่ใจว่าบริการ Webhook ของตนทำงานได้ถูกต้อง เพราะส่งผลโดยตรงต่อการให้บริการช่วยเหลือโดยมนุษย์

• หากขึ้นว่า "Busy" หลังจากเริ่มต้นการขอรับบริการโดยมนุษย์ แสดงว่าบริการ Webhook ของผู้พัฒนา ทำงานผิดปกติ
• หากขึ้นว่า "Connecting" หลังจากเริ่มต้นการขอรับบริการโดยมนุษย์ แสดงว่าบริการ Webhook ของผู้พัฒนา ทำงานปกติ

2. หลังจากเริ่มต้นคำขอบริการช่วยเหลือโดยมนุษย์สำเร็จ:

• ผู้พัฒนาต้องเรียกใช้อินเทอร์เฟซ Reply to User Message (https://api.gptbots.ai/v1/human/message/receive) เพื่อส่งข้อความตอบกลับผู้ใช้อย่างน้อย 1 ข้อความ เพื่อสร้างการเชื่อมต่อสนทนา
• หากผู้พัฒนาไม่ตอบกลับข้อความของผู้ใช้ภายในช่วง waiting timeout ที่ตั้งไว้ (ค่าเริ่มต้น 60 วินาที) การสนทนาแบบช่วยเหลือโดยมนุษย์จะสิ้นสุดโดยอัตโนมัติ

รับการแจ้งเตือนคำขอสนทนาบริการมนุษย์

เมื่อผู้ใช้ปลายทางเริ่มต้นขอรับบริการมนุษย์ GPTBots จะส่งต่อคำขอนี้ไปยังบริการ Webhook ของผู้พัฒนา หากบริการอินเทอร์เฟซของผู้พัฒนาตอบกลับด้วยรหัสสถานะ 200 หมายถึงการสร้างสนทนาบริการมนุษย์สำเร็จ

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

POST

Endpoint

https://your_domain/conversation/establish

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

                      
                      curl -X POST 'https://YOUR_DOMAIN/human/service/conversation/establish' \
-H 'Content-Type: application/json' \
-d '{
  "body": [
    {
      "text": "human service",
      "message_type": "QUESTION"
    },
    {
      "text": "",
      "message_type": "ANSWER"
    }
  ],
  "timestamp": 1742265090895,
  "email": "bob@gmail.com",
  "conversation_id": "67d8db020fa31d1ef64f53dg",
  "bot_id": "665d88b03ce2b13cf2d573454",
  "user_info": {
    "phone": null,
    "email": "bob@gmail.com",
    "user_id": "KDslas",
    "anonymous_id": "652face5184b30540a6ea7fe"
  }
}'

                    

หมายเหตุ: conversation_id ใน request body นี้ใช้เพื่อระบุรหัสเฉพาะของสถานการณ์สนทนาบริการมนุษย์ ซึ่งแตกต่างจากรหัสเฉพาะที่สร้างโดย Create Conversation ID สำหรับสถานการณ์สนทนา Agent

พารามิเตอร์ของคำขอ

หมายเหตุเกี่ยวกับฟิลด์ email:

• เมื่อเริ่มต้นบริการแมนนวลผ่าน iframe/Share/Bubble Widget ผู้ใช้ต้องกรอกอีเมล นักพัฒนาสามารถกำหนดอีเมลผู้ใช้เองเพื่อเลี่ยงการบังคับกรอกอีเมลได้
• เมื่อขอบริการแมนนวลผ่านแพลตฟอร์ดภายนอก เช่น WhatsApp/Telegram/livechat อีเมลเริ่มต้นคือ support@gptbots.ai สำหรับ livechat นักพัฒนาสามารถกำหนดอีเมลผู้ใช้เองได้
• เมื่อขอบริการแมนนวลผ่าน API ฟิลด์ email สามารถเว้นว่างได้ หากว่างจะใช้อีเมลเริ่มต้น support@gptbots.ai

การตอบกลับ

อินเทอร์เฟซสนทนา

โดยใช้ conversation_id ที่สร้างขึ้น ส่งข้อความของผู้ใช้ไปยังเจ้าหน้าที่บริการลูกค้าแมนนวล

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

POST

Endpoint

https://your_domain/chat

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

                      
                      {
  "conversation_id": "conv_xxx",
  "message_id": "msg_abc124",
  "create_time": 1750000005000,
  "agent_id": "bot_xxx",
  "body": "นี่คือภาพหน้าจอคำสั่งซื้อของฉัน",
  "timestamp": 1750000005200,
  "files": [
    {
      "content_type": "Image",
      "url": "https://files.gptbots.ai/xxx/order.png",
      "name": "order.png",
      "format": "png"
    }
  ]
}

                    

พารามิเตอร์ของคำขอ

การตอบกลับ

อินเทอร์เฟซปิดการสนทนา

เมื่อการสนทนาของผู้ใช้หมดเวลา หรือ Agent หรือผู้ใช้ปิดการสนทนาเอง จะเรียกใช้อินเทอร์เฟซนี้เพื่อปิดการสนทนา

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

POST

Endpoint

https://your_domain/conversation/close

Request Header

พารามิเตอร์ของคำขอ

การตอบกลับ

ตอบกลับข้อความผู้ใช้

เมื่อผู้พัฒนาเลือก webhook เป็นวิธีเชื่อมต่อบริการมนุษย์ GPTBots จะมีอินเทอร์เฟซสำหรับตอบกลับข้อความผู้ใช้ อินเทอร์เฟซนี้ช่วยให้เจ้าหน้าที่บริการลูกค้ามนุษย์ส่งข้อความกลับไปยังผู้ใช้ได้

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

POST

Endpoint

https://api-${endpoint}.gptbots.ai/v1/human/message/receive

Request Header

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

                      
                      {
  "conversation_id": "conv_xxx",
  "timestamp": 1750000000000,
  "body": "นี่คือใบแจ้งหนี้ที่คุณขอ",
  "files": [
    { "content_type": "Document", "url": "https://your-cdn.com/files/invoice.pdf", "name": "invoice.pdf", "format": "pdf" },
    { "content_type": "Image", "url": "https://your-cdn.com/files/screenshot.png", "name": "screenshot.png", "format": "png" }
  ]
}

                    

พารามิเตอร์ของคำขอ

การตอบกลับ

เจ้าหน้าที่บริการลูกค้าแมนนวลปิดการสนทนา

เมื่อผู้พัฒนาเลือก webhook เป็นวิธีเชื่อมต่อบริการแมนนวล เจ้าหน้าที่บริการลูกค้าที่ให้บริการโดย GPTBots สามารถปิดการสนทนาได้เองเมื่อจำเป็น หลังจากปิดแล้ว ผู้ใช้จะไม่ได้รับข้อความจากเจ้าหน้าที่บริการลูกค้าอีก เว้นแต่ผู้ใช้จะเริ่มต้นสนทนาแบบบริการลูกค้าแมนนวลใหม่อีกครั้ง

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

POST

Endpoint

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

Request Header

พารามิเตอร์ของคำขอ

การตอบกลับ

การตรวจสอบสถานะบริการ GPTBots

GPTBots มีอินเทอร์เฟซตรวจสอบสุขภาพ (health-check) สำหรับตรวจสอบบริการมนุษย์ของตนเอง นักพัฒนาสามารถเรียกใช้อินเทอร์เฟซนี้เพื่อตรวจสอบว่าบริการมนุษย์ของ GPTBots พร้อมใช้งานหรือไม่ หากอินเทอร์เฟซคืน HTTP status code 200 และ response body เป็นตัวระบุข้อความล้วน (plain text) ที่บอกว่าบริการปกติ (เช่น service is normal) แสดงว่าบริการมนุษย์ของ GPTBots พร้อมใช้งาน อินเทอร์เฟซนี้ไม่ต้องตรวจสอบสิทธิ์และคืนค่าเป็นข้อความล้วน

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

GET

Endpoint

https://api.gptbots.ai/v1/human/health

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

                      
                      curl -X GET 'https://api.gptbots.ai/v1/human/health'

                    

การตอบกลับ

เมื่อบริการ GPTBots พร้อมใช้งาน จะคืน HTTP status code 200 และ response body เป็นตัวระบุข้อความล้วนที่บอกว่าบริการปกติ

                      
                      service is normal

                    

คำแนะนำในการประเมินความพร้อมใช้งาน

ผู้เรียกใช้เพียงใช้ HTTP status code เป็นเกณฑ์การตัดสินเท่านั้น:

แนะนำให้ตั้งค่า timeout ของคำขออย่างเหมาะสม (เช่น 3-5 วินาที) และตรวจสอบด้วยความถี่คงที่ (QPM:3) อินเทอร์เฟซนี้ไม่ต้องตรวจสอบสิทธิ์ จึงไม่ต้องแนบ API Key