ฐานความรู้ GetMyBot

ข้อความและปุ่ม

วิธีประกอบคำตอบของบอตด้วยข้อความ รูปภาพ ปุ่ม และคำถามที่บันทึกคำตอบ

บนหน้านี้

หากต้องการให้บอตส่งรูปสินค้า คำอธิบาย และปุ่ม «เลือก» ให้เพิ่มการกระทำ ส่งข้อความ คำตอบประกอบด้วยส่วนย่อยที่เรียกว่า บล็อก เช่น บล็อกรูปภาพตามด้วยข้อความที่มีปุ่มอยู่ใต้ข้อความ ในการกระทำเดียวกันยังถามคำถาม รอคำตอบ และบันทึกเบอร์โทรศัพท์ไว้ในข้อมูลลูกค้าได้

บล็อกข้อความ

กด เพิ่มบล็อก แล้วเลือกสิ่งที่จะส่ง สามารถใช้หลายบล็อกในคำตอบเดียว เช่น คำทักทาย รูป และไฟล์รายละเอียด

  • ข้อความ: ข้อความจัดรูปแบบได้สูงสุด 4096 อักขระ พร้อมค่าที่แทนลงในข้อความและปุ่ม
  • รูปภาพ: รูปพร้อมคำบรรยาย
  • ไฟล์: เอกสารพร้อมคำบรรยาย
  • Voice: เสียง OGG/OPUS, MP3 หรือ M4A สูงสุด 50 MB ที่ Telegram แสดงเป็นข้อความเสียง (sendVoice)
  • GIF: ภาพเคลื่อนไหวหรือ MP4 ไม่มีเสียง สูงสุด 50 MB (sendAnimation)
  • Video note: วิดีโอ MP4 สี่เหลี่ยมจัตุรัสยาวไม่เกิน 60 วินาที (sendVideoNote) ไม่มีคำบรรยาย ไฟล์จากคลังสื่อจะถูกอัปโหลดใหม่ทุกครั้ง เพราะ file_id ที่ได้จากวิธีอื่นใช้ข้ามระหว่าง sendVoice, sendAnimation และ sendVideoNote ไม่ได้
  • Carousel: รูปพร้อมคำบรรยายและปุ่มของแต่ละการ์ด จำนวน 2–10 การ์ด ใน Telegram เลื่อนการ์ดด้วยปุ่ม «‹ ›» ภายในข้อความเดียวผ่าน editMessageMedia เฉพาะเมื่อรูปทุกใบมี file_id ที่ใช้ได้ ไม่ว่าจะกำหนดไว้ในการ์ดหรือได้จากไฟล์ในคลังสื่อ หากรูปใดรูปหนึ่งไม่มี ID ที่ใช้ได้ ระบบจะส่งทุกการ์ดเป็นข้อความรูปภาพแยกกัน ช่องทางอื่น เช่น VK ก็ส่งแยกกัน โดยยังคงคำบรรยายและปุ่มของแต่ละการ์ด
  • หน่วงเวลา: รอตามจำนวนวินาทีก่อนบล็อกถัดไป
  • AI: สร้างคำตอบจากคำสั่งที่กำหนดให้โมเดล
  • รีแอคชัน: เรียกรีแอคชันอื่น จะเลือกให้รอผลของรีแอคชันนั้นก็ได้

บล็อก Voice, GIF, Video note และ Carousel ใช้ในรีแอคชันและการส่งแบบเร็วจากรีแอคชันได้เช่นเดียวกับบล็อกอื่น ดู การส่งข้อความจำนวนมาก ลากบล็อกเพื่อเปลี่ยนลำดับ เลือกแสดง ตามลำดับ หรือ สุ่ม เมนูหลักของบอตเลือกคงเดิม ตั้งใหม่ หรือซ่อนได้

ตัวเลือกบล็อก

บล็อกข้อความและสื่อมีตัวเลือก ปักหมุด, ส่งโดยไม่แจ้งเตือน, ป้องกันการส่งต่อ, สปอยเลอร์, ไม่แสดงตัวอย่างลิงก์ และ ลบอัตโนมัติหลัง N วินาที

ปุ่มใต้ข้อความ

