ลิงก์ Telegram Bot: จัดการพารามิเตอร์ start และการเชื่อมบัญชี
Deep link ของ Telegram Bot ส่งพารามิเตอร์ผ่านคำสั่ง /start ในแชตส่วนตัว แต่ลิงก์นั้นไม่ได้พิสูจน์ว่าบัญชีเว็บไซต์และผู้ใช้ Telegram เป็นของคนเดียวกัน ควรใช้พารามิเตอร์เพื่อค้นหาคำขอที่รอดำเนินการบนเซิร์ฟเวอร์ รอให้บอตได้รับอัปเดตจริง และขอการยืนยันอย่างชัดเจนก่อนเชื่อมบัญชีที่มีความละเอียดอ่อน การเปิด URL ไม่ใช่การทำรายการสำเร็จ
ประเด็นสำคัญ
- พารามิเตอร์เริ่มต้นยาวได้ไม่เกิน 64 อักขระ ใช้ตัวอักษรอังกฤษ ตัวเลข ขีดล่าง และขีดกลางได้
startใช้กับแชตส่วนตัว ส่วนstartgroupเป็นขั้นตอนเพิ่มบอตเข้ากลุ่มอีกแบบหนึ่ง- รหัสแคมเปญเปิดเผยได้ แต่โทเคนเชื่อมบัญชีควรคาดเดาไม่ได้ มีอายุสั้น และใช้ได้ครั้งเดียว
- การเริ่มสนทนากับบอตไม่ใช่การอนุญาตให้เชื่อมบัญชีรับส่งข้อความ Telegram ที่มีอยู่
ลิงก์ start ส่งอะไรให้บอต
เอกสารความสามารถของบอต อธิบาย deep linking รวมถึงการเชื่อมผู้ใช้ Telegram กับบัญชีบนแพลตฟอร์มอื่น รูปแบบ URL คือ https://t.me/<bot_username>?start=<parameter> ค่าภายในวงเล็บแหลมเป็นคำอธิบายไวยากรณ์ ไม่ใช่บอตหรือโทเคนที่พร้อมใช้จริง
ข้อกำหนด deep link สำหรับไคลเอนต์ อธิบายปุ่ม Start ซึ่งเรียกการเริ่มบอตพร้อมพารามิเตอร์ ดังนั้นสถานะบนหน้าจอควรเปลี่ยนตามคำสั่งที่ได้รับจริง ไม่ใช่ตามการคลิกในเบราว์เซอร์หรือการคาดว่าระบบส่งข้อความให้อัตโนมัติ บอตจะได้รับข้อความลักษณะ /start airplane โดย airplane เป็นตัวอย่างจาก Telegram
อักขระที่อนุญาตคือ A-Z, a-z, 0-9, _ และ - รวมไม่เกิน 64 อักขระ Telegram แนะนำ base64url สำหรับข้อมูลไบนารีหรือเนื้อหาประเภทอื่น แต่การเข้ารหัสรูปแบบข้อมูลไม่ใช่การเข้ารหัสลับและไม่ได้ทำให้ข้อมูลน่าเชื่อถือ ห้ามใส่รหัสผ่าน bot token, API hash, อีเมล หรือข้อมูลเข้าสู่ระบบที่ใช้ซ้ำได้ใน URL
เส้นทางเพิ่มเข้ากลุ่มใช้ startgroup ตามข้อกำหนดแยกต่างหาก อย่าถือว่าคำสั่งในกลุ่มเป็นหลักฐานยืนยันการเชื่อมบัญชีส่วนตัว
แยกการเลือกเส้นทางออกจากการยืนยันตัวตน
| วัตถุประสงค์ | พารามิเตอร์ที่แนะนำ | สิ่งที่พิสูจน์ได้เมื่อได้รับ |
|---|---|---|
| เปิดหัวข้อช่วยเหลือ | รหัสหัวข้อสาธารณะที่อยู่ในรายการอนุญาต | ผู้ใช้ขอเปิดหัวข้อนั้น |
| บันทึกที่มาของแคมเปญ | รหัสแคมเปญสาธารณะ | ข้อมูลที่มา ไม่ใช่ตัวตนที่ยืนยันแล้ว |
| เชื่อมบัญชีเว็บไซต์ที่เข้าสู่ระบบแล้ว | รหัสอ้างอิงฝั่งเซิร์ฟเวอร์แบบใช้ครั้งเดียวที่ไม่เปิดเผยรายละเอียด | ความสัมพันธ์ที่ยังต้องยืนยัน |
ผู้ใช้พิมพ์คำสั่งเองหรือส่งต่อลิงก์ได้ การมีหมายเลขลูกค้าในพารามิเตอร์จึงไม่ได้พิสูจน์ว่าผู้ส่งเป็นเจ้าของข้อมูลลูกค้านั้น แม้โทเคนจะคาดเดาไม่ได้ก็อาจถูกส่งต่อหรือรั่วไหลได้ ความสุ่มเพียงอย่างเดียวไม่ยืนยันว่าคู่บัญชีตรงตามเจตนา
หากยังสับสนเรื่องข้อมูลรับรอง ให้อ่าน Telegram API ID และ API hash เทียบกับ bot token ก่อน พารามิเตอร์เริ่มต้นเป็นข้อมูลเข้าแอป ไม่ใช่ข้อมูลรับรองประเภทใดในรายการนั้น
ขั้นตอนเชื่อมบัญชีที่แนะนำ
ขั้นตอนต่อไปนี้เป็นคำแนะนำในการออกแบบแอป ไม่ใช่บริการโทเคนจาก Telegram หรือ endpoint ใหม่ของ UnifyPort
- เริ่มจากเซสชันเว็บไซต์ที่เข้าสู่ระบบแล้ว แสดงบัญชีที่จะเชื่อมและให้ผู้ใช้ดำเนินการอย่างตั้งใจ ใช้มาตรการป้องกันเซสชันและการปลอมคำขอตามปกติของเว็บไซต์
- สร้างคำขอรอดำเนินการบนเซิร์ฟเวอร์ สร้างโทเคนสุ่มที่ปลอดภัยทางการเข้ารหัสและใช้ใน URL ได้ เก็บค่าแฮช บัญชีเว็บไซต์เป้าหมาย บอตเป้าหมาย วัตถุประสงค์ วันหมดอายุ และสถานะรอดำเนินการ ทั้งหมดนี้เป็นข้อมูลภายในที่แนะนำ ไม่ใช่ฟิลด์ Telegram API กำหนดอายุตามนโยบายความเสี่ยงของคุณ รูปแบบพารามิเตอร์ของ Telegram ไม่ได้กำหนดอายุโทเคนของแอป
- รับและตรวจสอบอัปเดตจริง ตรวจสอบความน่าเชื่อถือของช่องทางรับข้อมูล ยอมรับเฉพาะข้อความแชตส่วนตัวของบอตที่กำหนด แยกคำสั่ง
/startให้ถูกต้องและตรวจสอบความยาวกับชุดอักขระ ใช้ตัวตนผู้ส่งจากข้อความ ไม่ใช่ ID ที่ผู้ใช้ใส่ในพารามิเตอร์ เอกสาร Bot API ระบุโครงสร้างUpdateและMessage - บันทึกผู้ขอเชื่อมโดยยังไม่ให้สิทธิ์ทันที ผูกคำขอรอดำเนินการกับผู้ใช้ Telegram ที่พบด้วยการทำงานแบบอะตอมมิก ปฏิเสธคำขอหมดอายุหรือผู้ใช้คนอื่นที่นำโทเคนซึ่งมีผู้ใช้แล้วมาส่ง อย่าเปิดเผยรายละเอียดบัญชีเว็บไซต์ให้ผู้ส่ง Telegram ที่ยังไม่ยืนยัน
- ยืนยันคู่บัญชีในเซสชันเว็บไซต์เดิม แสดงตัวตน Telegram ที่เสนอและให้เจ้าของบัญชีที่เข้าสู่ระบบอนุมัติ หากไม่ตรงให้ยกเลิก ไม่เขียนทับความสัมพันธ์เดิม สำหรับงานที่ละเอียดอ่อน ควรเพิ่มการยืนยันที่เหมาะสมฝั่ง Telegram ด้วย
- ยืนยันผลครั้งเดียวและเก็บบันทึกตรวจสอบเท่าที่จำเป็น การใช้โทเคนขั้นสุดท้ายและการเชื่อมบัญชีต้องเป็นอะตอมมิก อัปเดตซ้ำหรือการกด Start อีกครั้งต้องไม่สร้างการเชื่อมใหม่ ย้ายการเชื่อม หรือให้สิทธิประโยชน์ซ้ำ เตรียมการยกเลิกการเชื่อมเป็นคำสั่งแยกที่ต้องยืนยันตัวตน
อย่าเก็บโทเคนดิบในระบบวิเคราะห์ ล็อก ภาพหน้าจอ หรือทิกเก็ตช่วยเหลือ จำกัดอัตราความพยายามที่ไม่ถูกต้อง หากไม่มีการยืนยัน ให้คำขอหมดอายุโดยไม่ให้สิทธิ์เข้าถึง
ตรวจสอบขั้นตอนที่ขาดหาย
| อาการ | สิ่งที่ควรตรวจต่อ |
|---|---|
| เปิดลิงก์ได้แต่ไม่มีคำสั่ง | ชื่อบอต การกด Start และระบบรับอัปเดต |
ได้รับเพียง /start | แสดงขั้นตอนเริ่มต้นทั่วไป ไม่เดาบัญชีจากข้อมูลที่ไม่มี |
| พารามิเตอร์ไม่ถูกต้องหรือหมดอายุ | ให้เริ่มคำขอใหม่จากเว็บไซต์ที่เข้าสู่ระบบแล้ว |
| อัปเดตเดิมมาซ้ำ | ใช้ผลที่บันทึกไว้ ไม่เชื่อมบัญชีซ้ำ |
| ผู้ใช้อื่นส่งโทเคนที่มีผู้รับสิทธิ์แล้ว | ปฏิเสธและเสนอขั้นตอนใหม่ ไม่ย้ายการเชื่อมอัตโนมัติ |
| บอตได้คำสั่งแต่เว็บไซต์ยังรอ | ตรวจสถานะผู้ขอเชื่อมและการยืนยันในแอป |
เรื่องช่องทางรับข้อมูลอ่านได้ที่ Bot API webhook เทียบกับ unified inbound webhook การเลือก polling หรือ webhook ไม่ได้แก้ปัญหาการยืนยันตัวตน
UnifyPort อยู่ตรงไหนของระบบ
ขั้นตอนนี้เป็นของ Telegram Bot ทางการ ส่วน เอกสารอนุญาตบัญชี Telegram ของ UnifyPort อธิบายการเชื่อมบัญชีเดิมผ่านอินเทอร์เฟซที่ไม่เป็นทางการด้วยรหัสยืนยัน QR และการนำเข้าเซสชัน พารามิเตอร์เริ่มบอตไม่อนุญาตบัญชีนั้นและไม่แทนที่การอนุมัติของเจ้าของบัญชี
หากเป้าหมายคือรับข้อความจากบัญชีรับส่งข้อความที่มีอยู่ ให้ใช้ขั้นตอนอนุญาตดังกล่าวและเหตุการณ์ message.received อย่าคาดว่าลิงก์ไปยังบอตจะเข้ากล่องข้อความของบัญชีทั่วไปที่เชื่อมไว้ แม้งานบริการลูกค้าจะครอบคลุม LINE, WhatsApp หรือ Zalo ด้วย การเชื่อมตัวตนยังต้องจัดการแยกในแอป
คำถามที่พบบ่อย
เปิดลิงก์แล้วเชื่อมบัญชีสำเร็จหรือยัง?
ยัง ต้องรอคำสั่งของบอตและธุรกรรมยืนยันของแอป การคลิกอย่างเดียวไม่พิสูจน์การรับข้อความหรือความเป็นเจ้าของบัญชี
ใส่ ID ลูกค้าใน start ได้ไหม?
ใช้เป็นข้อมูลเลือกเส้นทางที่ไม่ละเอียดอ่อนได้ แต่ใช้อนุญาตสิทธิ์ไม่ได้ การเชื่อมบัญชีควรใช้รหัสอ้างอิงสุ่มฝั่งเซิร์ฟเวอร์และการยืนยันชัดเจน
base64url ปกป้องความลับหรือไม่?
ไม่ เป็นเพียงรูปแบบการเข้ารหัสข้อมูล เก็บข้อมูลละเอียดอ่อนบนเซิร์ฟเวอร์ และถือว่าลิงก์เชื่อมบัญชีเป็นข้อมูลลับจนโทเคนถูกใช้หรือหมดอายุ
เหมือนการเข้าสู่ระบบบัญชีผู้ใช้ Telegram หรือไม่?
ไม่เหมือน การเริ่มคุยกับบอตไม่สร้างเซสชันผู้ใช้ที่ได้รับอนุญาต เลือกวิธีเชื่อมต่อตามตัวตนที่แอปจำเป็นต้องใช้งาน
ขั้นตอนต่อไปและแหล่งอ้างอิง
เริ่มจาก ข้อกำหนด deep link ของ Telegram แล้วทดสอบพารามิเตอร์ที่หายไป ลิงก์ที่ถูกส่งต่อ การหมดอายุ อัปเดตซ้ำ ตัวตนขัดแย้ง และการยกเลิก รายการนี้เป็นการทดสอบที่แนะนำ ไม่ใช่ผลทดสอบที่ดำเนินการแล้ว
ตรวจสอบเอกสารทางการเมื่อ 2026-11-10:
เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร
เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน