การโอนถ่ายงานสู่มนุษย์ (Human handoff)

ฟีเจอร์ Human handoff ช่วยให้นักพัฒนา Agent สามารถเชื่อมต่อกับระบบบริการลูกค้าของบุคคลที่สาม เพื่อรองรับการขอรับบริการจากมนุษย์โดยตรงจากผู้ใช้ Agent ปัจจุบันรองรับการเชื่อมต่อกับ Intercom, Webhook และวิธีการที่ยืดหยุ่นอื่น ๆ สำหรับการเชื่อมต่อระบบบริการลูกค้าเพิ่มเติม

วิธีเปิดใช้งาน Human handoff

1. ที่เมนู Agent Settings - Human handoff ให้คลิกปุ่ม "Enable" เพื่อเปิดใช้งาน Human handoff
2. เลือกระบบบริการลูกค้าที่ต้องการ รองรับ intercom, webhook ฯลฯ
3. กำหนดค่าการยืนยันตัวตนของระบบบริการลูกค้าบุคคลที่สามที่เลือก เพื่อให้สามารถสื่อสารข้อความได้สำเร็จ
4. ปรับแต่งการตั้งค่าที่เกี่ยวข้องกับ Human handoff ให้เหมาะสมกับสถานการณ์จริงขององค์กร
5. เริ่มต้นขอ Human handoff ในหน้าต่างสนทนา Agent เพื่อเรียกใช้งาน Human handoff ตามปกติ

โหมดบริการมนุษย์ (Human-Service Modes)

ฟีเจอร์ Human handoff รองรับ 2 โหมด คือ External Platform → Help-Desk และ Help-Desk → Help-Desk ยกตัวอย่างเช่น เมื่อระบบ help-desk คือ Intercom:

flowchart TD
    A["Human Handoff Feature"] --> B["Other to Help-Desk System"] & C["Help-Desk System to Help-Desk System"]
    B --> D["User initiates conversation from Agent-integrated channels"]
    D --> E["Platforms such as WhatsApp/Iframe/Widget/Share/LINE"] & G["Intercom Platform"]
    E --> F["Intercom help-desk system receives and processes"]
    G --> Q["Cannot be received or processed by Intercom system"]
    C --> H["User initiates request from help-desk system platform"]
    H --> I["Intercom Platform"] & K["Non-Intercom Platform"]
    I --> J["Intercom help-desk system receives and processes"]
    K --> L["Cannot be received or processed by Intercom system"]
     A:::Peach
     B:::Sky
     C:::Aqua
     D:::Sky
     E:::Sky
     G:::Sky
     F:::Sky
     Q:::Sky
     H:::Aqua
     I:::Aqua
     K:::Aqua
     J:::Aqua
     L:::Aqua
    classDef Sky stroke-width:1px, stroke-dasharray:none, stroke:#374D7C, fill:#E2EBFF, color:#374D7C
    classDef Aqua stroke-width:1px, stroke-dasharray:none, stroke:#46EDC8, fill:#DEFFF8, color:#378E7A
    classDef Peach stroke-width:1px, stroke-dasharray:none, stroke:#FBB35A, fill:#FFEFDB, color:#8F632D

ตั้งค่าการยืนยันตัวตน "Other to Help-Desk System"

ผู้ใช้สามารถขอบริการมนุษย์จากแพลตฟอร์มใดก็ได้ที่ Agent รองรับ และ help-desk system ที่เลือกจะเป็นผู้รับและจัดการคำขอเหล่านี้ ตัวอย่างเช่น:

• เมื่อผู้ใช้เริ่มต้นสนทนาและขอบริการมนุษย์ผ่าน WhatsApp, iframe, Widget, Share หรือ LINE ระบบ help-desk ของ Intercom จะรับและดำเนินการตามคำขอ
• หากผู้ใช้ขอบริการมนุษย์บนแพลตฟอร์ม Intercom โดยตรง ระบบ help-desk ของ Intercom จะไม่สามารถรับหรือดำเนินการในโหมดนี้

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

คู่มือการตั้งค่า Human handoff ผ่าน Intercom แบบละเอียด

