ฐานความรู้ GetMyBot

ช่องทาง: Telegram, WhatsApp, VK

เชื่อม Telegram, WhatsApp และ VK เข้ากับโปรเจกต์เดียว พร้อมดูความต่างของแต่ละช่องทางและที่ที่บอทส่งคำตอบกลับ

บนหน้านี้

โปรเจกต์ GetMyBot เดียวตอบผู้ใช้ได้ใน Telegram WhatsApp และ VK เช่น กฎแจ้งตารางเรียนชุดเดียวกันใช้ได้ในทั้งสามแอป คำตอบจะกลับไปยังช่องทางที่ผู้ใช้ส่งข้อความมา

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

ช่องทางคืออะไร

ช่องทาง คือจุดที่โปรเจกต์เชื่อมต่อเพื่อสนทนากับผู้ใช้ เช่น บอท Telegram ตัวหนึ่ง หมายเลข WhatsApp Business หรือคอมมูนิตี้ VK หนึ่งโปรเจกต์เชื่อมได้หลายช่องทาง รีแอคชันใช้ร่วมกัน: เมื่อผู้ใช้เขียนมาทาง WhatsApp ระบบใช้รีแอคชันชุดเดียวกับ Telegram แล้วส่งคำตอบกลับทาง WhatsApp

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

ช่องทางหลัก (primary_channel)

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

ความสามารถของแต่ละช่องทาง

ความสามารถของแต่ละแอปสรุปไว้ด้านล่าง หากต้องการข้อมูลล่าสุดในรูปแบบสำหรับโปรแกรม ใช้ API GET /api/channels/capabilities

Telegram: รองรับปุ่ม inline และคีย์บอร์ด reply, callback (กดปุ่มเพื่อเรียกรีแอคชัน), รีแอคชันอีโมจิ, deep-link /start, การแก้ไข ลบ และส่งต่อข้อความ, การตอบกลับข้อความเป็นทริกเกอร์, เหตุการณ์สมาชิก, สิทธิ์และการดูแลกลุ่ม การ์ดรูปภาพเลื่อนในข้อความเดียวกันได้เมื่อรูปทุกรูปมี file_id ที่ใช้ได้ รูปแบบข้อความคือ Plain / HTML / Markdown ไม่มีเทมเพลตข้อความแบบ WhatsApp รายการแบบโต้ตอบหรือหน้าต่างเซสชัน

WhatsApp (ผ่าน WhatsApp Cloud API): รองรับปุ่ม inline, callback, รีแอคชันอีโมจิ, deep-link /start, เทมเพลตข้อความ, รายการแบบโต้ตอบ (interactive list) และ หน้าต่างเซสชัน 24 ชั่วโมง รูปแบบข้อความคือ Plain / Markdown ไม่รองรับคีย์บอร์ด reply การแก้ไข ลบหรือส่งต่อข้อความ การตอบกลับข้อความเป็นทริกเกอร์ เหตุการณ์สมาชิก สิทธิ์การดูแล และการเลื่อนการ์ดในข้อความเดียว ดู WhatsApp เพิ่มเติม

VK: รองรับข้อความและไฟล์แนบ ปุ่ม inline และคีย์บอร์ด reply, callback, รีแอคชันอีโมจิ, deep-link /start, การแก้ไข ลบและส่งต่อข้อความ, เหตุการณ์สมาชิก, การแบนและยกเลิกแบน, การอนุมัติคำขอเข้าคอมมูนิตี้ปิดที่ยื่นมาแล้ว และเหตุการณ์สมาชิกแบบชำระเงิน VK Donut แสดงข้อความธรรมดาเท่านั้น โดยตัด HTML/Markdown ออกตอนแสดงผล ไม่มีเทมเพลต WhatsApp รายการแบบโต้ตอบ การเลื่อนการ์ดในข้อความเดียว หรือหน้าต่างเซสชัน

