ห้อง (chats)

ห้องที่บอทอยู่

GET /v1/me/chats

curl -s https://api.sukson.dev/v1/me/chats -H "Authorization: Bearer $SUKSON_BOT_TOKEN"

{
  "chats": [
    {
      "chat_id": "0b6c3a52-5d0e-4c8e-9a51-6f1e7f6f2b10",
      "kind": "group",
      "title": "ชมรมเดินป่า",
      "visibility": "mentions",
      "status": "active"
    },
    {
      "chat_id": "7d2e9f10-3c4b-4a5d-8e6f-1a2b3c4d5e6f",
      "kind": "room",
      "title": "ห้องคุยเรื่องฟุตบอล",
      "visibility": "all",
      "status": "paused"
    }
  ]
}

ฟิลด์	คำอธิบาย
chat_id	id ของห้อง เท่ากับ chat.id ใน event ใช้ใน POST /v1/chats/{chat_id}/messages
kind	room (ห้องสาธารณะ), group (กลุ่ม) หรือ channel (ช่อง)
title	ชื่อห้อง อาจเป็น null
visibility	mentions (เห็นเฉพาะข้อความที่เรียกบอท) หรือ all (เห็นทุกข้อความ) เจ้าของห้องเป็นคนตั้ง
status	active, paused (เจ้าของหยุดบอทเฉพาะห้องนี้) หรือ banned (บอทถูกแบนจากห้องนี้)

บอทได้รับ event และส่งข้อความได้เฉพาะในห้องที่ status เป็น active การหยุดหรือแบนบอทในห้องหนึ่งไม่มีผลกับห้องอื่น

เพิ่มและถอนบอทจากห้อง

ใน v1 การเพิ่มบอทเข้าห้องทำได้ในแอปหรือเว็บ Sukson เท่านั้น (ที่หน้าข้อมูลห้อง โดยเจ้าของหรือแอดมินของห้อง) บอทอยู่ได้พร้อมกันกี่ห้อง ดูจาก entitlements.attachments_max ของ แพ็กเกจ

Endpoint ที่กำลังจะมา	ใช้ทำอะไร
GET /v1/chats/{chat_id}	ข้อมูลห้อง
GET /v1/chats/{chat_id}/members	รายชื่อสมาชิก (ชื่อและรูป ไม่มีอีเมลหรือ IP)
DELETE /v1/me/chats/{chat_id}	บอทออกจากห้องเอง
DELETE /v1/chats/{chat_id}/members/{user_id}, POST /v1/chats/{chat_id}/bans	ดูแลห้อง เมื่อเจ้าของห้องให้สิทธิ์บอท

ดูความคืบหน้าที่ บันทึกการเปลี่ยนแปลง