← บทความทั้งหมด
คู่มือ

ลิงก์ 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

  1. เริ่มจากเซสชันเว็บไซต์ที่เข้าสู่ระบบแล้ว แสดงบัญชีที่จะเชื่อมและให้ผู้ใช้ดำเนินการอย่างตั้งใจ ใช้มาตรการป้องกันเซสชันและการปลอมคำขอตามปกติของเว็บไซต์
  2. สร้างคำขอรอดำเนินการบนเซิร์ฟเวอร์ สร้างโทเคนสุ่มที่ปลอดภัยทางการเข้ารหัสและใช้ใน URL ได้ เก็บค่าแฮช บัญชีเว็บไซต์เป้าหมาย บอตเป้าหมาย วัตถุประสงค์ วันหมดอายุ และสถานะรอดำเนินการ ทั้งหมดนี้เป็นข้อมูลภายในที่แนะนำ ไม่ใช่ฟิลด์ Telegram API กำหนดอายุตามนโยบายความเสี่ยงของคุณ รูปแบบพารามิเตอร์ของ Telegram ไม่ได้กำหนดอายุโทเคนของแอป
  3. รับและตรวจสอบอัปเดตจริง ตรวจสอบความน่าเชื่อถือของช่องทางรับข้อมูล ยอมรับเฉพาะข้อความแชตส่วนตัวของบอตที่กำหนด แยกคำสั่ง /start ให้ถูกต้องและตรวจสอบความยาวกับชุดอักขระ ใช้ตัวตนผู้ส่งจากข้อความ ไม่ใช่ ID ที่ผู้ใช้ใส่ในพารามิเตอร์ เอกสาร Bot API ระบุโครงสร้าง Update และ Message
  4. บันทึกผู้ขอเชื่อมโดยยังไม่ให้สิทธิ์ทันที ผูกคำขอรอดำเนินการกับผู้ใช้ Telegram ที่พบด้วยการทำงานแบบอะตอมมิก ปฏิเสธคำขอหมดอายุหรือผู้ใช้คนอื่นที่นำโทเคนซึ่งมีผู้ใช้แล้วมาส่ง อย่าเปิดเผยรายละเอียดบัญชีเว็บไซต์ให้ผู้ส่ง Telegram ที่ยังไม่ยืนยัน
  5. ยืนยันคู่บัญชีในเซสชันเว็บไซต์เดิม แสดงตัวตน Telegram ที่เสนอและให้เจ้าของบัญชีที่เข้าสู่ระบบอนุมัติ หากไม่ตรงให้ยกเลิก ไม่เขียนทับความสัมพันธ์เดิม สำหรับงานที่ละเอียดอ่อน ควรเพิ่มการยืนยันที่เหมาะสมฝั่ง Telegram ด้วย
  6. ยืนยันผลครั้งเดียวและเก็บบันทึกตรวจสอบเท่าที่จำเป็น การใช้โทเคนขั้นสุดท้ายและการเชื่อมบัญชีต้องเป็นอะตอมมิก อัปเดตซ้ำหรือการกด 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:

UnifyPort API

เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร

เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน