Reply Handler

最後更新 2026-10-21

本頁說明 ReplyHandler 何時執行、回傳值送往何處，以及 panic 如何處理。

契約

type ReplyHandler func(ctx context.Context, input Input) string

每個平台套件都以自己的 Input 宣告此型別。Reply(handler) 只保存一個 handler，再次呼叫會取代前一個。收到事件的 SDK goroutine 會呼叫 handler 並等待結果，因此 handler 執行太久會延後該事件的回覆。

回傳值	結果
非空字串	以純文字回覆送出（目標見下表）
`""`	不送任何訊息；handler 自行送媒體、互動提示或多則訊息時使用

平台	事件
Telegram	所有 message update（文字、caption、圖片、文件；含群組，不檢查 mention）；`SendSelect` 按鈕點擊；`SendMultiSelect` 的 Done 點擊
Discord	bot 自己以外的所有 `MessageCreate`；`SendInput` 的 modal 送出；`SendSelect`／`SendMultiSelect` 的選取
LINE	text、image、video、audio、file 五種 message event（含 group 與 room，不檢查 mention）

其他事件類型一律略過。

平台	觸發	回覆目標
Telegram	訊息	同一個 chat，reply 到使用者訊息
Telegram	單選／多選	同一個 chat，reply 到 prompt 訊息
Discord	訊息	同一個 channel，reply 到使用者訊息
Discord	modal 送出／選取	reply 到傳給 `SendInput`／`SendSelect` 的 `replyTo`；`replyTo` 為 `""` 時改 reply 到 prompt 訊息
LINE	任何	以事件的一次性 reply token 呼叫 `ReplyMessage`

平台	傳給 handler 的 `ctx`
Telegram	polling 迴圈提供的 context（由 `Start` 的 context 衍生）
Discord	`Start` 建立的 bot 內部 context；未執行時收到的事件直接丟棄
LINE	每個 webhook request 一個：bot context 加 30 秒 timeout，同一 request 內的所有事件共用

handler 內的 panic 會被 recover 並以 slog.Warn("reply handler panic") 記錄；SDK goroutine 持續運作。