跳轉到主要內容
superun 支持企業微信、飛書、釘釘三大辦公平台的插件整合。配置完成後,你的專案可以使用對應平台的 OAuth 登入、訊息推送等能力。

支持的平台

平台需要的憑證主要能力
企業微信Corp ID、Secret、Agent IDOAuth 登入、企業成員校驗
飛書App ID、App SecretOAuth 登入、機器人訊息、雲端文件
釘釘App Key、App SecretOAuth 登入、企業成員校驗

通用配置流程

所有三個平台的配置流程類似:

第一步:在開放平台建立應用

第二步:在 superun 中配置憑證

  1. 開啟專案,進入 研發 → 技能庫 面板
  2. 找到對應平台的插件卡片
  3. 填寫從開放平台取得的憑證資訊
  4. 儲存配置

第三步:配置安全設定

這是最關鍵的一步——你需要在對應開放平台中配置正確的回呼地址和可信域名。

安全設定詳解

在 superun 中啟用插件時,系統會自動產生以下配置資訊供你複製:

重新導向 URL(OAuth 回呼地址)

系統會根據專案狀態自動拼接正確的回呼地址:
  • 未發布專案(預覽階段)https://id--{sessionId}.{domain}/auth/callback/feishu
  • 已發布專案https://{projectKey}.{domain}/auth/callback/feishu
將此地址填入開放平台的「重新導向 URL」或「OAuth 回呼地址」中。

可信域名

將專案的域名添加到開放平台的可信域名列表中:
  • 未發布專案使用預覽域名
  • 已發布專案使用正式域名或自訂域名

IP 白名單

部分平台(如企業微信)需要配置 IP 白名單。superun 託管服務的出口 IP 會在安全設定卡中展示,複製後添加到開放平台即可。
專案發布後域名會發生變化(從預覽域名變為正式域名),請記得同步更新開放平台中的回呼地址和可信域名。

透過對話啟用插件

除了在技能庫面板手動配置,你還可以在對話中讓 AI 幫你啟用插件:
  1. 在對話中描述需要的功能(如「接入飛書掃碼登入」)
  2. AI 識別後會觸發插件啟用引導
  3. 按照引導填寫憑證和配置安全設定
  4. 確認啟用後系統自動完成整合

各平台配置要點

企業微信

1

取得憑證

在企業微信管理後台 → 應用管理 → 自建應用中,取得 Corp IDSecretAgent ID
2

配置可信域名

在應用詳情 → 網頁授權及 JS-SDK 中,添加專案域名為可信域名。
3

配置 IP 白名單

在應用詳情中,將 superun 託管服務的出口 IP 添加到白名單。
4

填寫回呼地址

在應用詳情 → OAuth2.0 回呼域名中,填寫 superun 提供的重新導向 URL。
企業微信有 IP 白名單限制。若需固定出口 IP 代理,可在對話中請 AI 協助配置,或結合專案安全設定中的出口 IP 說明在開放平台中填寫。

飛書

1

取得憑證

在飛書開放平台 → 應用詳情 → 憑證與基礎資訊中,取得 App IDApp Secret
2

配置權限

在權限管理中添加所需的 API 權限(系統會提供所需權限列表,支持批量匯入)。
3

配置重新導向 URL

在安全設定 → 重新導向 URL 中,添加 superun 提供的回呼地址。
4

配置可信域名

在安全設定中,將專案域名添加到可信域名列表。

釘釘

1

取得憑證

在釘釘開放平台 → 應用詳情 → 基礎資訊中,取得 App KeyApp Secret
2

配置回呼地址

在應用詳情 → 登入與分享中,填寫 superun 提供的重新導向 URL。
3

發布應用

在釘釘開放平台中發布應用,確保組織內成員可以使用。

相關文件

飛書整合

OAuth 登入、機器人訊息等與飛書對接的說明

企業微信整合

掃碼登入、成員校驗等與企業微信對接的說明

釘釘整合

掃碼登入等與釘釘對接的說明

常見問題

專案發布後域名從預覽域名變為正式域名。請前往對應開放平台,將回呼地址和可信域名更新為正式域名。
請檢查:1) 憑證是否正確複製(注意前後空格);2) 回呼地址是否與當前專案域名匹配;3) 所需權限是否已申請並審批通過。
可以。每個平台的插件獨立配置、獨立運行,互不衝突。