คอลเลกชันและข้อมูล
เก็บคำขอ คำสั่งซื้อ และการจองไว้ใน GetMyBot ด้วยคอลเลกชันและนำข้อมูลไปใช้ในรีแอคชัน
บนหน้านี้
คอลเลกชัน คล้ายตาราง หนึ่งแถวแทนคำขอ คำสั่งซื้อ หรือการจองหนึ่งรายการ บอตเพิ่มแถวจากคำตอบของผู้ใช้ได้ และคุณเปิดดูหรือแก้ไขใน ข้อมูล → คอลเลกชัน ได้ เช่น สร้าง leads มีฟิลด์ name, phone, topic แล้วให้บอตบันทึกชื่อ เบอร์ และเรื่องที่ต้องการปรึกษาหลังถามคำถามครบ
คอลเลกชันคืออะไร
ฟิลด์ คือคอลัมน์ เช่น «โทรศัพท์» หรือ «หัวข้อ» ระเบียน คือข้อมูลหนึ่งแถว รายชื่อฟิลด์พร้อมชนิดข้อมูลเรียกว่าโครงสร้างของคอลเลกชัน ระเบียนเก็บเป็นเอกสาร JSON จึงเพิ่มฟิลด์ใหม่โดยไม่ต้องสร้างแถวเดิมอีกครั้ง
ชื่อคอลเลกชันต้องไม่ซ้ำภายในบอตหนึ่งตัว และใช้เป็นรหัสในรีแอคชัน เช่น leads, orders, scores
ชนิดของฟิลด์
| ชนิด | เก็บข้อมูล | ตัวอย่าง |
|---|---|---|
text | ข้อความ | ชื่อ อีเมล ความคิดเห็น |
number | ตัวเลข | ยอดเงิน จำนวน คะแนน |
bool | ใช่หรือไม่: true / false | ชำระเงินแล้วหรือยัง |
datetime | วันที่และเวลา | เวลาจองคลาส |
json | ข้อมูลซ้อนกันหรือรายการ | รายการสินค้าในคำสั่งซื้อ |
ชนิดข้อมูลกำหนดวิธีแก้ไขในหน้าจอและวิธีแปลงค่าตอนบันทึก โครงสร้างไม่บังคับอย่างเข้มงวด หากระเบียนมีฟิลด์ที่ไม่อยู่ในรายการ ฟิลด์นั้นก็ถูกบันทึกและแสดงเป็นคอลัมน์ใหม่
สร้างคอลเลกชัน
- เปิด ข้อมูล → คอลเลกชัน แล้วกด เพิ่ม
- ตั้งชื่อด้วยตัวอักษรละตินโดยไม่มีช่องว่าง เพื่อใช้อ้างอิงในรีแอคชันได้ง่าย
- กด ฟิลด์ เพื่อเพิ่มคอลัมน์และเลือกชนิดของแต่ละฟิลด์
- ตั้งกฎเก็บข้อมูลตามต้องการแล้วบันทึก
ดูและแก้ไขระเบียน
ปุ่มรูปตารางบนการ์ดคอลเลกชันเปิดหน้าต่าง ข้อมูล ซึ่งทำสิ่งต่อไปนี้ได้:
- ดู: แสดงแถวทั้งหมดโดยเริ่มจากแถวใหม่ที่สุด
- เพิ่มระเบียน: เปิดแบบฟอร์มตามฟิลด์ที่ตั้งไว้ เช่น สวิตช์สำหรับ
boolและช่อง JSON สำหรับjson - แก้ไข ด้วยปุ่มรูปดินสอ: เปลี่ยนแถวที่มีอยู่
- ลบ ด้วยปุ่มรูปถังขยะ: ลบแถว
รีแอคชันของบอตเพิ่มและแก้ไขระเบียนในคอลเลกชันเดียวกันได้
ระยะเวลาจัดเก็บ (retention)
เพื่อไม่ให้ข้อมูลเพิ่มไปเรื่อย ๆ ตั้งกฎล้างข้อมูลอัตโนมัติได้:
- จัดเก็บสูงสุดจำนวนระเบียน: เมื่อเกินจำนวน จะลบแถวที่เก่าที่สุด
- จัดเก็บไม่เกิน (วัน): ลบแถวที่เก่ากว่าจำนวนวันที่กำหนด
ตัวอย่างเช่น บันทึกชั่วคราวอาจเก็บ 30 วัน การล้างทำเป็นระยะ ไม่ได้เกิดตรงวินาทีที่ครบกำหนด ใช้สองกฎพร้อมกันได้ อย่ากำหนดอายุให้คำสั่งซื้อที่ยังต้องใช้งาน
ใช้ข้อมูลในรีแอคชัน
- สร้างบันทึก: เพิ่มแถวจากค่าที่แทนลงไป เช่น
{{user_id}}และ{{text}}คีย์ป้องกันข้อมูลซ้ำช่วยให้การเรียกซ้ำด้วยคีย์เดิมอัปเดตแถวเดิม เช่น เก็บคำขอล่าสุดหนึ่งรายการต่อผู้ใช้ - อัปเดตบันทึก: แก้แถวที่ตรงเงื่อนไข
- ค้นหาบันทึก: อ่านหลายแถวเข้าไปเป็นรายการในบริบทของรีแอคชัน
- Read collection page (
record_page): อ่านทีละหน้า เช่น สองการ์ดพร้อมปุ่มหน้าถัดไป - Aggregate whole collection (
record_aggregate): นับหรือรวมข้อมูลจากระเบียนทั้งหมดที่ตรงเงื่อนไขภายใต้กฎจัดเก็บ ไม่ได้จำกัดอยู่ที่หน้าแรกที่โหลด - Atomic collection transaction (
collection_transaction): ตรวจเงื่อนไขและบันทึกหลายการเปลี่ยนแปลงเป็นชุดเดียว เช่น จองที่นั่งและสร้างคำขอ หากขัดแย้ง การเปลี่ยนแปลงก่อนหน้าก็ถูกย้อนกลับ - ลบบันทึก: ลบแถวตามเงื่อนไข
- วนซ้ำรายการ: ทำการกระทำที่กำหนดกับแต่ละรายการ เช่น อัปเดตสถานะ คำนวณ หรือส่งข้อมูลออกไป
วิธีนี้ใช้ทำข้อมูลลูกค้า คำขอ คะแนน และรายงานได้โดยไม่ต้องมีฐานข้อมูลภายนอก ดู บทเรียนเกี่ยวกับคอลเลกชัน สำหรับแคตตาล็อก ผลรวมทุกคำสั่งซื้อที่ตรงเงื่อนไข และการจองที่นั่งสุดท้าย หน้าของรายการที่โหลด หน้าของคอลเลกชัน และผลรวมทั้งคอลเลกชันให้ข้อมูลคนละแบบ
อย่าใช้วงรอบส่งข้อความจำนวนมาก หนึ่งรอบอ่านได้ไม่เกิน 500 รายการ และหนึ่งเหตุการณ์ส่งได้ไม่เกิน 50 ข้อความ หากต้องการส่งถึงคนในคอลเลกชัน ให้สร้าง กลุ่มเป้าหมาย แล้วใช้ การส่งข้อความจำนวนมาก ซึ่งมีอัตรา เวลาพัก และบันทึกผลการส่ง ดู ขีดจำกัดของเหตุการณ์
แคตตาล็อก: ค้นหา เลือก และแสดงการ์ด
เริ่มจาก บทเรียนค้นหาคลาส ซึ่งสอนลำดับขั้นตอนและการทดสอบกรณีไม่พบ พบหลายรายการ และกดปุ่มเก่า
ตัวอย่างคอลเลกชัน products มี name และ aliases; variants มี product_id, name, card ในฟิลด์ variants.product_id เปิด เชื่อมโยงกับคอลเลกชันอื่น เลือก products, คีย์ _record_id และฟิลด์ชื่อที่แสดง name การเชื่อมโยงนี้อธิบายความสัมพันธ์ของฟิลด์ แต่ไม่ได้แก้หรือลบระเบียนที่เกี่ยวข้องโดยอัตโนมัติ
- เมื่อได้รับข้อความ เพิ่ม ค้นหาในคอลเลกชัน (
record_search) เลือกproducts, คำค้น{{text}}, ฟิลด์name, ฟิลด์ชื่ออื่นaliasesและเก็บผลในsearchชื่ออื่นเป็นข้อความหรือรายการข้อความ JSON ได้ การค้นหาไม่แยกตัวพิมพ์ใหญ่เล็กหรือ е/ё และแทนเครื่องหมายวรรคตอนด้วยช่องว่าง - เพิ่ม เลือกขั้นตอนถัดไป (
branch_result) โดยใช้searchทำทางแยกแรกที่ตรง เรียง ผลไม่ครบ, ไม่พบ, ตรงแบบไม่เป๊ะ, พบหนึ่งรายการ, พบหลายรายการ สำหรับผลใกล้เคียงให้ผู้ใช้ยืนยัน กรณีไม่พบหรือพบหนึ่งรายการต้องเป็นผลค้นหาที่ครบ - เมื่อพบหลายรายการ เปิด ปุ่มจากระเบียนที่ค้นพบ ในข้อความ เลือก
search, ฟิลด์ชื่อnameและรีแอคชันถัดไป ตัวช่วยกำหนดbuttons_from.over = search.rowsและcarry.selected_id = {{item._record_id}}ตรวจว่าผลค้นหามีฟิลด์ชื่อที่ใช้ และยังปรับปุ่มแบบละเอียดได้ - ในรีแอคชันถัดไป ใช้ ค้นหาระเบียนที่เกี่ยวข้อง (
record_related) จากvariantsด้วยคีย์product_id, ค่า{{ctx.selected_id}}, ชื่อผลvariantsหากต้องการอ่านสินค้าที่เลือกเอง ใช้productsกับ_record_idถ้าเชื่อมด้วยรหัสธุรกิจ ให้เลือกคีย์นั้นทั้งในตัวช่วยปุ่มและขั้นตอนอ่าน - เลือกทางแยกตามผลอีกครั้ง หากมีรายการเดียวแสดง
{{ctx.variants.first.card}}; หากมีหลายแบบให้แสดงปุ่ม แต่ละปุ่มส่ง ID แล้วอ่านข้อมูลล่าสุดหลังกด อย่าเก็บการ์ดหรือข้อมูลที่เปลี่ยนได้ใน Carry
อ่านผลค้นหา
search.rows คือรายการแถวที่โหลด, search.count คือจำนวนแถว, search.first คือแถวแรก และ search.first.name คือฟิลด์ในแถวแรก ทุกแถวมี _record_id, _score, _match_type ซึ่งเป็นชื่อสงวน หากไม่พบรายการ ค่าแถวแรกเดิมและฟิลด์ของมันจะถูกล้าง
search.total นับผลในกลุ่มข้อมูลที่ตรวจแล้ว total_exact = false หมายถึงยังตรวจไม่ครบคอลเลกชัน; truncated = true หมายถึงผลถูกจำกัด จึงไม่ควรถือว่าเห็นทุกผลหรือพบประเภทการตรงที่ดีที่สุดแล้ว หนึ่งคำขอตรวจสูงสุด 10 000 ระเบียนและข้อมูล 16 MiB โดยผลตอบกลับระบุข้อจำกัดจริง ค่าเริ่มต้นส่งกลับสูงสุด 100 แถว และค่าสูงสุดคือ 10 000
ทดลองและดูคำอธิบาย
ในตัวแก้ไขค้นหา เปิด ทดสอบการค้นหา แล้วใส่ข้อความหรือ ID จริง การทดสอบอ่านอย่างเดียว ไม่เรียกรีแอคชันหรือขั้นตอนอื่น ใส่ค่าจริงแทนตัวแปรในตัวกรองเพิ่มเติมก่อน ผลแสดงแถว ประเภทการตรง จำนวนแถวที่ตรวจและข้อจำกัด เมื่อเปลี่ยนโปรเจกต์ คอลเลกชัน การตั้งค่า หรือสิทธิ์ ผลเก่าจะถูกซ่อน
บันทึกการทำงานแสดงฟิลด์ค้นหา ประเภทการตรง จำนวนที่ตรวจและส่งกลับ ขีดจำกัด และทางแยกที่เลือก แผนภาพรีแอคชันแสดงทุกเงื่อนไขที่ไปยังรีแอคชันเดียวกัน หากมีสิทธิ์อ่านเนื้อหาของเหตุการณ์ ยังเปิดดูคำอธิบายการค้นหาย้อนหลังได้
ตัวช่วยสร้างปุ่มเริ่มต้นสูงสุด 20 ปุ่ม ปรับ จำนวนปุ่มสูงสุด ได้ตั้งแต่ 1 ถึง 100 ค่านี้เป็นขีดจำกัด ไม่ใช่การแบ่งหน้า รายการว่างไม่สร้างปุ่ม หากผลมากเกิน ให้เพิ่มทางแยกที่ขอให้ผู้ใช้ระบุคำค้นให้ชัดขึ้น
ใน การคำนวณ ตัวช่วย การทำงานกับรายการที่โหลด สร้างสูตรนับแถว เลือกแถวแรก รวมค่าฟิลด์ หรือรวมชื่อที่แสดง สูตรคำนวณเฉพาะแถวที่โหลด ถ้าผลค้นหาไม่ครบก็ไม่ใช่ยอดรวมของทั้งคอลเลกชัน
API และ MCP
ใช้การทำงานเดียวกันผ่าน POST /api/bots/{botID}/collections/{name}/search และ /related หรือเครื่องมือ MCP search_records, related_records ที่มีสิทธิ์ collections:read คำขอจำกัดอยู่ในโปรเจกต์และภูมิภาคปัจจุบัน การทดลอง REST รับค่าจริง ส่วนค่าที่แทนลงในข้อความใช้ในขั้นตอนของรีแอคชัน
จัดการผลและแก้ไขแบบมีเงื่อนไข
ส่งผลคอลเลกชันให้ list_transform เพื่อกรอง เรียง ลบค่าซ้ำ หรือเลือกหน้า ใช้ list_aggregate คำนวณผลรวมที่ตั้งชื่อจากแถวที่โหลด รวมทั้งแยกกลุ่มได้ เครื่องมือเดียวกันใช้กับรายการจาก HTTP ได้ด้วย
เพื่อไม่ให้การทำงานพร้อมกันสองครั้งเปลี่ยนสถานะซ้ำ ใช้ record_update_if ระบุ ID, ค่าที่คาดไว้ และค่าใหม่ ระบบตรวจและแก้หนึ่งระเบียนเป็นงานเดียว ผล updated, conflict, not_found แยกทางด้วย branch_value ได้ วิธีนี้ต่างจากการแก้ทุกแถวที่ตรงตัวกรองโดยไม่ตรวจค่าเดิม ดู การตั้งค่าและตัวอย่าง และ บทเรียนยืนยันคำขอครั้งเดียว
ใช้ข้อมูลใน Mini App
Telegram Mini App ของบอตอ่านระเบียนคอลเลกชันได้ โดยหน้าเว็บขอข้อมูลตามชื่อคอลเลกชันพร้อมตัวกรองและจำนวนสูงสุด จึงแสดงคำสั่งซื้อ ประวัติ หรืออันดับภายใน Telegram ได้
คำแนะนำ
- ตั้งชื่อฟิลด์สั้น ๆ เช่น
email,total,paidเพื่อใช้ในข้อความของรีแอคชัน - ใช้คีย์ป้องกันข้อมูลซ้ำเมื่อการเรียกขั้นตอนเดิมซ้ำต้องไม่สร้างแถวใหม่ คุณสมบัตินี้เรียกว่า idempotency
- ใช้
retentionกับบันทึกเหตุการณ์หรือข้อมูลชั่วคราวที่ไม่ต้องเก็บถาวร - ใช้ชนิด
jsonเมื่อโครงสร้างข้อมูลในฟิลด์ไม่ตายตัว