รีแอคชัน: พื้นฐาน
สอนให้บอทตอบคำสั่ง ปุ่ม หรือเหตุการณ์อื่น พร้อมวิธีสร้างรีแอคชัน จัดลำดับ และเชื่อมขั้นตอนเข้าด้วยกัน
บนหน้านี้
รีแอคชัน คือกฎการทำงานหนึ่งข้อของบอท เช่น “เมื่อผู้ใช้พิมพ์ /price ให้ส่งราคาสินค้า” หรือ “เมื่อชำระเงินแล้ว ให้ติดป้าย ‘ชำระแล้ว’ และให้สิทธิ์เข้าถึง”
ตั้งค่าเหตุการณ์ เงื่อนไข และการกระทำได้ในส่วน รีแอคชัน บอทตรวจดูกฎจากบนลงล่างแล้วทำข้อแรกที่ตรงกัน จึงควรวางกฎเฉพาะไว้เหนือกฎทั่วไปที่ตอบทุกข้อความ
รีแอคชันประกอบด้วยอะไรบ้าง
สำหรับตัวอย่างราคาสินค้า เพียงเลือกคำสั่ง /price แล้วเพิ่มข้อความราคาก็พอ ส่วนการตั้งค่าอื่นใช้เมื่อต้องการให้กฎทำงานเฉพาะคนหรือแชท ตัวแก้ไขมีสี่ส่วน:
| ส่วน | ใช้ตอบคำถาม | ตัวอย่าง |
|---|---|---|
| ทริกเกอร์ | เริ่มเมื่อใด: ข้อความ คำสั่ง สื่อ ปุ่ม เหตุการณ์ หรือกำหนดเวลา | ผู้ใช้พิมพ์ /price |
| ในแชท | ทำงานที่ไหน: แชทส่วนตัว การเรียกบอทในกลุ่ม หรือแชทที่กำหนด โดยดูสถานะผู้ใช้ด้วย | เฉพาะแชทส่วนตัว |
| เงื่อนไข | ตรวจเพิ่ม: ป้ายกำกับ พารามิเตอร์ เวลา หรือจำนวนข้อความ | ผู้ใช้มีป้าย “ชำระแล้ว” |
| การดำเนินการ | ให้บอททำอะไร: ส่งข้อความ เปลี่ยนป้ายกำกับ บันทึกข้อมูล หรือเรียก AI | ส่งราคาสินค้า |
สร้างและแก้ไข
กด สร้างรีแอคชัน หรือเปิดรีแอคชันเดิม ด้านบนมี ชื่อ ที่ต้องกรอก หมายเลข #N คำอธิบาย และสวิตช์ ใช้งานอยู่ ด้านซ้ายเป็นส่วน ทริกเกอร์ / ในแชท / เงื่อนไข / การดำเนินการ ตรงกลางเป็นฟอร์ม และด้านขวาแสดงตัวอย่างข้อความ Telegram พร้อมบล็อก ปุ่ม และเมนู กด บันทึก เมื่อเสร็จ
หลังบันทึก ตัวแก้ไขยังแสดงจำนวนครั้งที่ทำงาน กราฟ และเหตุการณ์ล่าสุด
ประวัติการแก้ไขและการกู้คืน
เปิด Change history ในรีแอคชันที่บันทึกแล้ว คุณจะเห็นการแก้ไข 20 ครั้งล่าสุด เวลา ผู้แก้ไข แหล่งที่มาของการแก้ไข และความต่างใน Before / After สามารถคืนค่าเป็นสถานะ ก่อนการแก้ไขที่เลือก ได้ โดยดูความต่างก่อนแล้วยืนยัน
การกู้คืนจะแทนที่การแก้ไขที่ยังไม่บันทึก และถูกบันทึกเป็นรายการใหม่ในประวัติด้วย มันคืนค่าการตั้งค่ารีแอคชัน แต่ไม่เรียกคืนข้อความที่ส่งไปแล้วหรือยกเลิกการเปลี่ยนข้อมูล หากคนอื่นแก้รีแอคชันระหว่างที่คุณดูตัวอย่าง ให้โหลดความต่างใหม่
ลำดับและความสำคัญ
ในมุมมอง ลำดับที่กำหนดเอง คุณลากรีแอคชันเพื่อเปลี่ยนลำดับได้เมื่อไม่ได้ค้นหา เปิดตัวกรอง หรือเลือกโฟลเดอร์ ลำดับเป็นตัวกำหนดความสำคัญ เมื่อเกิดเหตุการณ์ บอททำรีแอคชัน แรก ที่ตรง แล้วหยุดตรวจ หากต้องการให้ตรวจรีแอคชันอื่นต่อ ให้เพิ่มการกระทำ รีแอคชันถัดไป (goto_next)
ค้นหา กรอง และจัดกลุ่ม
เหนือรายการมีช่องค้นหาชื่อหรือหมายเลขรีแอคชัน และตัวกรองดังนี้:
- สถานะ: ทั้งหมด เปิดใช้งาน หรือปิดใช้งาน
- สร้างตั้งแต่ / สร้างถึง: เลือกวันตามเขตเวลาของคุณ โดยนับรวมทั้งวันเริ่มและวันสิ้นสุด
- ลำดับ: ลำดับที่กำหนดเอง ใหม่สุดก่อน หรือเก่าสุดก่อน
- การจัดกลุ่ม: ตามวันหรือเดือนที่สร้าง ใช้ได้เฉพาะการเรียงตามวันที่ หากเปิดการจัดกลุ่มขณะอยู่ในลำดับที่กำหนดเอง รายการจะเปลี่ยนเป็น “ใหม่สุดก่อน” หากเลือกเรียง “ใหม่สุดก่อน” หรือ “เก่าสุดก่อน” อยู่แล้ว การเรียงนั้นจะคงเดิม เมื่อกลับเป็นลำดับที่กำหนดเอง การจัดกลุ่มจะปิด
ตัวกรองใช้กับรีแอคชันทั้งหมด ไม่ใช่เฉพาะหน้าปัจจุบัน และใช้ร่วมกับการค้นหาและโฟลเดอร์ได้ ตัวเลขนับแสดงผลที่พบ ค่าตัวกรองอยู่ใน URL ของหน้า จึงรีเฟรช ส่งลิงก์ หรือใช้ปุ่ม “ย้อนกลับ” เพื่อกลับมาได้ รีเซ็ตตัวกรอง จะล้างการค้นหา ตัวกรอง ลำดับ และการจัดกลุ่ม แต่คงโฟลเดอร์ที่เลือกไว้
การกรองและเรียงลำดับเปลี่ยนเพียงการแสดงรายการ ไม่เปลี่ยนลำดับที่บอทใช้ตรวจจริง
เปิดและปิด
สวิตช์บนแถวรายการ หรือ ใช้งานอยู่ ในตัวแก้ไข เปิดและปิดรีแอคชันได้โดยไม่ลบ รีแอคชันที่ปิดจะถูกข้าม
ทำสำเนาและลบ
ปุ่ม ทำสำเนา ในแถวรายการสร้างรีแอคชันอีกอัน ส่วน ลบ ใช้ลบ เหมาะเมื่อต้องการทำกฎคล้ายเดิมแต่แก้เพียงเล็กน้อย
นำเข้าและส่งออก
ใช้ ส่งออก ในตัวแก้ไขเพื่อบันทึกรีแอคชันเป็น JSON และใช้ นำเข้า ในรายการเพื่อนำกลับเข้า ช่วยย้ายรีแอคชันระหว่างบอทหรือเก็บเวอร์ชันนอกแพลตฟอร์ม
ส่งรีแอคชันให้ผู้ติดตาม
ปุ่ม การกระจายข่าว รูปส่งในแถวรีแอคชันจะส่งรีแอคชันนี้ให้ผู้ติดตามบอทที่ใช้งานอยู่ เหมาะกับประกาศและการแจ้งเตือน คุณจำกัดกลุ่มผู้รับด้วยป้ายกำกับได้ ดู การส่งข้อความกลุ่ม
เชื่อมรีแอคชันเป็นบทสนทนา
ตัวอย่างเช่น รีแอคชันแรกแสดงสินค้า ปุ่มเปิดรีแอคชันที่สองพร้อมข้อมูลสินค้า แล้วถามที่อยู่จัดส่ง วิธีเชื่อมแต่ละขั้นมีดังนี้:
- รีแอคชันแบบต่อเนื่อง (
chain): เรียกรีแอคชันอื่นระหว่างทำงาน - รีแอคชันถัดไป (
goto_next): ส่งต่อให้รีแอคชันถัดไปในรายการที่ตรงกับเหตุการณ์ - ขั้นตอนบทสนทนา: บล็อกข้อความ รอคำตอบ พร้อมตรวจรูปแบบ และหยุดสถานการณ์ชั่วคราว ดู ข้อความและปุ่ม
- สาขา “มิฉะนั้น”: เมื่อเงื่อนไขไม่ผ่าน ให้เรียกรีแอคชันอื่นจากส่วน “เงื่อนไข”
- เลือกขั้นตอนถัดไป (
branch_result): แยกผลค้นหาว่าง หนึ่งรายการ หลายรายการ หรือผลไม่ครบ - เลือกขั้นตอนตามค่า (
branch_value): เช่น เมื่อได้updatedให้ยืนยันคำขอ แต่เมื่อได้conflictให้ตรวจสถานะอีกครั้ง - ผลของการกระทำ: หากการกระทำนั้นรองรับ ให้ไปรีแอคชันแยกสำหรับสำเร็จ ขัดแย้ง ไม่พบรายการ หรือผิดพลาด ดู วิธีเลือกสาขา
- Call block (
call_block): ส่งข้อมูลเข้าไปยังการคำนวณร่วม แล้วรับผลลัพธ์ที่กำหนดกลับมาในรีแอคชันเดิม ดู คลังบล็อกและเวอร์ชัน
หากทำงานกับข้อมูล อาจต่อ ค้นหาในคอลเลกชัน → เลือกขั้นตอนถัดไป → ปุ่ม → ค้นหาระเบียนที่เกี่ยวข้อง หากรายการมาจากบริการภายนอก ใช้ ประมวลผลรายการ → กลุ่มและผลรวม ตั้งชื่อผลลัพธ์ของแต่ละการกระทำ แล้วเลือกชื่อนั้นในขั้นถัดไป
แบบฝึกหัดเชิงปฏิบัติ แสดงทั้งสองเส้นทางด้วยตัวอย่างชั้นเรียนและคำขอ
ขณะตั้งค่า ให้เลือก ข้อมูลจากขั้นก่อนหน้า แทนการจำชื่อฟิลด์เอง ก่อนบันทึก ทดสอบร่างปัจจุบัน ด้วยข้อมูลตัวอย่างเพื่อตรวจสาขาและข้อความที่คาดว่าจะส่ง หลังบันทึก ให้ลองเส้นทางผู้ใช้ผ่านบอทและช่องทางที่เชื่อมจริงอีกครั้ง เพราะตอนนั้นการกระทำจริงจะทำงาน
ขั้นตอนถัดไป
- ทริกเกอร์: เหตุการณ์ที่เริ่มการทำงาน
- เงื่อนไขและแชท: ตัวกรองและขอบเขต
- การดำเนินการ: รายการการกระทำทั้งหมด
- ข้อความและปุ่ม: สร้างคำตอบ