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

เมื่อผู้พัฒนาเลือก 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

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

การตอบกลับ

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

เมื่อการสนทนาของผู้ใช้หมดเวลา หรือ 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

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

การตอบกลับ

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

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

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

POST

Endpoint

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

Request Header

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

การตอบกลับ