ในบล็อกกำหนด ข้อความปุ่ม และ ประเภทปุ่ม:

  • ข้อความ: ส่งข้อความบนปุ่มกลับมาเป็นคำตอบของผู้ใช้ ใน Telegram และ VK ใช้แป้นพิมพ์สำหรับตอบกลับ จึงตอบคำถามที่รออยู่หรือเรียกรีแอคชันตามข้อความได้ ใน WhatsApp, Instagram, Messenger และวิดเจ็ตเว็บจะเป็นปุ่มตอบกลับที่ไม่มีแป้นพิมพ์ค้างอยู่
  • ลิงก์: เปิด URL
  • เว็บแอปพลิเคชัน: เปิด Telegram Mini App ดู Mini App
  • รีแอคชัน: เรียกรีแอคชันอื่นเมื่อกด
  • Inline query: เติม «@bot คำค้น» ในช่องพิมพ์ของแชตปัจจุบันหรือให้เลือกแชตอื่น (switch_inline_query/switch_inline_query_current_chat) ใช้เฉพาะ Telegram หลังเปิดโหมด inline ผ่าน /setinline ที่ @BotFather ระบบยังไม่ตอบคำค้น inline (answerInlineQuery ยังไม่มี) ปุ่มจึงเพียงเตรียมข้อความค้นหา
  • Prefilled text: เปิด https://t.me/<bot>?text=… แล้วเติมข้อความในช่องพิมพ์ โดยยังไม่ส่ง (prefill)
  • Payment link: เปิด URL ชำระเงินที่ต้องระบุ ต้องสร้างการชำระเงินด้วยการกระทำ ออกใบแจ้งหนี้ ก่อน เป็นหน้าเว็บชำระเงินภายนอก ไม่ใช่ใบแจ้งหนี้ภายใน Telegram
  • การแจ้งเตือน: แสดงข้อความเมื่อกด โดยไม่เรียกรีแอคชันและไม่ส่งข้อมูล Carry ใน Telegram เป็นข้อความสั้นหรือหน้าต่างยาวไม่เกิน 200 อักขระ ส่วน VK เป็นแถบแจ้งเตือนสั้นไม่เกิน 90 อักขระ

ปุ่มข้อความหรือข้อความที่เตรียมไว้

งานวิธีตั้งค่าผลเมื่อกด
ตอบ «ใช่» ในแบบสอบถามประเภท ข้อความ, ชื่อปุ่ม «ใช่» และตั้งให้รอคำตอบส่ง «ใช่» เป็นคำตอบของผู้ใช้
เตรียมข้อความติดต่อPrefilled text, ชื่อปุ่ม «เขียนข้อความ», ข้อความ «ต้องการสั่งซื้อ»เปิดแชตพร้อมร่างที่ผู้ใช้แก้ไขและกดส่งเอง

ข้อความบนปุ่มกับข้อความร่างเป็นคนละช่อง ร่างไม่ส่งข้อความและไม่เรียกรีแอคชันด้วยตัวเอง การกดปุ่ม รีแอคชัน จะส่งเหตุการณ์ที่เรียกว่า callback ให้บอต ส่วน Inline query และ Prefilled text ทำงานในแอป Telegram จึงไม่มี callback, answerCallbackQuery หรือ Carry

ไอคอนและสีของปุ่ม

ใส่ Premium emoji หน้าข้อความปุ่มได้โดยกรอก icon_custom_emoji_id เป็นจำนวนเต็ม 64 บิตที่เป็นบวก เช่น 007 จะอ่านเป็น 7 ตัวอักษร ศูนย์ ค่าติดลบ หรือจำนวนที่ใหญ่เกินไปจะถูกละทิ้ง แต่ปุ่มยังบันทึกได้ Telegram แสดงไอคอนเฉพาะบอตที่มีสิทธิ์ เช่น ชื่อเสริมผ่าน Fragment หรือเจ้าของมี Telegram Premium เมื่อส่งตรงในแชตส่วนตัวหรือกลุ่ม หากไม่มีสิทธิ์ Telegram จะไม่แสดงไอคอนและไม่ใช้ emoji ทดแทน