1. สร้าง APPS
   อันดับแรก ลงทะเบียนที่ Intercom และทำตามคู่มือเพื่อสร้าง workspace ไปที่ Developer Hub ผ่าน "Account Avatar - Settings - APPS & INTEGRATIONS" คลิก "New app" เพื่อสร้างแอปพลิเคชัน หรือเลือกแอปที่มีอยู่เพื่อเข้าไปยังหน้าตั้งค่า
   
2. รับ AccessToken และกรอกใน GPTBots

• เลือกเมนู "Authentication" และคัดลอก Access token
  
• กรอก token ลงในช่อง Access token ใน "Human handoff - Intercom Authentication"
  
• กรอกที่อยู่รับข้อความ Human handoff ใน Intercom
  คัดลอก URL "GPTBots Message Receiving Address" และกรอกลงใน Endpoint URL ของเมนู Webhooks
  
• สมัครรับเหตุการณ์สำคัญใน Intercom
  ในหัวข้อ Topics ของ Webhooks ให้เลือก 4 เหตุการณ์ แล้วกด "save"
  • conversation.admin.closed
  • conversation.admin.replied
  • conversation.admin.snoozed
  • conversation.read

เมื่อเสร็จสิ้น Intercom configuration สามารถขอ Human handoff ในหน้าต่างสนทนา Agent ได้ เมื่อ Agent เรียก Human handoff สำเร็จ Help Desk ของ Intercom จะได้รับข้อความของผู้ใช้ และเมื่อคุณตอบกลับ การเชื่อมต่อ Human handoff จะเริ่มต้นอย่างเป็นทางการ

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

1. เข้าสู่ระบบ Livedesk Developer Console
2. ไปที่ผลิตภัณฑ์ Livedesk เลือก "Project Settings - API Management - API Key" และคัดลอก API Key และ API Secret
   
3. กรอกรหัสลับของโปรเจกต์ลงในช่อง "Access token" ที่ "GPTBots - Human Handoff - Other to Livedesk" แล้วบันทึกเพื่อเสร็จสิ้นการยืนยันตัวตน
   

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

คู่มือการตั้งค่าบริการ Human handoff ผ่าน Webhook

1. นักพัฒนาต้องสร้างบริการ Webhook ในเซิร์ฟเวอร์ของตนเอง โดยต้องมี 3 อินเทอร์เฟซสำหรับรับคำขอบริการมนุษย์และข้อความจาก Agent ดูรายละเอียดที่ Human Handoff Service - Webhook

   • Create Session: /conversation/establish
   • Chat: /chat
   • Close Session: /conversation/close

2. กำหนด URL, username, password ของ Webhook ใน Agent - Human Service configuration เพื่อให้ Agent ส่งข้อความไปยัง Webhook ได้
   

   URL Address: จำเป็น ใช้รับข้อความจากฝั่ง agent
   Username: ไม่จำเป็น ขึ้นอยู่กับบริการ webhook
   Password: ไม่จำเป็น ขึ้นอยู่กับบริการ webhook

3. เปิดใช้งาน API ใน "Agent-Integration-API" และกำหนด GPTBots message reception address เป็น URL ของ Webhook สำหรับส่งข้อความตอบกลับไปยัง Agent ดูรายละเอียดที่ Human Handoff Service - Webhook
   
   เมื่อเสร็จสิ้นการตั้งค่า Webhook สามารถขอบริการมนุษย์ในหน้าต่างสนทนา Agent ได้ เมื่อ Agent เรียก Human handoff สำเร็จ Webhook จะได้รับข้อความของผู้ใช้

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

1. นักพัฒนาต้องสร้างบัญชี livechat เพื่อรับ organization_id สร้างบัญชี livechat
   

2. นักพัฒนาต้องสร้าง APP, เพิ่ม Blocks, เลือก App Authorization และตั้งเป็น server-side app ในหน้านี้จะได้ clientId สร้าง APP
   

3. เพิ่ม Blocks เลือก APP webhook และกรอก GPTBots message receiving address ใน portal เป็น webhook url
   

4. เพิ่ม Blocks เลือก Chat webhook กรอก GPTBots message receiving address ใน portal เป็น webhook url เลือก incoming_event และ chat_deactivated
   
   

5. คลิก Private Installation เพื่อไปหน้าติดตั้ง APP
   

6. กรอก organization_id และ liveChatClientId ที่ได้มาก่อนหน้า แล้วกด OK เพื่อเสร็จสิ้นการตั้งค่า livechat
   

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

