การดึงค่าอัตราการโอน Agent ไปยังคนจริง

ดึงจำนวนการสนทนา จำนวนการสนทนาที่โอนให้คนจริง และอัตราการโอนของ Agent ในช่วงเวลาที่กำหนด โดยวิธีการคำนวณสอดคล้องกับหน้าแดชบอร์ด «Agent Insights → อัตราการโอนไปยังคนจริง»

หมายเหตุ: สามารถดึงข้อมูลได้สูงสุด 92 วัน; นับเฉพาะช่องทางในพื้นที่พัฒนาที่กำหนด ขอบเขตการคำนวณดูได้ที่ «เกณฑ์การคำนวณ» ด้านล่าง

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

GET

ที่อยู่สำหรับเรียกใช้งาน

https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/human-handoff

การยืนยันการเรียกใช้งาน

ใช้การยืนยัน Basic ด้วย DevKey / DevSecret ระดับบัญชี: Authorization: Basic ${BASIC_TOKEN} โดยที่ ${BASIC_TOKEN} คือรหัส Base64 ของ DevKey:DevSecret

บัญชีที่เรียกใช้งานต้องเป็นสมาชิกขององค์กร org_id และมีสิทธิ์ «ดูการใช้งาน» (Owner หรือผู้ดูแลองค์กรมีสิทธิ์โดยค่าเริ่มต้น) และต้องสามารถดู Agent ดังกล่าวได้: ผู้สร้าง Agent, Owner ขององค์กร, หรือสมาชิกที่ได้รับสิทธิ์สำหรับ Agent ดังกล่าว (หรือทุก Agent)
โปรดเรียกใช้งานจากศูนย์ข้อมูลขององค์กรที่สังกัดอยู่ ${endpoint} เลือกจาก รายการองค์กร โดยใช้ region (SG → sg, TH → th, JP → jp) หากเรียกจากศูนย์ข้อมูลอื่นจะขึ้นข้อความว่า «ไม่ใช่สมาชิกขององค์กรนี้»

ความถี่ในการเรียกใช้งาน

DevKey แต่ละชุดสามารถเรียก API นี้ได้สูงสุด 60 ครั้งต่อนาที
แต่ละครั้งที่เรียกใช้งานจะถูกนับร่วมในโควต้าประเภท «API สถิติ» ของแพ็กเกจองค์กร ตลอดจนแชร์โควต้ากับการเรียก API ประเภทสถิติด้วย Agent API Key
ผลลัพธ์การค้นหาจะถูกแคชไว้ 10 นาที แนะนำให้เรียกใช้งานทุกชั่วโมง

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

ตัวอย่างคำขอ

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/human-handoff?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1790784000000' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/human-handoff?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1790784000000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

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

หัวข้อคำขอ

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Basic ${BASIC_TOKEN}	ใช้ Basic Token หลังจากเข้ารหัส Base64 ของ `DevKey:DevSecret`

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

ฟิลด์	ประเภท	ต้องระบุ	คำอธิบาย
org_id	String	ใช่	ID ขององค์กร
agent_id	String	ใช่	Agent ID ไม่รองรับ Workflow
start_time	Long	ใช่	เวลาเริ่มต้น เป็น timestamp มิลลิวินาที ขยายไปยัง 0 นาฬิกาของวันตามเขตเวลาองค์กร
end_time	Long	ใช่	เวลาเสร็จสิ้น (ไม่รวม) เป็น timestamp มิลลิวินาที ใช้วันธรรมชาติของมิลลิวินาทีก่อนหน้าตามเขตเวลาองค์กร เป็นวันสุดท้าย วันที่เริ่มต้นและสิ้นสุดสามารถข้ามได้ไม่เกิน 92 วัน

การตอบกลับ

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

{ "code": 0, "message": "OK", "data": { "agent_id": "65f0c2a1b4e8d93a1c7e5b21", "timezone": "+08:00", "range_start_date": "2026-09-01", "range_end_date": "2026-09-29", "data_until": 1790665200000, "conversation_count": 1200, "handoff_conversation_count": 96, "handoff_rate": 0.0800 } }

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "agent_id": "65f0c2a1b4e8d93a1c7e5b21",
        "timezone": "+08:00",
        "range_start_date": "2026-09-01",
        "range_end_date": "2026-09-29",
        "data_until": 1790665200000,
        "conversation_count": 1200,
        "handoff_conversation_count": 96,
        "handoff_rate": 0.0800
    }
}

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

