ข้ามไปยังเนื้อหา
Preview: API ยังอยู่ระหว่างเปิดใช้ รายละเอียดอาจเปลี่ยนก่อนเปิดจริง ดูความคืบหน้าที่ บันทึกการเปลี่ยนแปลง

Sukson Messaging APIv1 Preview

สร้างบอทให้ห้องแชท Sukson

บอททำงานบนเซิร์ฟเวอร์ของคุณ Sukson ส่งข้อความที่เรียกบอทมาให้ แล้วบอทตอบกลับด้วย HTTP และ JSON ธรรมดา

Base URLhttps://api.sukson.dev/v1

POST/v1/chats/{chat_id}/messages
ส่งข้อความเข้าห้อง
curl -X POST \
https://api.sukson.dev/v1/chats/$CHAT_ID/messages \
-H "Authorization: Bearer $SUKSON_BOT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"messages":[{"type":"text","text":"สวัสดีครับ"}]}'
คำตอบ 200 OK
{
"messages": [
{
"message_id": 812346,
"chat_id": "0b6c3a52-5d0e-4c8e-9a51-6f1e7f6f2b10",
"created": true
}
]
}

ทำงานอย่างไร

บอทตัวแรกใน 3 ขั้น

  1. สร้างบอท

    สร้างบอทที่ member.sukson.com/bots แล้วเก็บ API token (ขึ้นต้นด้วย skbot_) ไว้ให้ดี ระบบแสดงให้ดูครั้งเดียว

    วิธีสร้างบอท
  2. รับ webhook

    webhook คือ URL บนเซิร์ฟเวอร์ของคุณ เมื่อมีคนเรียกบอท Sukson จะส่งข้อความนั้นมาที่ URL นี้เป็น JSON พร้อมลายเซ็น

    รูปแบบ event
  3. ตอบกลับ

    ตอบ {"reply": "..."} ได้ทันทีภายใน 10 วินาที หรือตอบ 200 ไปก่อน แล้วค่อยส่งข้อความผ่าน API

    ส่งข้อความ

สิ่งที่ได้

ออกแบบให้ใช้ง่ายและตรวจสอบได้

เอกสาร

ลองเรียก API ครั้งแรก

ใช้ token ของบอทเรียก GET /v1/me ถ้าได้ข้อมูลบอทกลับมา แปลว่าพร้อมแล้ว

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