釘釘

釘釘機器人透過 Stream 長連線收訊息，常駐 Gateway 主動連線平台，無需暴露公用網路入站 Webhook。先在應用程式中啟用機器人能力和 Stream 訊息訂閱。

連線需要哪些欄位

Dashboard 通訊管道 → 新增 → DingTalk 的預設 Stream 接入使用 client_id、client_secret。需要顯式匹配應用身分時，可填寫 bot_user_id、bot_staff_id、robot_code，不要猜這些值。預設帳號 ID 為 work。

平台端設定可參考釘釘 Stream SDK 資料。儲存成功僅表示本機帳號操作已提交，還要檢查傳輸和應用權限。

處理私訊授權

預設私訊 pairing、群組對話 mention。透過 anyy setup channel 的互動精靈，可改私訊為 pairing/open/allowlist/disabled、群組對話為 mention/open/allowlist/disabled；Dashboard 認證資料表單沒有這些策略欄位。目前公開設定也沒有釘釘名單條目編輯輸入，見訊息平台。

收到私訊配對請求後：

anyy channel pairing list --channel dingtalk
anyy channel pairing approve --request REQUEST_ID

核對平台身分，批准後傳送一則新私訊；另在群組中使用明確的 @機器人 訊息測試。

診斷順序

anyy channel reload
anyy channel doctor dingtalk

無法建立 Stream 時，先看 Gateway 是否線上，再看出站網路、Client 認證資料與訊息訂閱。收到事件卻未回覆時，檢查存取策略和提及；能收不能發時，檢查 Bot 身分、回覆上下文和應用程式的訊息傳送權限。不要把身分欄位有效當成整個訊息流程已驗證。