使用DingTalk、專屬釘和飛書通知渠道 - Data Management

DMS訊息通知接入普通DingTalk、專屬DingTalk和飛書通知渠道，支援在移動端和用戶端查看通知，並支援審批人在移動端進行工單審批。

前提條件

已在DingTalk或飛書中建立組織。

說明

該組織為企業的內部組織，而非阿里雲的公用組織，例如阿里雲服務支援。

注意事項

僅支援在移動端進行工單審批。
如果您為阿里集團內部使用者，請聯絡DMS支援人員（DingTalk群號：67215001618）。

準備工作

配置接收訊息的應用。
普通DingTalk/專屬DingTalk
1. 建立應用。
  1. 登入並加入DingTalk組織。
    登入DingTalk開放平台。
    選擇企業所在的組織。例如“XXX測試組織”。
  2. 訪問DingTalk後台，建立DingTalk應用。
    單擊頁面右上方的我的後台。
    單擊應用開發頁簽，在左側導覽列選擇企業內部應用 > DingTalk應用。
    單擊建立應用。
    輸入應用程式名稱和應用描述，單擊儲存。
  3. 配置接收訊息的DingTalk機器人。
    單擊已建立應用的名稱，進入應用編輯頁面。
    在左側導覽列中，選擇應用能力 > 添加應用能力，並在該頁面添加一個機器人。
    配置機器人相關資訊，包含機器人簡介、機器人描述和訊息接收模式等，並單擊發布。
    說明
    訊息接收模式選擇HTTP模式。
  4. 配置網頁應用資訊。
    在應用能力菜單下，單擊網頁應用。
    配置應用首頁地址，並單擊儲存。
    填寫應用地址需要參考當前DMS資料處理地區。例如資料處理地區為新加坡，則應用首頁地址為https://dms-ap-southeast-1.alibabacloud.com。
    說明
    查看資料處理地區的具體操作，請參見切換DMS部署地區。
    華東1（杭州）：https://dms-cn-hangzhou.alibabacloud.com。
    日本（東京）：https://dms-ap-northeast-1.alibabacloud.com。
    新加坡：https://dms-ap-southeast-1.alibabacloud.com。
    馬來西亞（吉隆坡）：https://dms-ap-southeast-3.alibabacloud.com。
    印尼（雅加達）：https://dms-ap-southeast-5.alibabacloud.com。
    沙特（利雅得）：https://dms-me-central-1.alibabacloud.com。
  5. 配置許可權。
    在左側導覽列中選擇開發配置 > 許可權管理，申請如下許可權：
    調用SNS API時需要具備的基本許可權
    成員資訊讀許可權
    根據手機號擷取成員基本資料許可權
    調用企業API基礎許可權
    擷取DingTalk開放介面使用者訪問憑證的基礎許可權
    DingTalk群基礎資訊系統管理權限
    企業內機器人發送訊息許可權
    互動卡片執行個體寫入權限
  6. 建立新版本並發布。
    企業自建應用需要供企業內其他使用者使用，則必鬚髮布一個版本。
    在左側導覽列中選擇版本管理與發布，單擊建立新版本，填寫相關配置資訊，並單擊儲存。
2. 建立卡片。
  1. 建立模板。
    進入卡片平台，單擊建立模板。
    填入模板名稱、選擇卡片類型、卡片模板情境等資訊，並單擊建立。
    卡片模板情境選擇普通卡片，關聯應用選擇建立的應用。
  2. 匯入卡片模板。
    選擇更多 > 匯入模板，匯入訊息通知卡片模板並儲存。
  3. 發布訊息通知卡片模板。
飛書/飛書國際版（Lark）
1. 登入飛書或Lark開放平台並進入開發人員後台。
  1. 訪問飛書開放平台或Lark開放平台。
  2. 單擊登入。
    登入的帳號需要在目標企業組織下，例如組織名為“XXX測試組織”。
  3. 登入後進入開發人員後台。