สไตล์ปุ่ม (style) เลือก ปกติ ไม่มีสี, หลัก สีน้ำเงิน, สำเร็จ สีเขียว หรือ อันตราย สีแดง

ตัวเลือก ใช้ครั้งเดียว (เผาหลังกด) (single_use) ใช้ข้อมูล Carry ได้เพียงครั้งเดียว เหมาะกับการยืนยันการเลือก ปุ่มไม่ได้ถูกปิดหรือหายไปโดยอัตโนมัติ การเปลี่ยนชื่อปุ่มและลบข้อความต้องตั้งในส่วน เมื่อกด แยกต่างหาก

การจัดแถวของปุ่ม

  • ขึ้นแถวใหม่: เริ่มแถวถัดไป
  • ยืดเต็มความกว้าง: วางปุ่มเดี่ยวเต็มแถว และให้ปุ่มถัดไปเริ่มแถวใหม่
แถวเดียว:        [สินค้า] [ช่วยเหลือ]
ขึ้นแถวใหม่:     [สินค้า]
                 [ช่วยเหลือ]
เต็มความกว้าง:  [       ช่วยเหลือ       ]

แถวและสีใช้ได้ใน Telegram และ VK ลำดับแถวคงอยู่เมื่อเปิดแก้ไขอีกครั้ง Premium emoji ใช้ได้เฉพาะการเชื่อมต่อ Telegram ที่รองรับ ไม่มีตัวเลือก เปิดภายใน Telegram ที่ใช้งานได้ เพราะ Bot API ไม่ให้ควบคุมพฤติกรรมนี้ด้วยแฟล็ก

ข้อจำกัดของแต่ละช่องทาง

เลือกการเชื่อมต่อของบล็อกหรือปุ่ม หากเลือกทุกช่องทาง ตัวแก้ไขจะให้ใช้เฉพาะความสามารถร่วมกัน ประเภทที่ช่องทางไม่รองรับจะบันทึกไม่ได้

  • Telegram: URL, Mini App, รีแอคชัน, การแจ้งเตือน/alert, แถว, สี และ custom emoji เมื่อบอตมีสิทธิ์
  • VK: URL, รีแอคชัน, snackbar, แถว และสี ส่วน VK Mini App และ VK Pay ต้องเลือกการเชื่อมต่อ VK ที่รองรับ
  • WhatsApp: ปุ่ม URL แบบ CTA ได้เพียงปุ่มเดียวในข้อความและใช้ร่วมกับปุ่มอื่นไม่ได้ ปุ่มตอบกลับธรรมดาสูงสุด 3 ปุ่ม; 4–10 ปุ่มแสดงเป็นรายการ ชื่อปุ่มยาวไม่เกิน 20 อักขระ ไม่มีแถว สี Mini App หรือการแจ้งเตือน
  • Instagram / Messenger: ส่งได้เฉพาะปุ่มตอบกลับแบบ quick reply ชื่อไม่เกิน 20 อักขระ ไม่มี URL, Mini App, การแจ้งเตือน, แถวหรือสี
  • วิดเจ็ตเว็บ: URL และปุ่มตอบกลับ ไม่มีแถว สีหรือการแจ้งเตือน
  • Email: ลิงก์รวมถึง Payment link ไม่มีปุ่มตอบกลับหรือการแจ้งเตือน

ปุ่มที่สร้างจากรายการกำหนดจำนวนคอลัมน์ได้เฉพาะช่องทางที่รองรับแถว ช่องทางอื่นจะจัดเอง จำนวนปุ่มและความยาวชื่อถูกตรวจตอนส่ง

เมื่อลูกค้ากดปุ่ม

สำหรับปุ่มที่ส่งการกดให้บอต สามารถ แทนที่ข้อความ ด้วยข้อความใหม่หรือข้อความจากรีแอคชัน, ลบข้อความ, เพิ่มป้ายกำกับ หรือบันทึกพารามิเตอร์ได้ตามที่ช่องทางรองรับ การ แทนที่ข้อความปุ่มเมื่อกด ทำได้เฉพาะ Telegram เช่น เปลี่ยน «ลงทะเบียน» เป็น «เลือกแล้ว» แม้ VK แก้ไขข้อความได้ แต่เปลี่ยนชื่อปุ่มด้วยวิธีนี้ไม่ได้