การตอบกลับที่ประสบความสำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
agent_id	String	รหัส Agent
timezone	String	เขตเวลาขององค์กร (ส่วนต่าง UTC เช่น `+08:00`) ระบุวันที่ตามเขตเวลาใด
range_start_date	String	วันที่เริ่มต้นของสถิติจริง `yyyy-MM-dd` (ตามเขตเวลาองค์กร รวมถึงวันเริ่มต้น)
range_end_date	String	วันที่สิ้นสุดของสถิติจริง `yyyy-MM-dd` (ตามเขตเวลาองค์กร รวมถึงวันสิ้นสุด)
data_until	Long	เวลาที่เก็บข้อมูลสถิติ (เวลาแบบมิลลิวินาที): หากในช่วงมีวันที่คำนวณแบบเรียลไทม์ จะเป็นเวลาที่คำนวณของข้อมูลเรียลไทม์ (ผลลัพธ์ถูกเก็บแคชไม่เกิน 10 นาที); หากช่วงทั้งหมดผ่านการคำนวณรายวันแล้ว จะเป็นวันที่สิ้นสุดของช่วง
conversation_count	Long	จำนวนการสนทนาที่เกิดขึ้นในช่วง (สะสมตามวัน)
handoff_conversation_count	Long	จำนวนการสนทนาที่ถูกโอนให้เจ้าหน้าที่มนุษย์
handoff_rate	Number	อัตราการโอน = `handoff_conversation_count` ÷ `conversation_count`, 0 ถึง 1, กำหนดทศนิยม 4 หลัก; หากจำนวนการสนทนาเป็น 0 จะเป็น `null`

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

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

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

รหัสสถานะ HTTP เป็นตัวเลข 3 หลักแรกของรหัสข้อผิดพลาด เช่น 40000 คือ 400, 40100 คือ 401, 403132 คือ 403 |

รหัสข้อผิดพลาด	คำอธิบาย
40000	ข้อผิดพลาดของพารามิเตอร์ เช่น ขาดพารามิเตอร์ที่จำเป็น หรือค่าพารามิเตอร์ไม่ถูกต้อง
40001	เรียกใช้งานบ่อยเกินไป: คีย์นักพัฒนานี้เกินขีดจำกัดต่อนาทีของ API นี้
40008	เกินโควต้าต่อนาทีของ "API ประเภทสถิติ" ในแพ็กเกจขององค์กร
40010	API ปิดชั่วคราว กรุณาลองใหม่ในภายหลัง
40100	ไม่มีสิทธิ์: ขาดสิทธิ์ในการดูปริมาณการใช้งาน หรือไม่มีสิทธิ์ดู Agent นี้ (รวมถึง Agent ที่ไม่อยู่ในองค์กร)
40105	ไม่ใช่สมาชิกขององค์กรนี้ หรือเรียกใช้จากที่อยู่ของศูนย์ข้อมูลอื่น
40324	DevKey หรือ DevSecret ผิดพลาด
40378	Agent ถูกลบแล้ว
403132	ช่วงเวลาผิดพลาด: เวลาเริ่มต้นไม่ก่อนเวลาสิ้นสุด หรือเกินขอบเขตการค้นหาสูงสุด

ขอบเขตการสถิติ

จำนวนการสนทนา: จำนวนการสนทนาที่เกิดขึ้นในแต่ละวัน สะสมตามวัน การสนทนาที่ต่อเนื่องข้ามวันจะถูกนับในแต่ละวัน |
จำนวนการสนทนาที่โอนไปยังเจ้าหน้าที่: จำนวนการสนทนาที่ถูกโอนไปยังเจ้าหน้าที่ |
ขอบเขตการนับสถิติ: นับเฉพาะช่องทางในพื้นที่นักพัฒนารวมถึง API, หน้าแชร์, การฝังเว็บ, ส่วนขยายฟองสบู่, LiveDesk และช่องทางการสื่อสารทันทีและโทรศัพท์; ไม่รวมการใช้งาน Agent หลังจากเผยแพร่ไปยังพื้นที่ทำงาน |
ความถี่ในการอัปเดต: วันที่ที่มีสถิติประจำวันเสร็จสิ้นอ่านโดยสถิติประจำวัน; คำนวณแบบเรียลไทม์ในวันปัจจุบัน สถิติประจำวันสร้างโดยงานสถิติหลังเที่ยงคืนในโซนเวลาขององค์กร ก่อนสร้างเสร็จ สถิติของวันก่อนหน้านั้นยังคำนวณแบบเรียลไทม์ จะไม่มีกรณีที่ "เมื่อวาน" เป็น 0 หลังเที่ยงคืน |
ขอบเขตของส่วนเรียลไทม์: นับตามเวลาของการสนทนาครั้งล่าสุด การสนทนาที่ต่อเนื่องข้ามวันจะนับครั้งเดียวในส่วนเรียลไทม์ (นับตามวันที่การสนทนาล่าสุด) ซึ่งอาจแตกต่างเล็กน้อยกับสถิติประจำวันที่สะสมตามวัน