โปรดดูวิธีตั้งค่าที่ Sobot Integration Configuration โดย Sobot Human Services ใช้งานได้เฉพาะใน sobot widget

การยืนยันตัวตน Zoho Sales IQ

1. นักพัฒนาต้องเข้าสู่ระบบ Zoho และไปที่ Zoho API Console

   หมายเหตุ: หากบัญชีของคุณไม่ใช่ US region ให้เปลี่ยนโดเมน ดูรายละเอียดที่: Prerequisite - Generate Org OAuth Token

2. กรอกโดเมนบริการใน Homepage URL และใน Authorized Redirect URIs ให้กรอกโดเมน + /api/console/bot/zoho/salesiq/org/redirect คลิก CREATE หลังจากสร้างสำเร็จ ระบบจะสร้าง Client ID และ Client Secret ให้คัดลอก Client ID และ Client Secret เพื่อใช้ในการตั้งค่าบริการ
   
3. เข้าสู่ระบบ GPTBots กรอก Client ID และ Client Secret ที่ได้จาก Zoho API Console พร้อมระบุ Screen Name และเลือก Server Region
   • Client ID และ Client Secret: จำเป็น ต้องได้จากขั้นตอนก่อนหน้า
   • Screen Name: จำเป็น ดูจาก URL หลังโดเมน เช่น https://salesiq.zoho.com/gptbos/mychats/000000000000003 Screen Name คือ gptbots
   • Server Region: เลือกภูมิภาคของ Zoho
     กรอกข้อมูลครบแล้วคลิก Authorize
4. หลังคลิก Authorize จะมี popup ให้คลิก Accept
5. Public Key: ไม่จำเป็น หากเปิด "Secure your webhook" ใน Webhook config ต้องกรอก หากไม่เปิดไม่ต้องกรอก ดูวิธีที่: Zoho Sales IQ Integration Configuration
6. เลือกกลุ่มบริการลูกค้าที่เหมาะสม หลังเลือกแล้ว การสนทนาจะถูกโอนไปยังกลุ่มนั้น
   

   หมายเหตุ: ในกรณีนี้ bot จะไม่สามารถรับไฟล์ที่ส่งจากฝั่ง Zoho ได้

การตั้งค่า Human handoff

1. Human handoff
   
   Service Status: แสดงสถานะความพร้อมของระบบ Human handoff บุคคลที่สาม

• Not Configured: ยังไม่เคยกรอกข้อมูลยืนยันตัวตน
• Service Available: กรอกข้อมูลยืนยันตัวตนและตรวจสอบสำเร็จ
• Service Unavailable: กรอกข้อมูลยืนยันตัวตนแล้วแต่ล้มเหลว/หมดอายุ
  Trigger Timing: กำหนดข้อความ trigger timing ได้เอง เพื่อช่วยให้ LLM ตัดสินใจเรียก Human handoff ได้ถูกต้อง

2. กลไก Timeout
   Timeout Waiting: ค่าเริ่มต้น 60 วินาที คือเวลารอสูงสุดหลังจากผู้ใช้ขอ Human handoff หากเกินเวลาจะมีข้อความแจ้งเตือนผู้ใช้ให้เลือกสิ้นสุดหรือรอต่อ
   Session Timeout: ค่าเริ่มต้น 180 วินาที หากหลังจาก agent ฝั่งมนุษย์ตอบครั้งสุดท้ายแล้วไม่มีผู้ใช้ตอบกลับใน N วินาที ระบบจะออกจากโหมดบริการมนุษย์อัตโนมัติ
3. Human handoff Period
   
   รองรับการตั้งค่าช่วงเวลาบริการมนุษย์ได้สูงสุด 10 ช่วง

• Weekly: เลือกวันจันทร์ถึงอาทิตย์และกำหนดช่วงเวลาบริการมนุษย์ ระบบจะทำซ้ำทุกสัปดาห์
• Custom: เลือกวันที่แน่นอนและช่วงเวลาบริการมนุษย์ ระบบจะทำเพียงครั้งเดียว
  หากมีหลายช่วงเวลา:
