2. 集成對接方案

2.1 集成方案概述

網易企業郵箱支持與釘釘對接集成，郵箱管理員通過配置釘釘自建企業郵箱應用，向企業用戶提供完整的郵箱——釘釘集成方案。用戶在釘釘企業郵應用中綁定郵箱賬號后，郵件到達的消息將會推送到釘釘中，用戶可在釘釘中進行接收新郵件提醒、查看郵件、轉發/回復郵件、發送郵件、移動郵件等操作，滿足用戶使用釘釘處理所有辦公的需求。

同時，釘釘對接方案中對接中采用了RSA加密算法和服務請求IP地址過濾等強大的技術安全手段來保障用戶數據安全。

2.2 術語解析

l 釘釘企業內部應用

企業內部應用是企業基于釘釘的開放能力，開發個性化的辦公應用供企業內部使用，例如將網易企業郵箱系統接入釘釘。企業內部應用發布后，企業內部用戶可以直接從釘釘工作臺中打開、使用該應用。

l 微應用

釘釘里能自由定制多個應用并進行個性化配置，處理不同的業務。為了同時滿足PC端和移動端的郵箱使用，網易企業郵箱使用微應用接入方式與釘釘集成。

2.3 集成流程

2.4 新建、配置企業郵箱應用

Step 1: 使用釘釘管理員賬號登錄釘釘開放平臺?https://developers.dingtalk.com/，點擊頁面上方**應用開發—>企業內部應用開發**。

Step 2：點擊頁面右上角“創建應用”，彈出菜單后按照要求進行相關填寫，注意選擇應用類型為：“H5微應用”，開發方式為：“企業自助開發”

Step 3：創建成功后，在應用配置界面中，記錄AgentId、AppKey和AppSecret，如下圖所示：

同時釘釘開放平臺首頁，記錄右上角所屬組織的CorpId。

2.5在網易企業郵箱后臺配置自建應用

前往網易企業郵箱管理后臺，進入【企業設置/自建應用管理】頁面。

點擊“新建應用”，選擇“釘釘自建應用”填寫相應字段后，點擊確認，即可完成自建應用的初始化。

完成配置初始化后，您可以點擊頁面中的“復制回調地址”，復制自建應用配置的相關信息。

2.6 配置微應用及回調地址

Step 1: 基礎配置。管理員進入釘釘管理后臺的微應用配置頁面，點擊頁面左側開發管理、再點擊頁面右上方的修改按鈕就可以對以上參數進行配置：

• 服務器出口IP： 59.111.178.93,220.197.30.*,220.197.31.*,220.197.32.*
• 應用首頁地址和PC端首頁地址相同，格式為：https://mail.域名/static/dingding/?corpId=$CORPID$Step 2: 添加免登授權碼跳轉地址。進入網易企業郵箱應用設置頁面/權限管理，如下圖所示：

配置的回調域名為：https://open.qiye.163.com/miniapp/dingding/qr/redirect

Step 3：配置應用權限。為了保證您能正常使用網易企業郵箱自建應用，您還需要配置以下權限：

• 通訊錄個人信息讀權限
• 企業員工手機號信息
• 郵箱等個人信息
• 通訊錄部門信息讀權限
• 成員信息讀權限
• 通訊錄部門成員讀權限
• 管理微應用的權限
• 查詢企業的微應用列表權限
• 調用OpenApp專有API時需要具備的權限

配置入口：網易企業郵箱應用設置頁面/權限管理，如下圖所示：

2.7 發布應用

配置完畢后，點擊保存。然后點擊下方版本管理與發布，選擇需要發布的用戶范圍后，保存即可。

至此，釘釘與網易企業郵箱集成對接已完成。

3. 接口應用步驟

1. 導入示例代碼
2. 生成密鑰：qiye.mail.tool.createKeyPair();

3. 把公鑰和IP地址告訴接口提供方進行授權。(注：單點登錄接口不需要限定IP，可以不提供)
4. 生成操作參數（原始字符串）。
5. 參數加密：com.netease.domainmail.Utils.encrypt(String priKey, String source);其中，priKey是私鑰，source是原始字符串，返回加密后的字符串。
6. 組裝完整URL請求地址。
7. 發送POST請求。
8. 返回操作結果。整個接口應用過程中， 接口調用流程如下：

4. 常見問題

Q：如何找到網易企業郵箱 API

A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’網易企業郵箱 API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。

Q：outlook報錯，服務器錯誤553，錯誤號 0x800CCC6E
A：

該報錯表示不合法的郵件信箱名稱。

建議：請用戶檢查輸入的地址是否正確，是否包含其他字符。

Q：響應服務器： 554 IP is rejected,smtp auth error limit exceed
A：錯誤表明身份身份驗證失敗次數超出限制，暫時鎖定此IP登錄。建議驗證信息設置稍后再重新嘗試。

Q：Foxmail提示錯誤：不知道這樣的主機。
A：這通常是因為郵箱數據文件（.box文件）或者郵箱索引文件（.ind文件）數據不一致或者遭到破壞引起的，一般可以通過修復郵箱操作加以修復。

Q：遠程主機關閉了一個現有的連接。
A：該報錯并非網易服務器的報錯，即客戶端在報錯當時并沒有成功連接上網易服務器。根據該問題反饋與解決的歷史記錄來看，本地網絡原因為主要原因。

Q：網易企業郵箱 API的替代品有哪些？

提供AI大模型API的服務商除了網易企業郵箱 API，還有其他替代服務商也提供類似api服務，例如：

mailslurp API開放平臺、Campaigner API開放平臺、CampaignKit API開放平臺

更多競品可以在冪簡集成開放平臺中找到。

Q：網易企業郵箱 API這個密鑰還適用于哪些api？

部門賬號同步、數據查詢、單點登錄、自定義登錄框

5.? 總結

本文全面且細致地闡述了獲取網易企業郵箱API開放平臺訪問token的每一步流程，為企業和開發者們提供了一份條理清晰、易于操作的指南。從初始的網易企業郵箱API開放平臺賬號注冊，到完成開發者身份驗證，再到最終成功取得訪問token，每一步都配備了詳盡的說明與指導，旨在確保用戶能夠順暢無阻地完成整個流程。在成功獲取訪問token后，本文還著重強調了進行可用性測試的重要性。這一步驟對于確保API能夠順利集成到企業郵箱管理系統中，并發揮出最佳效能至關重要。通過測試，企業和開發者們可以及時發現并解決可能存在的問題，為后續的API應用打下堅實的基礎。本文不僅為企業和開發者們提供了一份詳盡的指南，更為他們順利獲取并有效利用網易企業郵箱API開放平臺資源提供了強有力的支持。這不僅有助于提升郵箱管理系統的效率和安全性，更將進一步推動企業的數字化轉型進程。