ทุกช่องทางรองรับปุ่ม inline, callback, รีแอคชันอีโมจิและ deep-link /start บล็อกการ์ดรูปภาพใช้ได้ในช่องทางที่รองรับรูปภาพ Telegram จะเลื่อนการ์ดในข้อความเดียว เฉพาะเมื่อรูปทุกใบมี file_id ที่เหมาะสม หากขาดแม้แต่ใบเดียว Telegram จะส่งการ์ดเป็นข้อความรูปภาพแยกกันทั้งหมด เช่นเดียวกับ WhatsApp และ VK ดู ข้อความและปุ่ม

VK Donut

หากคอมมูนิตี้เปิดใช้ VK Donut บอทจะได้รับเหตุการณ์ระบบเกี่ยวกับสมาชิกแบบชำระเงิน:

เหตุการณ์ที่เห็นในตัวแก้ไขคีย์ค่าที่ใช้ได้
VK Donut: subscription createddonut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolongeddonut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expireddonut_subscription_expiredไม่มี
VK Donut: subscription cancelleddonut_subscription_cancelledไม่มี

{{event.donut_amount}} คือยอดชำระ ส่วน {{event.donut_amount_without_fee}} คือยอดหลังหักค่าธรรมเนียม VK เหตุการณ์หมดอายุและยกเลิกไม่มีจำนวนเงิน เพราะการสิ้นสุดช่วงที่เคยชำระแล้วไม่ได้หมายถึงมีการชำระครั้งใหม่ การนำยอดเก่ามาใส่จะทำให้ข้อมูลผิด

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

ตัวอย่าง “คลับสมาชิก”:

  1. สร้างรีแอคชันสำหรับ VK Donut: subscription created และ VK Donut: subscription prolonged ใช้ เปลี่ยนป้ายกำกับ เพิ่มป้าย “คลับ” โดยกำหนด ttl_days = 31 พร้อมส่งลิงก์คอมมูนิตี้ปิดและขอให้สมาชิกยื่นคำขอเข้าร่วม
  2. อนุมัติหลังจากสมาชิกยื่นคำขอแล้วเท่านั้น โดยเป็นขั้นตอนแยกต่างหาก การกระทำ เปลี่ยนสิทธิ์ → อนุมัติคำขอ ใช้ groups.approveRequest กับคำขอที่ยื่นไว้แล้ว ถ้ายังไม่มีคำขอก็อนุมัติไม่ได้ ใส่การกระทำนี้ในรีแอคชันที่เกิดหลังขั้นตอนแรก เช่น เมื่อกดปุ่ม “ฉันยื่นคำขอแล้ว” หรือเมื่อมีเหตุการณ์ต่ออายุครั้งถัดไป
  3. สร้างรีแอคชัน Label expired (label_expired) โดยใช้ เปลี่ยนสิทธิ์ → นำออกจากแชท สมาชิกจะออกจากคลับเมื่อป้ายหมดอายุ แม้ VK ไม่ส่งเหตุการณ์หมดอายุก็ตาม ดู ทริกเกอร์
  4. สำหรับ VK Donut: subscription cancelled และ VK Donut: subscription expired ใช้ เปลี่ยนป้ายกำกับ ลบ “คลับ” และหากจำเป็นให้นำสมาชิกออกทันที

ในงานจัดการสิทธิ์ของ VK ช่อง แชท (chat_id) ต้องเป็น ID ของคอมมูนิตี้ที่เชื่อมอยู่ ซึ่งเป็นเลขเดียวกับที่แสดงในรายการช่องทาง VK จัดการสมาชิกได้เฉพาะคอมมูนิตี้นี้ หากใส่ ID อื่น การกระทำจะถูกปฏิเสธก่อนส่งไป VK หากต้องดูแลอีกคอมมูนิตี้ ให้เชื่อมเป็นช่องทางแยก

วิธีเปิดใช้เหตุการณ์:

  • Long Poll: บอทสมัครรับเหตุการณ์เองเมื่อเชื่อมช่องทางและทุกครั้งที่แพลตฟอร์มเริ่มทำงาน คอมมูนิตี้ที่เชื่อมไว้แล้วไม่ต้องทำอะไรเพิ่ม
  • Callback API: เปิด Работа с API → Callback API → Типы событий → VK Donut ในการตั้งค่าคอมมูนิตี้ แล้วเปิดทั้งสี่เหตุการณ์ในตาราง

