โปรเจกต์และช่องทาง
สร้างโปรเจกต์ เชื่อมต่อบอทและตรวจสอบสถานะ รวมถึงหลายช่องทาง การเปลี่ยนโทเค็น การพักใช้งาน และการกู้คืนบอทที่ถูกระงับตามแพ็กเกจ
บนหน้านี้
โปรเจกต์ รวมการตั้งค่า รีแอคชัน และข้อมูลของบอทหรือบริการหนึ่งอย่างไว้ด้วยกัน ช่องทาง เชื่อมโปรเจกต์กับสถานที่พูดคุย เช่น บอท Telegram แชทบนเว็บไซต์ หรือแอปส่งข้อความอื่น โรงเรียนหนึ่งแห่งอาจมีโปรเจกต์เดียว แต่เชื่อมทั้ง Telegram และเว็บไซต์
สร้างโปรเจกต์ที่หน้า โปรเจกต์ แล้วเพิ่มช่องทาง หากใช้ Telegram ต้องมีโทเค็นจาก @BotFather ซึ่งเป็นกุญแจสำหรับจัดการบอท สลับโปรเจกต์ได้ที่ด้านบนของหน้า
คุณยังเชื่อม WhatsApp และ VK กับโปรเจกต์เดียวกันได้ และใช้รีแอคชันชุดเดียวกัน ดูภาพรวมที่ ช่องทาง และวิธีเชื่อมต่อที่ WhatsApp
เชื่อมต่อบอท
- หากยังไม่มีโปรเจกต์ ให้เปิด โปรเจกต์ แล้วกด เพิ่มโปรเจกต์ จากนั้นกด เพิ่มช่องทาง บนการ์ดโปรเจกต์และเลือก Telegram สำหรับบอทตัวแรก คุณใช้ขั้นตอนแนะนำการเริ่มต้นได้
- วางโทเค็นจาก @BotFather แล้วกด ตรวจสอบ GetMyBot จะแสดง
@usernameที่พบ เพื่อให้ตรวจสอบว่าโทเค็นถูกต้อง - กด เชื่อมต่อ โทเค็นจะถูก เข้ารหัส ขณะจัดเก็บ และเริ่มรับเหตุการณ์ทันที
เมื่อเชื่อมแล้ว Telegram จะปรากฏบนการ์ดโปรเจกต์ข้างช่องทางอื่น ๆ การ์ดแสดงชื่อโปรเจกต์ @username ของบอท จำนวนผู้ใช้ รีแอคชันที่ใช้งาน และคำขอวันนี้ ดูยอดคำขอคงเหลือใน การเรียกเก็บเงิน หรือ สถิติ
จัดการหลายบอท
บัญชีหนึ่งดูแลหลายโปรเจกต์และหลายบอทพร้อมกันได้ จำนวนจำกัดตามแพ็กเกจของคุณในค่า “จำนวนบอทสูงสุด” สลับโปรเจกต์จากด้านบนหรือหน้า โปรเจกต์ ส่วน “รีแอคชัน” “แชท” และ “สถิติ” จะแสดงข้อมูลของโปรเจกต์ที่เลือก
บอทรับข้อความอย่างไร
หลังเชื่อมต่อ GetMyBot รับเหตุการณ์จาก Telegram เช่น ข้อความ การกดปุ่ม การเข้าร่วมแชท และการชำระเงินเอง ไม่ต้องตั้งค่าการรับแยก หากโทเค็นยังใช้ได้ Telegram อาจส่งเหตุการณ์มาที่อยู่ของแพลตฟอร์มผ่าน webhook หรือแพลตฟอร์มอาจถาม Telegram เป็นระยะผ่าน long polling ขึ้นอยู่กับการตั้งค่าเซิร์ฟเวอร์
เปิดและปิดบอท
บอทแต่ละตัวมีสถานะ เปิด / ปิด ในการ์ด สถานะบอท ที่หน้าการตั้งค่า บอทที่ปิดอยู่จะไม่ตอบข้อความ การเปลี่ยนสถานะมีผลทันทีโดยไม่ต้องเชื่อมต่อใหม่
สถานะโปรเจกต์และช่องทาง
ในหน้า โปรเจกต์ สถานะของโปรเจกต์แสดงแยกเป็น ใช้งานอยู่ หยุดชั่วคราว หรือ ถูกระงับ สถานะนี้ไม่ได้ยืนยันว่า Telegram ส่งข้อความได้ แต่ละช่องทางมีป้ายของตัวเอง ได้แก่ ออนไลน์ ไม่มีสัญญาณ ตั้งค่าแล้ว ปิดใช้งาน หรือ โปรเจกต์ไม่ทำงาน ดังนั้นโปรเจกต์ที่ยังใช้งานและมีเพียงแชทบนเว็บ ไม่ควรถูกแสดงว่าหยุดทำงานเพราะไม่มี Telegram
หากโปรเจกต์ที่ใช้งานมีช่องทาง Telegram ที่เปิดอยู่เพียงช่องทางเดียว ออนไลน์ หมายถึงกระบวนการที่ดูแลบอทเพิ่งรายงานว่ายังทำงานอยู่ หากไม่มีรายงานใหม่จะแสดง ไม่มีสัญญาณ ถ้ามี Telegram หลายช่องทางที่เปิดอยู่ จะแสดง ตั้งค่าแล้ว เพราะรายงานของโปรเจกต์ไม่สามารถระบุได้แน่ชัดว่ามาจากช่องทางไหน สำหรับช่องทางแพลตฟอร์มอื่น ตั้งค่าแล้ว หมายถึงเชื่อมต่อแล้ว ไม่ใช่รับประกันว่าทุกข้อความจะส่งถึง
แพลตฟอร์มมีกระบวนการหลายตัวที่ทำหน้าที่เหมือนกัน แต่ละตัวรายงานการทำงานของบอทที่ดูแลทุก 30 วินาที รายงานมีอายุ หนึ่งนาทีครึ่ง เพื่อไม่ให้สถานะเปลี่ยนไปมาเมื่อขาดรายงานเพียงครั้งเดียว
สิ่งที่ควรทราบ:
- ป้ายสถานะอาจมาช้า หลังเชื่อมต่อหรือเริ่มแพลตฟอร์มใหม่ “ออนไลน์” อาจยังไม่ปรากฏจนกว่าจะครบช่วงเวลาข้างต้น
- หาก Telegram ที่เปิดอยู่แสดง ไม่มีสัญญาณ นานเกินสองสามนาที ให้ตรวจโทเค็นและการ์ด Bot health ในการตั้งค่า โปรเจกต์ยังคงใช้งานอยู่จนกว่าคุณจะหยุดชั่วคราวหรือแพลตฟอร์มระงับตามแพ็กเกจ
- รายงานการทำงานใช้ร่วมกันระหว่างกระบวนการ ไม่ขึ้นกับว่าเซิร์ฟเวอร์ตัวใดตอบหน้าเว็บ และถ้ามีหลายช่องทาง Telegram ก็ไม่ได้ยืนยันความพร้อมของแต่ละช่องทางแยกกัน
เมื่อบอทออฟไลน์จะเกิดอะไรขึ้น
แพลตฟอร์มตรวจรายงานการทำงานทุกนาที หากบอทที่เปิดอยู่ไม่มีรายงานใหม่เลย จะเปิด บันทึกเหตุขัดข้อง ตรวจหาสาเหตุ แล้วพยายามกู้คืนบอท
สาเหตุมีสี่แบบและดูได้ในการ์ด Bot health:
- webhook: Telegram ส่งเหตุการณ์มายังที่อยู่แพลตฟอร์มไม่ได้ แพลตฟอร์มจึงลงทะเบียนที่อยู่ใหม่
- โทเค็นถูกเพิกถอน:
getMeตอบ 401 การเริ่มบอทใหม่แก้ปัญหานี้ไม่ได้ ต้องออกโทเค็นใหม่ใน @BotFather แล้วกรอกผ่าน เปลี่ยนโทเค็น - ไม่มีเซิร์ฟเวอร์ดูแล: ไม่มีตัวประมวลผลเหตุการณ์ แพลตฟอร์มจึงเริ่มบอทใหม่
- ยังระบุสาเหตุไม่ได้: Telegram ไม่ตอบการตรวจสอบ
การเริ่มใหม่ทำงานเหมือนปุ่ม ซิงค์ คือทดสอบโทเค็นด้วย getMe และลงทะเบียน webhook ใหม่ ระบบเว้นช่วงนานขึ้นเรื่อย ๆ ระหว่างความพยายาม เวลา ผลสำเร็จหรือข้อผิดพลาดของแต่ละครั้งจะอยู่ใน Restart log พร้อมเวลาที่จะลองครั้งถัดไป
หากไม่มีรายงานการทำงานนานกว่าค่าที่กำหนดในการ์ด Bot health (ค่าเริ่มต้น 5 นาที) เจ้าของ จะได้รับแจ้งเตือนผ่านกระดิ่งและอีเมลว่า “บอทออฟไลน์” ส่วนแชทในรายชื่อผู้รับแจ้งเตือนจะได้รับข้อความจากบอท ระบบแจ้งครั้งเดียวต่อเหตุขัดข้อง เมื่อบอทกลับมาทำงาน จะส่ง “บอทกลับมาออนไลน์” พร้อมระยะเวลาที่หยุดไป ประวัติเหตุขัดข้อง ระยะเวลา และสาเหตุยังดูได้ในการ์ดเดิม
การระงับบอทตามแพ็กเกจ
นอกจากเปิดและปิด บอทอาจมีสถานะ ถูกระงับ ได้ แพลตฟอร์มเป็นผู้ระงับเมื่อแพ็กเกจปัจจุบันรองรับจำนวนบอทที่เชื่อมอยู่ไม่พอ มีสองสาเหตุเท่านั้น:
- เกินจำนวนบอทที่กำหนด: คุณเปลี่ยนเป็นแพ็กเกจที่รองรับบอทน้อยกว่าจำนวนที่เชื่อมอยู่
- ไม่ได้ต่ออายุสมาชิก: แพ็กเกจแบบเสียเงินสิ้นสุดและกลับมาใช้แพ็กเกจฟรีที่มีขีดจำกัดของตัวเอง
บอทที่ถูกระงับไม่รับข้อความ เพราะการรับเหตุการณ์ถูกปิดจริง ไม่ใช่แค่เปลี่ยนป้ายสถานะ ข้อมูล รีแอคชัน และผู้ติดตามยังอยู่ครบ จึงกู้คืนได้
วิธีกู้คืน: ชำระแพ็กเกจที่รองรับจำนวนบอทที่ต้องการ เมื่อแพ็กเกจใหม่มีผล บอทจะกลับมาทำงานอัตโนมัติ เริ่มจากตัวที่เชื่อมมานานที่สุด จนเต็มขีดจำกัด เลือกโดยตรงไม่ได้ว่าจะให้ตัวใดกลับมาก่อน หากต้องการบอทตัวอื่น ให้ลบการเชื่อมต่อที่ไม่ต้องการก่อนแล้วค่อยชำระแพ็กเกจ
การระงับ ทั้งบัญชี เป็นอีกกรณีหนึ่ง บอททั้งหมดและการส่งข้อความกลุ่มจะหยุดพร้อมกัน และมีแบนเนอร์ “บัญชีถูกระงับ” ในหน้าเว็บ ต้องติดต่อ ฝ่ายสนับสนุน เพื่อปลดระงับ ดู การชำระเงินและยอดคงเหลือ เพิ่มเติม
โปรไฟล์และการซิงค์
ปุ่ม ซิงค์ ในการตั้งค่าจะอัปเดตชื่อบอทจาก Telegram หากคุณเปลี่ยนชื่อใน @BotFather รูปโปรไฟล์ของบอทจะถูกดึงมาโดยอัตโนมัติ
เปลี่ยนโทเค็น
หากคุณออกโทเค็นใหม่ใน @BotFather (Bot Settings → Revoke / New token) ให้อัปเดตใน การตั้งค่า → ช่องทาง → Telegram 🔑 โทเค็นใหม่ต้องเป็นของ บอทเดียวกัน (ตรงกันด้วย ID ภายในของ Telegram) — รีแอคชัน ผู้ติดตาม และข้อมูลทั้งหมดจะถูกเก็บไว้ หากไม่แสดงช่อง Telegram ให้เลือก «เปลี่ยนโทเค็น» ในหน้าต่างเดียวกัน
โอนบอทไปบัญชีอื่น
การตั้งค่าโปรเจกต์ → เปลี่ยนเจ้าของ จะส่ง คำเชิญ โอนโปรเจกต์ไปยังอีเมลบัญชี GetMyBot อื่น คำเชิญมีอายุ 72 ชั่วโมง ก่อนผู้รับยอมรับ โปรเจกต์ยังอยู่ในบัญชีของคุณและคุณยกเลิกคำเชิญได้ เมื่อผู้รับยอมรับ เจ้าของจะเปลี่ยนและคุณจะเข้าถึงโปรเจกต์ไม่ได้ ใช้เมื่อส่งมอบงานให้ลูกค้าหรือเพื่อนร่วมงาน
เทมเพลตบอท
เทมเพลตคือภาพเก็บ การตั้งค่าบอทและรีแอคชันทั้งหมด ซึ่งนำไปใช้กับบอทอื่นได้:
- สร้างเทมเพลต ในการตั้งค่า บันทึกบอทปัจจุบันเป็นเทมเพลตที่ตั้งชื่อไว้
- ใช้เทมเพลต แทนที่การตั้งค่าของบอทเป้าหมายด้วยค่าจากเทมเพลต และ เพิ่ม รีแอคชันจากเทมเพลตเข้าไปในรายการเดิม
เหมาะเมื่อทำบอทรูปแบบเดียวกันให้หลายโปรเจกต์
ติดตั้งโซลูชันสำเร็จรูปจากแค็ตตาล็อก
แค็ตตาล็อกโซลูชันสำเร็จรูปมีตัวช่วยติดตั้ง กรอกค่าที่ต้องใช้ ตรวจความเข้ากันได้และการเชื่อมต่อที่จำเป็น แล้วดูรายการสิ่งที่จะถูกสร้าง หลังติดตั้ง ให้ทำขั้นตอนที่เหลือและทดสอบสถานการณ์ด้วยคำขอตัวอย่าง
ตัวช่วยนี้ต่างจากการใช้ภาพเก็บบอทในหัวข้อก่อนหน้า การตรวจก่อนติดตั้งบอกว่าขาดค่าหรือความสามารถใดบ้าง การทำเครื่องหมายว่าขั้นตอนเสร็จแล้วไม่ได้ยืนยันว่าบริการภายนอกทำงานจริง
ตัวชี้วัดของโซลูชันสำเร็จรูป
เลือกช่วงเวลาที่ต้องการประเมินโซลูชันที่ติดตั้ง หากต้องการเปรียบเทียบ ให้เลือกวิธีที่มีให้ แล้วตรวจขนาดกลุ่มตัวอย่างและข้อมูลวิเคราะห์ ข้อมูลไม่พอหรือไม่มีตัวเปรียบเทียบ ไม่เหมือนกับผลลัพธ์ที่มีค่าเป็นศูนย์
ขั้นตอนถัดไป
- การตั้งค่า ทีม และสิทธิ์: พฤติกรรม บทบาท เทมเพลต และโทเค็น API
- รีแอคชัน: พื้นฐาน: สร้างพฤติกรรมบอท
- นำเข้าจาก sambot: ย้ายบอทที่มีอยู่
- การชำระเงินและยอดคงเหลือ: แพ็กเกจและจำนวนบอทสูงสุด