• กรองกฎ "ช่วงเวลาบริการมนุษย์" ทั้งหมดในวันธรรมชาติ
• คำนวณช่วงเวลาที่กว้างที่สุดและกฎที่ทับซ้อนกัน หากไม่ทับซ้อนจะไม่นำมาคำนวณ
• หากมีหลายช่วงเวลาที่ไม่ทับซ้อนกัน จะมีหลายช่วงเวลาบริการมนุษย์ที่มีผลในวันนั้น

  ตัวอย่าง วันที่ 12 ธ.ค. 2024 มีกฎบริการ 4 ช่วง: 09:00 ~ 12:00, 10:00 ~ 12:00, 13:00 ~ 18:00, 15:00 ~ 17:00
  ช่วงเวลาที่ระบบจะถือว่าบริการได้จริงคือ: 09:00 ~ 12:00, 13:00 ~ 18:00

4. การตอบกลับนอกช่วงบริการ
   หากขอ Human service นอกช่วงเวลาบริการ ระบบจะตอบกลับด้วย "ข้อความที่ตั้งไว้ล่วงหน้า"
5. การส่งต่อเนื้อหาการสนทนา
   เมื่อเรียกใช้ระบบบุคคลที่สามสำเร็จ จะส่ง N รอบประวัติแชท + คำถามล่าสุดของผู้ใช้ ไปยังระบบ Human handoff

การเริ่มต้นขอบริการมนุษย์

1. ผู้ใช้ขอ Human handoff
   เมื่อผู้ใช้ต้องการ Human handoff, LLM จะตัดสินใจว่าจะเรียก Human handoff หรือไม่ หากเรียก Human handoff จะขออีเมลผู้ใช้ หากระบบมีอีเมลแล้ว จะข้ามขั้นตอนนี้และเริ่ม Human handoff ทันที
   
   • หากผู้ใช้ล็อกอินและยืนยันอีเมลแล้ว ระบบจะมีข้อมูลอีเมล
   • หากนักพัฒนาตั้งค่าอีเมลผ่าน window.ChatBot.setEmail("somebody@mail.com") ใน bubble component ระบบจะมีข้อมูลอีเมล
   • หากนักพัฒนาตั้งค่าอีเมลผ่าน iframe_url + ?email=somebody@mail.com ใน iframe ระบบจะมีข้อมูลอีเมล
2. เมื่อระบบ Human handoff บุคคลที่สามได้รับข้อความและตอบกลับข้อความแรก เซสชัน Human handoff จะเริ่มต้นอย่างเป็นทางการ
3. ผู้ใช้สามารถส่งข้อความกับระบบ Human handoff ได้ไม่จำกัด ทั้งผู้ใช้และเจ้าหน้าที่บริการมนุษย์สามารถปิดการสนทนา Human handoff ได้ทุกเมื่อ

เชื่อมต่อกับระบบบริการลูกค้าบุคคลที่สาม เช่น Intercom, Webhook, LiveChat ฯลฯ ฟีเจอร์ข้างต้นใช้ได้ทั้งหมด

ตั้งค่าการยืนยันตัวตน "Help-Desk System to Help-Desk System"

ในโหมดนี้ ผู้ใช้สามารถขอบริการมนุษย์ได้เฉพาะจากแพลตฟอร์ม help-desk system เท่านั้น และ help-desk system เดิมจะเป็นผู้รับและดำเนินการ ตัวอย่างเช่น:

• เมื่อผู้ใช้เริ่มสนทนาและขอบริการมนุษย์บน Intercom ระบบ help-desk ของ Intercom จะรับและดำเนินการ
• หากผู้ใช้ขอบริการมนุษย์จากแพลตฟอร์มอื่นที่ไม่ใช่ Intercom ระบบ help-desk ของ Intercom จะไม่สามารถรับหรือดำเนินการในโหมดนี้

Intercom to Intercom

โปรดดูวิธีตั้งค่าที่ Intercom Integration Guide

Zoho Sales IQ to Zoho Sales IQ

โปรดดูวิธีตั้งค่าที่ Zoho Sales IQ Integration Configuration

หมายเหตุ: ในกรณีนี้ เนื่องจากข้อจำกัดของโมเดล OpenAI-GPT-4o-mini อาจมีปัญหาในการเรียกใช้บริการมนุษย์ แนะนำให้ใช้โมเดลอื่น

Livechat to Livechat

โปรดดูวิธีตั้งค่าที่ Livechat Integration Guide

Livedesk to Livedesk

โปรดดูวิธีตั้งค่าที่ Livedesk Integration Guide