Bot 生命週期
最後更新
本頁說明
New、Start、Close、Status 在各平台做了什麼。呼叫順序
New(...)建立 SDK client 並驗證必要參數。Discord 與 LINE 在這一步不打網路；Telegram 的 SDK 會呼叫一次getMe（5 秒逾時），所以錯誤的 Telegram token 在New就會失敗。此時所有平台都還不接收事件。Reply(handler)註冊 handler。可在Start前或後呼叫；沒有 handler 時抵達的事件會以slog.Warn("Reply is not set")記錄後丟棄。Start(ctx)驗證憑證，再開始接收事件。Close()停止接收，並清除該 bot 的互動狀態。
各平台的 Start
| 平台 | 憑證檢查（失敗即回 error） | 接著 | 第二次 Start |
|---|---|---|---|
| Telegram | GetMe | GetWebhookInfo；若已設定 webhook URL 則 DeleteWebhook（兩者失敗都只 warn）；long polling 在 goroutine 執行 | 回 nil |
| Discord | REST User("@me") | Session.Open() 開啟 WebSocket gateway | 回 nil |
| LINE | GetBotInfo | 在 :<port> 執行 net.Listen（綁定失敗立即回 error），再於 goroutine 執行 http.Server.Serve | 回 nil |
Start 會從你傳入的 ctx 衍生內部 context。取消該 ctx 會停止 Telegram polling；Discord 與 LINE 在 bot 關閉後不再呼叫 handler。各平台的 Close
| 平台 | 步驟 |
|---|---|
| Telegram | 取消 polling 並等待 polling goroutine 結束；停止所有 status timer；把所有未完成的多選標記為完成並移除 |
| Discord | 取消 context 並關閉 gateway session；停止 status timer；移除未完成的 input 與 select 狀態 |
| LINE | 取消 context；以 5 秒 timeout 執行 http.Server.Shutdown；等待 server goroutine 結束 |
對從未啟動或已關閉的 bot 呼叫
Close 會回 nil。Status
Status() 在 bot 的 mutex 下讀取快照。身分欄位來自 Start 的憑證檢查，在那之前保持空值。| 平台 | 欄位 |
|---|---|
| Telegram | Running bool、Username string、UserID int64 |
| Discord | Running bool、Username string、UserID string |
| LINE | Running bool、UserID string、BasicID string、DisplayName string |