วิธีเชื่อมต่อช่องทาง

เพิ่มช่องทางจากหน้า โปรเจกต์:

  1. เปิด โปรเจกต์ แล้วหาโปรเจกต์ที่ต้องการ
  2. กด เพิ่มช่องทาง บนการ์ดโปรเจกต์
  3. เลือก Telegram, WhatsApp หรือ VK
  4. กรอกข้อมูลของช่องทาง: Telegram ใช้โทเค็น WhatsApp ใช้ข้อมูล Meta และ VK ใช้ข้อมูลคอมมูนิตี้
  5. กด ตรวจสอบ เพื่อให้แพลตฟอร์มตรวจข้อมูลกับแอปนั้น
  6. กด เชื่อมต่อ

หลังเชื่อม WhatsApp หรือ VK ช่องทางจะแสดง ที่อยู่ webhook พร้อมไอคอน 🔗 ต้องนำที่อยู่นี้ไปลงทะเบียนที่ฝั่งแพลตฟอร์ม เช่น แอป Meta หรือการตั้งค่าคอมมูนิตี้ VK เพื่อให้เหตุการณ์ขาเข้าไปถึงบอท วิธีตั้งค่า WhatsApp อยู่ที่ การตั้งค่า webhook

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

ข้อมูลสำหรับเชื่อมต่อช่องทาง

Telegram ใช้โทเค็น BotFather แบบเต็ม VK ต้องใช้โทเค็นคอมมูนิตี้และ ID คอมมูนิตี้แบบตัวเลข หากใช้ Callback API ต้องมีสตริงลับและรหัสยืนยันด้วย WhatsApp ต้องใช้ Phone Number ID, ID บัญชีธุรกิจ WhatsApp, โทเค็นที่เข้าถึงบัญชีได้, Verify Token ของ webhook และ App Secret ของแอป Meta

ตรวจข้อมูลก่อนเชื่อมต่อ หากเปลี่ยนคีย์ ต้องอัปเดตการตั้งค่าที่ผู้ให้บริการด้วย Verify Token ใช้ยืนยันที่อยู่ webhook ส่วน App Secret ใช้ตรวจลายเซ็นของเหตุการณ์ขาเข้า ทั้งสองอย่างไม่ใช่โทเค็นสำหรับเรียก API

เหตุการณ์ขาเข้าและที่อยู่ webhook

สำหรับ VK Callback API ให้ลงทะเบียนที่อยู่ที่ MyBot แสดงในการตั้งค่าเซิร์ฟเวอร์ของคอมมูนิตี้ แล้วใส่สตริงลับและรหัสยืนยันให้ตรงกัน Long Poll ไม่ต้องใช้ที่อยู่สาธารณะหรือสองค่านี้ สำหรับ WhatsApp ให้ลงทะเบียนที่อยู่ในแอป Meta ใส่ Verify Token เดียวกัน แล้วสมัครรับเหตุการณ์ข้อความที่ต้องการ มีเพียงข้อมูลสำหรับ ส่ง ข้อความยังไม่เพียงพอที่จะรับข้อความขาเข้า

การอนุญาต Instagram และ Messenger

ตัวช่วยเชื่อมต่อจะเปิดหน้าการอนุญาตของ Meta เข้าสู่ระบบด้วยบัญชีที่จัดการเพจ Facebook หรือบัญชี Instagram แบบมืออาชีพที่ต้องการ อนุญาตสิทธิ์ที่ร้องขอ แล้วเลือกบัญชีที่จะเชื่อมกับโปรเจกต์นี้ ตัวช่วยจะตรวจสิทธิ์ การสมัครรับ webhook และความพร้อมในการส่งข้อความ แก้รายการตรวจที่ไม่ผ่านก่อนใช้ช่องทาง คุณกลับมาทบทวนบัญชีที่เลือกในช่องทางที่เชื่อมแล้วได้