企業微信通訊錄
企業微信通訊錄能力用於把企業微信的成員、部門和組織結構接入到產品中。它適合成員選擇、部門權限、組織架構展示、身份映射和通知對象選擇等場景。適合什麼場景
- 在產品中展示企業微信部門樹。
- 根據部門或成員設定數據權限、審批人或負責人。
- 查詢員工資訊，用於任務分配、通知和組織協作。
- 將企業微信用戶身份與產品帳號對應起來。
接入前需要準備
企業微信後台需要配置什麼
企業微信通訊錄不像飛書那樣透過一組固定 scope key 批量導入。這裡主要配置的是自建應用的通訊錄權限、應用可見範圍和接口調用安全項。
常用通訊錄接口對應關係：
如何在 superun 中啟用
1
點擊「企業微信通訊錄」
在「研發」→「技能庫」中打開「企業微信通訊錄」，點擊使用，並說明產品裡需要使用成員、部門或身份映射的業務場景。
2
按引導完成基礎配置
如果專案還沒有配置企業微信基礎插件，對話框會引導你填寫 CorpID、AgentID 和 Secret；如果已經配置過，會直接複用已有配置。
3
開通通訊錄權限
按照 企業微信自建應用後台配置指南，在企業微信後台確認自建應用擁有通訊錄讀取權限，並設定應用可見範圍。
4
補充數據範圍
告訴 superun 需要讀取哪些部門、成員欄位，以及這些數據用於哪些頁面或流程。
5
發佈後測試
使用已綁定的企業備案網域進行測試，確認部門和成員數據可以正常讀取。
常見限制
- 企業微信要求網域備案主體與企業認證主體一致，開發預覽網域通常無法通過安全校驗。
- 應用可見範圍不足時，可能只返回部分成員或部門。
- 通訊錄欄位讀取遵循企業微信權限控制，敏感欄位需要額外授權。