2. 單擊建立企業自建應用，配置名稱、應用描述等相關資訊，再單擊建立。更多資訊，企業自建應用開發流程。
3. 添加飛書機器人。
  1. （可選）單擊應用程式名稱，進入應用編輯頁面。
    說明
    如果新建立的應用，則可忽略該步驟。
  2. 在左側導覽列中，選擇應用能力 > 添加應用能力。
  3. 在按能力添加頁簽下，單擊機器人卡片上的添加。
  4. 在機器人頁面，輸入機器人名稱，單擊儲存。
4. 添加網頁應用。
  1. 在左側導覽列中，選擇應用能力 > 添加應用能力。
  2. 在按能力添加頁簽下，單擊網頁應用卡片上的添加。
  3. 在網頁應用頁面，填寫移動端首頁地址，並單擊儲存。
    填寫首頁地址需要參考當前DMS資料處理地區。例如資料處理地區為新加坡，則應用首頁地址為https://dms-ap-southeast-1.alibabacloud.com。
    說明
    查看資料處理地區的具體操作，請參見切換DMS部署地區。
    華東1（杭州）：https://dms-cn-hangzhou.alibabacloud.com。
    日本（東京）：https://dms-ap-northeast-1.alibabacloud.com。
    新加坡：https://dms-ap-southeast-1.alibabacloud.com。
    馬來西亞（吉隆坡）：https://dms-ap-southeast-3.alibabacloud.com。
    印尼（雅加達）：https://dms-ap-southeast-5.alibabacloud.com。
    沙特（利雅得）：https://dms-me-central-1.alibabacloud.com。
5. 添加重新導向URL以及H5可信網域名稱。
  1. 在左側導覽列中，選擇開發配置 > 安全設定。
  2. 在重新導向URL頁簽下，配置重新導向URL和H5可信網域名稱。
    配置重新導向URL和H5可信網域名稱都需要參考DMS資料處理地區，例如DMS資料處理地區在新加坡，那麼重新導向URL為https://dms-ap-southeast-1.alibabacloud.com/console/mobile/index/，H5可信網域名稱為https://dms-ap-southeast-1.alibabacloud.com。
  3. 分別單擊添加。
6. 配置應用許可權。
  1. 在左側導覽列中，選擇開發配置 > 使用權限設定。
  2. 在API許可權頁簽下，申請如下許可權。許可權配置操作及許可權說明，請參見申請許可權和許可權說明。
    擷取使用者USER ID
    通過手機號或郵箱擷取使用者ID
    上傳圖片和附件到雲文檔中
    說明
    Lark不支援此許可權。
    擷取與發送單聊、群組訊息
    以應用的身份發訊息
    給多個使用者批量發訊息
    擷取與上傳圖片或檔案資源
7. 發布應用版本。
  如果企業自建應用需要給企業內其他使用者使用，則必須要發布一個版本。
  1. 在左側導覽列中選擇應用發布 > 版本管理與發布。
  2. 單擊建立版本。
  3. 填寫應用版本號碼、選擇移動端的預設能力等資訊，單擊儲存。
    可用範圍選擇全部成員。
擷取DingTalk、專屬釘或飛書的關鍵資訊。該資訊將用於DMS配置通知渠道。
普通DingTalk
- 擷取應用AppId、AgentId、AppKey、AppSecret
  在DingTalk開放平台的憑證與基礎資訊頁面擷取應用AppId、AgentId、AppKey、AppSecret。
- 擷取RobotCode
  在DingTalk開發平台的應用能力 > 機器人頁面擷取RobotCode。
- 擷取卡片模板ID
  在卡片平台的範本管理員 > 模板列表頁面擷取。
- 擷取CorpId（可選）
  進入DingTalk開發人員後台，單擊頭像擷取CorpId。
  說明
  在DMS通知渠道中配置CorpId參數後，後續您無需切換DingTalk組織到企業自建應用所在的組織即可接收訊息並進行審批工單操作。
專屬DingTalk
- 擷取應用AppKey、AppSecret
  在DingTalk開放平台的基礎資訊頁面擷取應用AppKey、AppSecret。
- 擷取RobotCode
  在DingTalk開放平台的機器人頁面，查看憑證資訊來擷取RobotCode。
