การเชื่อมต่อ

การเชื่อมต่อเชื่อมบอทกับบริการภายนอก การเชื่อมต่อแต่ละรายการคือการตั้งค่าที่บันทึกไว้ (พร้อม secret ที่เข้ารหัส) ซึ่งใช้โดยการดำเนินการรีแอคชันต่อไป ส่วนนี้อยู่ที่ การเชื่อมต่อ ในเมนูด้านซ้าย; ปุ่ม เพิ่มการเชื่อมต่อ, สวิตช์เชื่อมต่อ และปุ่ม ตั้งค่า บนแต่ละการ์ด

บริการที่ใช้งานได้

  • AI — language model (OpenAI-compatible API) ดู AI ตอบกลับ
  • Google Sheets — เพิ่มแถวในตาราง
  • Google Drive — อัปโหลดไฟล์ไปยังโฟลเดอร์
  • GetCourse — ส่งผู้ใช้และ deal ไปยัง GetCourse
  • Webhook — ส่งข้อมูลผ่าน HTTP ไปยังบริการใดก็ได้
  • External handler — เชื่อมต่อ backend ของตัวเองผ่าน WebSocket: รีแอคชันประมวลผลโดยเซิร์ฟเวอร์ของคุณ ดู External handler

การตั้งค่า

เมื่อเพิ่มเลือก บริการ กำหนด ชื่อ และฟิลด์การตั้งค่าตามประเภท:

Webhook

  • URL ของ webhook — ที่อยู่ตัวรับ
  • HMAC signature (secret) — สำหรับตรวจสอบความถูกต้อง; คำขอลงนามด้วย header X-Signature: sha256=...

GetCourse

  • บัญชี และ Secret key
  • Object — «ผู้ใช้» หรือ «Deal»

Google Sheets

  • ID ตาราง และ ช่วง
  • JSON ของ service account (secret) — key ของ Google service account

Google Drive

  • ID โฟลเดอร์
  • JSON ของ service account (secret)

AI

  • Base URL, โมเดล, System prompt, API key (secret) รายละเอียดเพิ่มเติม — AI ตอบกลับ

External handler

การเชื่อมต่อ WebSocket: เซิร์ฟเวอร์ของคุณเชื่อมต่อกับ GetMyBot และประมวลผลรีแอคชัน โดยตอบกลับด้วยคำสั่งในรูปแบบ Telegram Bot API

  • WebSocket address — ที่อยู่ที่บริการของคุณเชื่อมต่อ
  • Connection token (secret) — แสดงครั้งเดียวเมื่อสร้าง; มีปุ่มออกใหม่

รายละเอียด protocol และตัวอย่างบริการ — External handler

การใช้งานในรีแอคชัน

  • AI และ Webhook ใช้งานได้ทันทีเป็นการดำเนินการ/ช่องทาง: เพิ่มการดำเนินการ AI หรือส่งข้อมูลด้วยการดำเนินการ Web request ไปยังที่อยู่ webhook
  • การดำเนินการ GetCourse, Google Sheets, Google Drive ใน constructor ของรีแอคชันระบุว่า «เร็วๆ นี้» — การเชื่อมต่อเองสามารถตั้งค่าได้แล้ว

ความปลอดภัย

คำขอขาออกทั้งหมดผ่านการป้องกัน SSRF (ห้ามเข้าถึง internal network) และการตอบกลับถูกจำกัดขนาด Secret ของการเชื่อมต่อจัดเก็บในรูปแบบที่เข้ารหัส

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