Telegram รอการยืนยันการกดผ่าน answerCallbackQuery โดยปกติระบบส่งให้อัตโนมัติและเอาสัญลักษณ์กำลังโหลดออก ตัวเลือก ข้าม answerCallbackQuery ปิดการยืนยันนี้

ช่อง Text on press (notification) ของปุ่มรีแอคชันใส่ข้อความสั้นได้ เช่น «เลือกคลาสแล้ว» Telegram รองรับ 200 อักขระ VK รองรับ 90 อักขระ และใช้ค่าที่แทนลงในข้อความได้ ใน Telegram ปกติจะแสดงชั่วคราวเหนือแชต; Show as a popup (alert) เปิดหน้าต่าง (show_alert) เฉพาะ Telegram หากช่องว่าง บอตเพียงเอาสัญลักษณ์กำลังโหลดออก และถ้าเลือกข้าม answerCallbackQuery จะไม่แสดงทั้งข้อความและหน้าต่าง

ข้อมูลที่ส่งเมื่อคลิก (Carry)

Carry ให้ปุ่มจำว่าสัมพันธ์กับสิ่งใด ตัวอย่างปุ่ม «ซื้อ» ใต้เสื้อโค้ตมี product_id=101 ใต้ชุดเดรสมี product_id=102 เมื่อกดปุ่มชุดเดรส รีแอคชันถัดไปอ่าน {{ctx.product_id}} ได้ค่า 102

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

ระยะเวลาที่ข้อมูลปุ่มใช้ได้ (วินาที) (ttl_seconds, TTL) เช่น 3600 คือหนึ่งชั่วโมง ค่า 0 ใช้ค่าเริ่มต้น 30 วัน หลังหมดอายุจะอ่านข้อมูลไม่ได้ single_use ลบข้อมูลหลังการกดครั้งแรก ราคาที่เก็บไว้ไม่เปลี่ยนตามแคตตาล็อก จึงควรอ่านราคาปัจจุบันจาก ID สินค้าก่อนเก็บเงิน ดู ปุ่มแบบไดนามิกและพารามิเตอร์

ปุ่มที่สร้างจากรายการ

หากมีสินค้าในรายการอยู่แล้ว ให้ใช้ ปุ่มไดนามิกจากรายการ แทนการเพิ่มทีละปุ่ม เลือกตำแหน่งรายการใน ctx, ชื่อแทนหนึ่งรายการ, จำนวนปุ่มต่อแถว และต้นแบบ เช่น {{item.name}} แสดงชื่อสินค้าทีละรายการ ดู ปุ่มแบบไดนามิกและพารามิเตอร์

Premium emoji ในข้อความ

ปุ่มจัดรูปแบบ Premium emoji แทรก <tg-emoji emoji-id="…">🙂</tg-emoji> ในบล็อกข้อความ ผู้ใช้ Telegram Premium เห็น emoji ที่กำหนด ส่วนคนอื่นเห็น 🙂 ที่เป็นตัวสำรอง ใช้ได้ทั้งบล็อก HTML และ Markdown ID ยาวได้สูงสุด 32 หลัก หาได้จาก getCustomEmojiStickers หรือส่งข้อความตัวอย่างให้บอต เช่น @idstickerbot

ลิงก์ไปยังบอตและข้อความที่เตรียมไว้

ลิงก์ t.me/<bot>?start=<param> เรียก /start <param> ใน Telegram จึงเปิดแชตพร้อมพารามิเตอร์โดยไม่เรียก /start ด้วยลิงก์นี้ไม่ได้ เลือกวิธีให้ตรงงาน:

  • /start แบบไม่ตอบข้อความ: ในรีแอคชันของทริกเกอร์ คำสั่ง /start ที่มี แท็กในลิงก์เริ่มต้น ตามต้องการ ตั้ง ส่งข้อความ โดยไม่ใส่บล็อก ค่าของแท็กยังใช้ในเงื่อนไขและการกระทำอื่นในรีแอคชันเดียวกันได้
  • Prefilled text: https://t.me/<bot>?text=<text> เปิดแชตพร้อมร่าง ไม่ส่งข้อความและไม่เรียก /start ผู้ใช้ต้องกดส่งเอง
  • ส่งข้อความในนามผู้ใช้เมื่อเปิดลิงก์: Bot API ไม่รองรับ บอตส่งแทนผู้ใช้ไม่ได้ หากต้องการให้ตอบอัตโนมัติ ใช้ ?start= และรีแอคชันที่ตอบจากบอต

