เอกสาร API—sem.chat|REST API สำหรับนักพัฒนา

เริ่มต้นใช้งาน

sem.chat API ช่วยให้คุณสามารถจัดการการสนทนา ส่งข้อความ และเข้าถึงการวิเคราะห์โดยทางโปรแกรม คำขอ API ทั้งหมดต้องมีการตรวจสอบสิทธิ์โดยใช้คีย์API

https://api.sem.chat/v1

รวมคีย์API ของคุณในส่วนหัวการอนุญาตของคำขอทั้งหมด:

Authorization: Bearer your_api_key_here

GET /conversations

ดึงรายการการสนทนาทั้งหมดสำหรับบัญชีของคุณ

พารามิเตอร์	พิมพ์	คำอธิบาย
ขีด จำกัด	จำนวนเต็ม	จำนวนผลลัพธ์ที่จะส่งคืน (สูงสุด 100)
ชดเชย	จำนวนเต็ม	จำนวนผลลัพธ์ที่จะข้าม
สถานะ	เชือก	กรองตามสถานะ: ใช้งานอยู่, ปิด, รอดำเนินการ

GET /conversations/{id}

รับรายละเอียดของการสนทนาเฉพาะรวมถึงข้อความทั้งหมด

POST /conversations

เริ่มการสนทนาใหม่โดยทางโปรแกรม

POST /conversations/{id}/messages

ส่งข้อความถึงการสนทนาที่มีอยู่

// Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}

ตั้งค่า webhooks เพื่อรับการแจ้งเตือนแบบเรียลไทม์เกี่ยวกับกิจกรรมการสนทนา

เหตุการณ์	คำอธิบาย
การสนทนาเริ่มต้นแล้ว	การสนทนาใหม่ได้เริ่มต้นขึ้นแล้ว
ข้อความ.ได้รับ	ได้รับข้อความใหม่จากผู้เยี่ยมชม
การสนทนา.ปิดแล้ว	การสนทนาถูกปิด
ตะกั่วถูกจับ	ข้อมูลการติดต่อถูกเก็บรวบรวม

คำขอ API ถูกจำกัดเพื่อให้แน่ใจว่ามีการใช้งานที่เหมาะสม: