釘釘插件
釘釘插件用於把釘釘帳號、組織協作和知識庫文件能力接入到 superun 產品中。它適合需要統一企業登入、成員校驗和團隊文件協作的業務。可以接入哪些能力
| 能力 | 適合場景 | 說明 |
|---|---|---|
| 釘釘登入 | 企業內部系統、員工門戶 | 用戶使用釘釘帳號進入產品 |
| 企業成員校驗 | 企業白名單、內部訪問控制 | 控制哪些釘釘組織成員可以使用產品 |
| 釘釘文件寫入 | 週報、會議紀要、知識庫歸檔 | 在釘釘知識庫中建立、寫入或更新文件 |
接入前需要準備
- 釘釘開放平台的管理員權限。
- 一個釘釘企業內部應用，並取得 Client ID 和 Client Secret。
- 已發佈的 superun 專案網域，用於配置登入回呼地址。
- 根據要接入的能力，在釘釘開放平台開通對應權限並發佈應用。
建議開通的能力範圍
在 釘釘開放平台 建立企業內部應用後，建議按實際接入目標分層開通，不需要一次性打開所有權限。| 接入目標 | 建議開通範圍 | 需要關注的權限 / 配置 | 說明 |
|---|---|---|---|
| 釘釘登入 | 企業內部應用、登入與分享、登入回呼網域 | Contact.User.Read；按需 Contact.User.mobile | 用於讀取登入用戶基礎資訊。需要手機號時再額外申請手機號權限 |
| 企業成員校驗 | 登入能力 + 企業成員資訊讀取 | Contact.User.Read；企業資訊讀權限按需開通 | 用於判斷用戶是否屬於目標釘釘組織、部門或可訪問範圍 |
| 釘釘文件寫入 | 知識庫和文件相關能力 | Wiki.Workspace.Read、Document.WorkspaceDocument.Write，按需 Wiki.Workspace.Write | 用於選擇知識庫、建立知識庫文件和寫入內容，詳見 釘釘文件寫入 |
應用可見範圍建議
- 調試階段：建議先把應用可見範圍設定為開發團隊或測試部門，避免影響全員。
- 上線階段：設定為實際會使用該產品的部門、成員或全部員工。
- 如果接入文件寫入：應用可見範圍需要覆蓋執行授權的釘釘用戶，目標知識庫也要給該用戶相應的查看或編輯權限。
釘釘權限申請後通常還需要管理員審批，並在開放平台發佈應用後才會生效。僅保存權限配置但未發佈，可能導致 superun 側仍然提示權限不足。
如何在 superun 中啟用
建立釘釘企業內部應用
打開 釘釘開放平台，進入「企業內部開發」，建立應用並完成基礎資訊配置。
子能力說明
釘釘文件寫入
接入知識庫文件建立、內容寫入、文件更新和協作歸檔。