← 所有文章
指南

Telegram Bot 深層連結:處理 start 參數與帳號綁定

Telegram Bot 深層連結會透過私人聊天中的 /start 指令傳入參數,但它本身無法證明網站帳號與 Telegram 使用者屬於同一個人。應用參數查找伺服器端的待處理請求,等待機器人實際收到更新,再明確確認敏感的帳號綁定。開啟網址不等於完成綁定。

重點摘要

  • 啟動參數最長 64 個字元,允許英文字母、數字、底線及連字號。
  • start 用於私人聊天;startgroup 是不同的加入群組流程。
  • 活動來源代碼可以公開;帳號綁定權杖應不可預測、短期有效且只能使用一次。
  • 啟動機器人與授權既有 Telegram 訊息帳號,是兩種不同的整合。

Telegram start 連結實際傳送什麼

Telegram 的機器人功能文件介紹了深層連結,包括將 Telegram 使用者與其他平台帳號關聯的用途。網址語法是 https://t.me/<bot_username>?start=<parameter>。角括號內容僅說明語法,不是可用機器人或正式環境權杖。

用戶端深層連結規格說明,Start 按鈕會帶著參數執行機器人啟動操作。因此,介面應依實際收到的指令推進,而不是依瀏覽器點擊或假定的自動訊息。機器人會收到類似 /start airplane 的文字,這裡沿用 Telegram 官方範例參數。

參數允許 A-Z、a-z、0-9、_ 和 -,最長 64 個字元。Telegram 建議以 base64url 編碼二進位等內容。但編碼不是加密,也不能建立信任。不要在網址放入密碼、bot token、API hash、電子郵件地址或可重複使用的登入憑證。

群組加入入口另有 startgroup 規格。不要把群組裡的指令當成私人帳號綁定的證明。

將路由與身分驗證分開

用途建議參數收到參數能證明什麼
開啟說明主題公開且在允許清單中的主題代碼使用者請求該主題
記錄活動入口公開活動代碼一次來源歸因,不是已驗證身分
綁定已登入的網站帳號不透明、單次使用的伺服器端參照有一筆仍待確認的關聯

使用者可以手動輸入指令或轉傳網址。因此,參數裡有客戶編號,不代表傳送者擁有該客戶資料。即使權杖不可預測,也可能被轉傳或外洩;隨機性不能單獨證明兩端帳號就是預期的配對。

若不確定憑證差異,先閱讀 Telegram API ID、API hash 與 bot token 比較。啟動參數是應用程式輸入,不是上述憑證。

建議的帳號綁定流程

以下是應用程式設計建議,不是 Telegram 提供的權杖服務,也不是新的 UnifyPort 端點。

  1. 從已登入的網站工作階段發起。 顯示即將綁定的帳號,要求使用者主動操作,並套用網站既有的工作階段與防請求偽造措施。
  2. 在伺服器建立待處理請求。 產生密碼學安全、適合網址使用的隨機權杖。儲存其雜湊、目標網站帳號、目標機器人、用途、到期時間及待處理狀態。這些是建議的本地紀錄,不是 Telegram API 欄位。有效期依風險政策設定,Telegram 的參數格式不會替應用程式設定期限。
  3. 接收並驗證真正的更新。 驗證接收入口,只處理目標機器人的私人聊天訊息,精確解析 /start 指令並檢查參數長度與字元。採用訊息中的傳送者身分,不採用參數自行宣稱的 ID。Bot API 參考定義了 Update 與 Message 物件。
  4. 先認領,不直接授權。 以原子操作把待處理請求關聯到觀察到的 Telegram 使用者。拒絕過期請求,以及已被認領後由其他使用者提出的嘗試。不要向尚未確認的 Telegram 傳送者透露網站帳號詳細資料。
  5. 回到原網站工作階段確認。 顯示待關聯的 Telegram 身分,請已登入的帳號擁有者批准。身分不符時取消,不要覆寫既有綁定。敏感流程也應在 Telegram 端加入適當確認。
  6. 只提交一次,保留必要的最少稽核紀錄。 權杖最終使用與帳號關聯應原子完成。重複投遞或再次按 Start 不得新增另一筆綁定、轉移關聯或重複發放權益。解除綁定應另有經過驗證的操作。

不要讓原始權杖進入分析工具、日誌、截圖或客服單。限制無效嘗試頻率;若始終沒有確認,讓請求到期,不授予存取權。

依缺少的環節排查

現象接著檢查
開啟連結卻沒收到指令機器人名稱、Start 操作與更新接收流程
只收到 /start提供一般引導,不從缺少的參數推測帳號
參數無效或過期請使用者從已登入網站重新發起
同一更新再次抵達沿用已儲存結果,不重複綁定
不同使用者提交已認領權杖拒絕並提供新流程,不自動轉移
機器人收到指令,網站仍等待檢查應用程式的認領與確認狀態

接收方式請參考 Bot API webhook 與統一入站 webhook 比較。輪詢或 webhook 都無法代替身分確認。

UnifyPort 的適用範圍

這套引導流程屬於官方 Telegram Bot。UnifyPort 的 Telegram 授權參考則記錄透過非官方介面連接既有帳號的驗證碼、QR Code 與工作階段匯入流程。啟動參數不會授權該帳號,也不能代替帳號擁有者的同意。

如果目標是接收既有訊息帳號的對話,請使用該授權流程及 message.received 事件。不要假設機器人深層連結會進入已連接的一般帳號收件匣。即使後續客服也涵蓋 WhatsApp、LINE 或 Zalo,身分綁定仍應由應用程式獨立管理。

常見問題

開啟網址就完成綁定了嗎?

沒有。必須等待機器人指令與應用程式的確認交易。點擊本身不能證明訊息送達或帳號所有權。

start 參數可以放客戶 ID 嗎?

可作為非敏感路由輸入,但不能作為授權依據。帳號綁定應使用隨機伺服器端參照與明確確認。

base64url 能保護機密嗎?

不能,它只是編碼。敏感資料留在伺服器;權杖使用或到期前,綁定網址都應視為敏感資訊。

這等同於 Telegram 使用者帳號登入嗎?

不等同。啟動機器人不會建立已授權的使用者工作階段。請依應用程式需要的身分選擇整合方式。

下一步與參考資料

先閱讀 Telegram 的深層連結規格,再測試參數缺少、網址轉傳、過期、重複更新、身分衝突與取消。這些是建議的驗收項目,不是已執行的測試結果。

官方資料核對日期:2026-11-10。

UnifyPort API

讓訊息接入變成一條穩定的產品管線。

先用統一 API 跑通傳送,再用標準事件把所有入站訊息接回業務系統。