REST API และโทเค็น

นอกจากตัวสร้างแบบ Visual แล้ว GetMyBot ยังเปิดให้เข้าถึงด้วยโปรแกรม: คุณสามารถจัดการข้อมูลบอทผ่าน REST API ได้ โทเค็นมีสองประเภท ได้แก่ สำหรับเข้าถึงบอทเฉพาะตัว และ Personal Token (สำหรับระบบอัตโนมัติและการเชื่อมต่อระดับบัญชี)

API Token ของบอท

สร้างได้ที่ การตั้งค่า → API Token โทเค็นแต่ละตัวผูกกับบอทและอนุญาตให้เรียก REST Endpoint ของบอทนั้น (รีแอคชัน, ผู้ใช้, คอลเลกชัน, สถิติ ฯลฯ) โทเค็นแสดง ครั้งเดียว เมื่อสร้าง — บันทึกไว้ในที่ปลอดภัย รายการแสดงชื่อ, มาสก์ และวันที่สร้าง ลบโทเค็นที่ไม่ใช้แล้วออก

Personal Access Token (PAT)

Personal Access Token (PAT, ขึ้นต้นด้วย mbp_) ทำงานในระดับบัญชีและใช้สำหรับระบบอัตโนมัติและการเชื่อมต่อ สร้างได้ในพื้นที่ส่วนตัว ส่งผ่านใน Header Authorization: Bearer mbp_… โทเค็นมี Scope — ชุดสิทธิ์ในรูปแบบ ทรัพยากร:การกระทำ (เช่น reactions:read, bots:write) โดย * หมายถึงสิทธิ์เต็ม กำหนดวันหมดอายุได้ และโทเค็นจะถูกเก็บในรูปแบบแฮช เป็นวิธีที่สะดวกในการให้สคริปต์มีสิทธิ์เข้าถึงที่จำกัดโดยไม่ต้องเปิดเผยรหัสผ่าน

สิ่งที่เข้าถึงได้ผ่าน API

ผ่าน API จะเข้าถึงสิ่งเดียวกับที่มีในอินเทอร์เฟซ: บอทและการตั้งค่า, รีแอคชัน (รวมถึงการนำเข้า/ส่งออก), ผู้ติดตามและป้ายกำกับ, คอลเลกชันและระเบียน, สถิติและบันทึกคำร้อง, การกระจายข่าว สามารถสร้างแดชบอร์ด การซิงค์ข้อมูล และระบบอัตโนมัติของตัวเองบน GetMyBot ได้

ช่องทางและ WhatsApp

GetMyBot เป็นระบบหลายช่องทาง (Telegram + WhatsApp + VK) และช่องทางของบอทก็จัดการผ่าน REST ได้เช่นกัน ช่องทางและเทมเพลต WhatsApp ถูกควบคุมด้วย scope ที่ใช้ร่วมกัน bots:read / bots:write — ไม่มี scope ช่องทางแยกต่างหาก

  • GET /api/channels/capabilities — เมทริกซ์ความสามารถของช่องทาง (endpoint เซสชัน, ไม่ต้องใช้ scope PAT)
  • GET /api/bots/{botID}/channels (bots:read) — รายการช่องทางของบอท
  • POST /api/bots/{botID}/channels (bots:write) — เชื่อมต่อช่องทาง WhatsApp หรือ VK
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — ยกเลิกการเชื่อมต่อช่องทาง
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — แคตตาล็อกเทมเพลต WhatsApp ของช่องทาง
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — สร้างเทมเพลตและส่งไปยัง Meta เพื่อตรวจสอบ
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — ซิงค์แคตตาล็อกกับ Meta อีกครั้ง
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — แก้ไขเทมเพลต
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — ลบเทมเพลต
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — อัปโหลดตัวอย่างมีเดียหัวข้อ (รูปภาพ/วิดีโอ/เอกสาร)

Schema ของคำร้อง/การตอบกลับ, พารามิเตอร์ และตัวอย่างอยู่ใน เอกสาร API อ้างอิง

การเข้าถึงผ่านมือถือ

แพลตฟอร์มมีแอปมือถือพร้อมระบบการยืนยันตัวตนของตัวเอง (Access Token และ Refresh Token) และแดชบอร์ดสรุปบอท โดยใช้ Backend เดียวกัน

เอกสาร API อ้างอิง

เอกสาร API อ้างอิงแบบ Interactive ครบถ้วนสำหรับ API สาธารณะอยู่ที่หน้า เอกสาร API อ้างอิง: รวม Endpoint ทั้งหมดที่เข้าถึงได้ผ่าน PAT, พารามิเตอร์, Schema ของคำร้องและการตอบกลับ, Scope ที่จำเป็น และตัวอย่างคำร้องสำเร็จรูป (curl, JavaScript, Python) สามารถทดลองส่งคำร้องด้วยโทเค็นของคุณเองได้โดยตรงจากหน้านี้

ความปลอดภัย

  • โทเค็นแสดงเพียงครั้งเดียว เก็บไว้เป็นความลับ
  • ความลับของบอทและข้อมูลรับรองถูกเก็บในรูปแบบเข้ารหัส
  • การเปลี่ยนแปลงถูกบันทึกในบันทึกการตรวจสอบ

ขั้นตอนถัดไป