- 擷取卡片模板ID
  在卡片平台的開發工具 > 卡片搭建頁面擷取。
- 擷取CorpId（可選）
  進入DingTalk開發人員後台，單擊頭像擷取CorpId。
  說明
  在DMS通知渠道中配置CorpId參數後，後續審批訊息時，無需切換DingTalk組織到企業自建應用所在的組織即可接收訊息並進行審批工單操作。
飛書/Lark
在飛書開放平台或Lark開放平台的基礎資訊 > 憑證與基礎資訊頁面擷取AppId、AppSecret。

步驟一：在DMS開通並配置通知渠道

DMS渠道管理功能用於啟用或禁用租戶層級的通知渠道，以及維護飛書、專屬釘等應用的配置資訊。

說明

開通目標渠道後，您在DMS中配置的通知資訊才可生效，DMS將通過該渠道向您發送訊息通知。

僅管理員或DBA支援配置通知渠道。

登入Data Management 5.0。
單擊控制台左上方的表徵圖，選擇全部功能 > 營運管理 > 通知管理。
說明
若您使用的是非極簡模式的控制台，請在頂部功能表列中，選擇營運管理 > 通知管理。
單擊頁面左上方的渠道管理。
選中目標式通知渠道。
配置飛書、Lark、DingTalk或專屬DingTalk所需的資訊。
如下以配置飛書渠道資訊舉例，其他渠道配置操作與此樣本類似。
1. 單擊飛書渠道地區的編輯。
2. 輸入AppId、AppSecret，單擊儲存。

步驟二：設定接收訊息通知的使用者

如下以配置待審批資料匯出工單的通知為例：

管理員將待接收訊息的使用者錄入DMS。具體操作，請參見使用者管理。
管理員或DBA進入DMS通知管理功能頁面。
在通知管理功能頁面，選擇需要通知的DMS功能模組更新訊息。
在模組/業務類型篩選框中，選擇工單 > 資料匯出。
找到待審批業務狀態的工單，單擊右側的修改。
在附加通知使用者參數地區，選擇目標使用者，並單擊確認。
開啟訊息通知。
後續待審批的資料匯出工單通知將直接發送至目標使用者的DingTalk、專屬釘或飛書。

移動端通知效果展示

DingTalk/專屬DingTalk	飛書

您可以單擊審批卡片查看詳情。

常見問題

Q：在個人語音總機中配置了飛書、DingTalk、專屬釘或Lark的渠道資訊，為什麼在飛書、DingTalk或其他渠道中未收到DMS的訊息通知呢？
A：請檢查您是否已開通飛書、DingTalk、專屬釘或Lark通知渠道。開通對應渠道後，您配置的資訊才可生效，DMS將通過該渠道向您發送訊息通知。開通操作，請參見步驟一：在DMS開通並配置通知渠道。
Q：為什麼配置了通知渠道資訊和接收訊息的使用者，還是沒有接收到DingTalk或飛書訊息？
A：請根據如下步驟解決問題：
1. 檢查管理員或DBA是否已在DMS通知管理 > 渠道管理中開啟對應的渠道。更多資訊，請參見步驟一：在DMS開通並配置通知渠道。
2. 單擊DMS帳戶圖片，確保通知方式中對應的通知渠道為開啟狀態。
Q：未修改通知設定，突然無法接收DingTalk或飛書訊息，可能是什麼原因？
A：可能是因為企業自建應用的API調用量超出限制，導致無法接收到訊息。您可以在DingTalk或飛書的開發人員後台查看API調用量。調整API調用次數的操作，請參見DingTalk和飛書。

Data Management：使用普通DingTalk、專屬DingTalk、飛書和Lark通知訊息

前提條件

注意事項

準備工作

普通DingTalk/專屬DingTalk

飛書/飛書國際版（Lark）

普通DingTalk

專屬DingTalk

飛書/Lark

步驟一：在DMS開通並配置通知渠道

步驟二：設定接收訊息通知的使用者

移動端通知效果展示

相關文檔

常見問題