全部產品
Search
文件中心

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

更新時間:Jan 27, 2025

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

前提條件

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

說明

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

注意事項

  • 僅支援在移動端進行工單審批。

  • 如果您為阿里集團內部使用者,請聯絡DMS支援人員(DingTalk群號:67215001618)。

準備工作

  1. 配置接收訊息的應用。

    普通DingTalk/專屬DingTalk

    1. 建立應用

      1. 登入並加入DingTalk組織。

        1. 登入DingTalk開放平台

        2. 選擇企業所在的組織。例如“XXX測試組織”。

          image

      2. 訪問DingTalk後台,建立DingTalk應用。

        1. 單擊頁面右上方的我的後台

        2. 單擊應用開發頁簽,在左側導覽列選擇企業內部應用 > DingTalk應用

        3. 單擊建立應用

          image

        4. 輸入應用程式名稱應用描述,單擊儲存

      3. 配置接收訊息的DingTalk機器人。

        1. 單擊已建立應用的名稱,進入應用編輯頁面。

        2. 在左側導覽列中,選擇應用能力 > 添加應用能力,並在該頁面添加一個機器人。

        3. 配置機器人相關資訊,包含機器人簡介機器人描述訊息接收模式等,並單擊發布

          說明

          訊息接收模式選擇HTTP模式。

      4. 配置網頁應用資訊。

        1. 應用能力菜單下,單擊網頁應用

        2. 配置應用首頁地址,並單擊儲存

          填寫應用地址需要參考當前DMS資料處理地區。例如資料處理地區為新加坡,則應用首頁地址為https://dms-ap-southeast-1.alibabacloud.com

          說明

          查看資料處理地區的具體操作,請參見切換DMS部署地區

          image

          • 華東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. 建立模板。

        1. 進入卡片平台,單擊建立模板

        2. 填入模板名稱、選擇卡片類型卡片模板情境等資訊,並單擊建立

          卡片模板情境選擇普通卡片,關聯應用選擇建立的應用。

          image

      2. 匯入卡片模板。

        選擇更多 > 匯入模板,匯入訊息通知卡片模板並儲存。

        image

      3. 發布訊息通知卡片模板。

    飛書/飛書國際版(Lark)

    1. 登入飛書或Lark開放平台並進入開發人員後台。

      1. 訪問飛書開放平台Lark開放平台

      2. 單擊登入

        登入的帳號需要在目標企業組織下,例如組織名為“XXX測試組織”。

      3. 登入後進入開發人員後台

    2. 單擊建立企業自建應用,配置名稱應用描述等相關資訊,再單擊建立。更多資訊,企業自建應用開發流程

      image

    3. 添加飛書機器人。

      1. (可選)單擊應用程式名稱,進入應用編輯頁面。

        說明

        如果新建立的應用,則可忽略該步驟。

      2. 在左側導覽列中,選擇應用能力 > 添加應用能力

      3. 按能力添加頁簽下,單擊機器人卡片上的添加

        image

      4. 機器人頁面,輸入機器人名稱,單擊儲存

        image

    4. 添加網頁應用。

      1. 在左側導覽列中,選擇應用能力 > 添加應用能力

      2. 按能力添加頁簽下,單擊網頁應用卡片上的添加

      3. 網頁應用頁面,填寫移動端首頁地址,並單擊儲存

        填寫首頁地址需要參考當前DMS資料處理地區。例如資料處理地區為新加坡,則應用首頁地址為https://dms-ap-southeast-1.alibabacloud.com

        說明

        查看資料處理地區的具體操作,請參見切換DMS部署地區

        image

        • 華東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頁簽下,配置重新導向URLH5可信網域名稱

        配置重新導向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. 填寫應用版本號碼、選擇移動端的預設能力等資訊,單擊儲存

        可用範圍選擇全部成員

  2. 擷取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支援配置通知渠道。

  1. 登入Data Management 5.0

  2. 單擊控制台左上方的2023-01-28_15-57-17.png表徵圖,選擇全部功能 > 營運管理 > 通知管理

    說明

    若您使用的是非極簡模式的控制台,請在頂部功能表列中,選擇營運管理 > 通知管理

  3. 單擊頁面左上方的渠道管理

  4. 選中目標式通知渠道。

  5. 配置飛書、Lark、DingTalk或專屬DingTalk所需的資訊。

    如下以配置飛書渠道資訊舉例,其他渠道配置操作與此樣本類似。

    1. 單擊飛書渠道地區的編輯

    2. 輸入AppIdAppSecret,單擊儲存

      image

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

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

  1. 管理員將待接收訊息的使用者錄入DMS。具體操作,請參見使用者管理

  2. 管理員或DBA進入DMS通知管理功能頁面。

    在通知管理功能頁面,選擇需要通知的DMS功能模組更新訊息。

  3. 模組/業務類型篩選框中,選擇工單 > 資料匯出

  4. 找到待審批業務狀態的工單,單擊右側的修改

  5. 附加通知使用者參數地區,選擇目標使用者,並單擊確認

    image

  6. 開啟訊息通知。

    後續待審批的資料匯出工單通知將直接發送至目標使用者的DingTalk、專屬釘或飛書。

移動端通知效果展示

DingTalk/專屬DingTalk

飛書

image

image

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

image

相關文檔

DMS支援在移動端快速處理工單,極大地提高了研發效率。具體操作,請參見在移動端審批工單

常見問題

  • Q:在個人語音總機中配置了飛書、DingTalk、專屬釘或Lark的渠道資訊,為什麼在飛書、DingTalk或其他渠道中未收到DMS的訊息通知呢?

    A:請檢查您是否已開通飛書、DingTalk、專屬釘或Lark通知渠道。開通對應渠道後,您配置的資訊才可生效,DMS將通過該渠道向您發送訊息通知。開通操作,請參見步驟一:在DMS開通並配置通知渠道

  • Q:為什麼配置了通知渠道資訊和接收訊息的使用者,還是沒有接收到DingTalk或飛書訊息?

    A:請根據如下步驟解決問題:

    1. 檢查管理員或DBA是否已在DMS通知管理 > 渠道管理中開啟對應的渠道。更多資訊,請參見步驟一:在DMS開通並配置通知渠道

      image

    2. 單擊DMS帳戶圖片,確保通知方式中對應的通知渠道為開啟狀態。

      image

  • Q:未修改通知設定,突然無法接收DingTalk或飛書訊息,可能是什麼原因?

    A:可能是因為企業自建應用的API調用量超出限制,導致無法接收到訊息。您可以在DingTalk或飛書的開發人員後台查看API調用量。調整API調用次數的操作,請參見DingTalk飛書