รอคำตอบของผู้ใช้

บล็อกข้อความตั้งให้ รอคำตอบ ได้ ข้อความนั้นจะเป็นขั้นตอนของบทสนทนาและหยุดลำดับงานจนกว่าผู้ใช้ตอบ หลายขั้นตอนต่อกันใช้ทำแบบสอบถามในแชต

ประเภทคำตอบที่รอ

เลือกข้อความ, ตัวเลือกจากปุ่ม, รูปภาพ, วิดีโอ, video note, เสียง, เอกสาร, ข้อความเสียง, ตำแหน่ง, รายชื่อผู้ติดต่อ, ปฏิทิน หรือลูกเต๋า หากผู้ใช้ส่งคนละประเภท จะถือว่าไม่ตรงคำถาม

ตรวจข้อความที่ตอบ

ตรวจรูปแบบโทรศัพท์ อีเมล ลิงก์ วันที่ เวลา หรือ สูตร ได้ เช่น ถ้ารอหมายเลขโทรศัพท์ ข้อความอื่นจะถูกปฏิเสธและแสดงข้อผิดพลาด สูตรใช้ สูตรขั้นสูง โดยคืนข้อความว่างเมื่อผ่าน และคืนข้อความอธิบายเมื่อไม่ผ่าน

บันทึกคำตอบ

บันทึกคำตอบเป็นพารามิเตอร์ แล้วใช้ในข้อความด้วย {{param.key}} หรือในเงื่อนไข ขั้นตอนต่อเนื่องกันจึงเก็บข้อมูลลูกค้าได้ทีละอย่าง

ข้อผิดพลาด การเตือน และหมดเวลารอ

  • ข้อความเมื่อตรวจไม่ผ่าน: ข้อความที่ผู้ใช้เห็นเมื่อคำตอบไม่ถูกต้อง
  • การเตือน: ข้อความเมื่อผู้ใช้ยังไม่ตอบ
  • หยุดรอเมื่อหมดเวลา: กำหนดเวลารอและเลือก เรียกรีแอคชัน เมื่อหมดเวลา เช่น จบแบบสอบถาม รีแอคชันนี้แสดงใน ความเชื่อมโยง เป็น «หมดเวลารอ» ส่วนรีแอคชันที่ตอบจริงแสดงเป็น «คำตอบที่รอ»

ออกจากขั้นตอนด้วยคำสั่ง

/cancel หรือคำภาษารัสเซีย отмена ยกเลิกการรอและตอบ Отменено. หรือเรียกรีแอคชันยกเลิกที่กำหนดไว้ คำสั่งอื่นโดยปกติถือเป็นคำตอบและถูกตรวจเช่นข้อความทั่วไป หากเปิด Bot commands (e.g. /start) end the wait (escape_on_command) คำสั่งใด ๆ เช่น /start จะหยุดรอโดยไม่ส่งข้อความยกเลิก และทำงานตามปกติ

ค่าที่แทนลงในข้อความ

ปุ่ม การแทนที่ ใส่ข้อมูลผู้ส่ง ({{first_name}}, {{username}}, {{user_id}}), เหตุการณ์ ({{text}}, {{chat_id}}, {{datetime}}) และพารามิเตอร์ ({{param.key}}) ดู ค่าที่แทนลงในข้อความและสูตร

ปุ่มเมนูของบอต

การกระทำ Menu button เลือกเมนูปกติ รายการคำสั่ง หรือปุ่ม Mini App ที่มีข้อความและ URL ได้ เลือกให้ใช้เฉพาะแชตปัจจุบันหรือเป็นค่าโดยรวมของบอต เช่น แสดง Mini App เฉพาะลูกค้าคนนี้ ความพร้อมใช้งานขึ้นอยู่กับช่องทาง

อ่านต่อ