支持的平台
| 平台 | 需要的憑證 | 主要能力 |
|---|---|---|
| 企業微信 | Corp ID、Secret、Agent ID | OAuth 登入、企業成員校驗 |
| 飛書 | App ID、App Secret | OAuth 登入、機器人訊息、雲端文件 |
| 釘釘 | App Key、App Secret | OAuth 登入、企業成員校驗 |
通用配置流程
所有三個平台的配置流程類似:第一步:在開放平台建立應用
第二步:在 superun 中配置憑證
- 開啟專案,進入 研發 → 技能庫 面板
- 找到對應平台的插件卡片
- 填寫從開放平台取得的憑證資訊
- 儲存配置
第三步:配置安全設定
這是最關鍵的一步——你需要在對應開放平台中配置正確的回呼地址和可信域名。安全設定詳解
在 superun 中啟用插件時,系統會自動產生以下配置資訊供你複製:重新導向 URL(OAuth 回呼地址)
系統會根據專案狀態自動拼接正確的回呼地址:- 未發布專案(預覽階段):
https://id--{sessionId}.{domain}/auth/callback/feishu - 已發布專案:
https://{projectKey}.{domain}/auth/callback/feishu
可信域名
將專案的域名添加到開放平台的可信域名列表中:- 未發布專案使用預覽域名
- 已發布專案使用正式域名或自訂域名
IP 白名單
部分平台(如企業微信)需要配置 IP 白名單。superun 託管服務的出口 IP 會在安全設定卡中展示,複製後添加到開放平台即可。透過對話啟用插件
除了在技能庫面板手動配置,你還可以在對話中讓 AI 幫你啟用插件:- 在對話中描述需要的功能(如「接入飛書掃碼登入」)
- AI 識別後會觸發插件啟用引導
- 按照引導填寫憑證和配置安全設定
- 確認啟用後系統自動完成整合
各平台配置要點
企業微信
企業微信有 IP 白名單限制。若需固定出口 IP 代理,可在對話中請 AI 協助配置,或結合專案安全設定中的出口 IP 說明在開放平台中填寫。
飛書
釘釘
相關文件
飛書整合
OAuth 登入、機器人訊息等與飛書對接的說明
企業微信整合
掃碼登入、成員校驗等與企業微信對接的說明
釘釘整合
掃碼登入等與釘釘對接的說明
常見問題
發布後回呼地址失效了?
發布後回呼地址失效了?
專案發布後域名從預覽域名變為正式域名。請前往對應開放平台,將回呼地址和可信域名更新為正式域名。
配置了憑證但 OAuth 登入失敗?
配置了憑證但 OAuth 登入失敗?
請檢查:1) 憑證是否正確複製(注意前後空格);2) 回呼地址是否與當前專案域名匹配;3) 所需權限是否已申請並審批通過。
三個平台可以同時啟用嗎?
三個平台可以同時啟用嗎?
可以。每個平台的插件獨立配置、獨立運行,互不衝突。

