渠道
連線釘釘（DingTalk）
通過 Stream 模式把釘釘機器人連線到 Buda 智慧體——可以掃碼自動建立應用，也可以手動填寫 Client ID 和 Secret。
在釘釘裡給團隊配一位 AI 同事，讓同事在私信和群聊中都能找它對話。Buda 通過釘釘的 Stream 模式（一條持久的出站 WebSocket 連線）接入，因此無需託管公網 URL。
連線機器人
Buda 提供兩種連線方式：掃碼讓釘釘自動建立應用，或使用你已有應用的憑據手動填寫。
開啟新增渠道
在 Buda 中開啟 Settings → Channels，點選 Add Channel，選擇 DingTalk。
掃碼連線（推薦）
在 Scan to connect（掃碼連線） 標籤頁點選 Start scan（開始掃碼）。Buda 會顯示一個二維碼——開啟釘釘掃描它，並在釘釘中確認授權。釘釘會在你的組織內自動建立一個應用，並把應用憑據直接返回給 Buda，你完全不需要開啟釘釘開放平臺。
或手動填寫憑據
如果你已經有一個應用，切換到 Enter manually（手動輸入） 標籤頁。前往釘釘開放平臺建立（或複用）一個已啟用機器人能力並開啟 Stream 模式的企業內部應用，然後複製：
- Client ID（AppKey）
- Client Secret（AppSecret）
把兩者貼上到 Buda 中，可選地設定標籤和目標智慧體，然後點選 Connect。
測試
在釘釘中找到該機器人並傳送一條私信，例如 Hi。在群聊中，需要 @ 機器人才能收到回覆。
在群聊中使用
把機器人加入釘釘群聊，並 @ 它以觸發回覆——群裡沒有 @ 機器人的訊息會被忽略。私信則無需 @。
目前只處理文字訊息——釘釘的其他訊息型別（圖片、檔案、卡片等）會被忽略。
故障排查
| 現象 | 解決辦法 |
|---|---|
| 機器人無響應 | 確認渠道顯示 Active；如果是手動連線，重新核對 Client ID / Client Secret |
| 群聊中沒有回覆 | 群聊中必須 @ 機器人 |
| 二維碼已過期 | 回到 Add Channel 重新開始掃碼 |
| 憑據洩露 | 在釘釘開放平臺重置 AppSecret，然後在 Buda 的渠道設定中更新 |