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