DMS訊息通知接入普通DingTalk、專屬DingTalk和飛書通知渠道,支援在移動端和用戶端查看通知,並支援審批人在移動端進行工單審批。
前提條件
已在DingTalk或飛書中建立組織。
該組織為企業的內部組織,而非阿里雲的公用組織,例如阿里雲服務支援。
注意事項
僅支援在移動端進行工單審批。
如果您為阿里集團內部使用者,請聯絡DMS支援人員(DingTalk群號:67215001618)。
準備工作
配置接收訊息的應用。
普通DingTalk/專屬DingTalk
建立應用。
登入並加入DingTalk組織。
登入DingTalk開放平台。
選擇企業所在的組織。例如“XXX測試組織”。
訪問DingTalk後台,建立DingTalk應用。
單擊頁面右上方的我的後台。
單擊應用開發頁簽,在左側導覽列選擇
。單擊建立應用。
輸入應用程式名稱和應用描述,單擊儲存。
配置接收訊息的DingTalk機器人。
單擊已建立應用的名稱,進入應用編輯頁面。
在左側導覽列中,選擇
,並在該頁面添加一個機器人。配置機器人相關資訊,包含機器人簡介、機器人描述和訊息接收模式等,並單擊發布。
說明訊息接收模式選擇HTTP模式。
配置網頁應用資訊。
在應用能力菜單下,單擊網頁應用。
配置應用首頁地址,並單擊儲存。
填寫應用地址需要參考當前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
。
配置許可權。
在左側導覽列中選擇
,申請如下許可權:調用SNS API時需要具備的基本許可權
成員資訊讀許可權
根據手機號擷取成員基本資料許可權
調用企業API基礎許可權
擷取DingTalk開放介面使用者訪問憑證的基礎許可權
DingTalk群基礎資訊系統管理權限
企業內機器人發送訊息許可權
互動卡片執行個體寫入權限
建立新版本並發布。
企業自建應用需要供企業內其他使用者使用,則必鬚髮布一個版本。
在左側導覽列中選擇版本管理與發布,單擊建立新版本,填寫相關配置資訊,並單擊儲存。
建立卡片。
建立模板。
進入卡片平台,單擊建立模板。
填入模板名稱、選擇卡片類型、卡片模板情境等資訊,並單擊建立。
卡片模板情境選擇普通卡片,關聯應用選擇建立的應用。
匯入卡片模板。
選擇
,匯入訊息通知卡片模板並儲存。發布訊息通知卡片模板。
飛書/飛書國際版(Lark)
登入飛書或Lark開放平台並進入開發人員後台。
訪問飛書開放平台或Lark開放平台。
單擊登入。
登入的帳號需要在目標企業組織下,例如組織名為“XXX測試組織”。
登入後進入開發人員後台。
單擊建立企業自建應用,配置名稱、應用描述等相關資訊,再單擊建立。更多資訊,企業自建應用開發流程。
添加飛書機器人。
(可選)單擊應用程式名稱,進入應用編輯頁面。
說明如果新建立的應用,則可忽略該步驟。
在左側導覽列中,選擇
。在按能力添加頁簽下,單擊機器人卡片上的添加。
在機器人頁面,輸入機器人名稱,單擊儲存。
添加網頁應用。
在左側導覽列中,選擇
。在按能力添加頁簽下,單擊網頁應用卡片上的添加。
在網頁應用頁面,填寫移動端首頁地址,並單擊儲存。
填寫首頁地址需要參考當前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
。
添加重新導向URL以及H5可信網域名稱。
在左側導覽列中,選擇
。在重新導向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
。分別單擊添加。
配置應用許可權。
發布應用版本。
如果企業自建應用需要給企業內其他使用者使用,則必須要發布一個版本。
在左側導覽列中選擇
。單擊建立版本。
填寫應用版本號碼、選擇移動端的預設能力等資訊,單擊儲存。
可用範圍選擇全部成員。
擷取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支援配置通知渠道。
單擊控制台左上方的
表徵圖,選擇 。
說明若您使用的是非極簡模式的控制台,請在頂部功能表列中,選擇
。單擊頁面左上方的渠道管理。
選中目標式通知渠道。
配置飛書、Lark、DingTalk或專屬DingTalk所需的資訊。
如下以配置飛書渠道資訊舉例,其他渠道配置操作與此樣本類似。
單擊飛書渠道地區的編輯。
輸入AppId、AppSecret,單擊儲存。
步驟二:設定接收訊息通知的使用者
如下以配置待審批資料匯出工單的通知為例:
管理員將待接收訊息的使用者錄入DMS。具體操作,請參見使用者管理。
管理員或DBA進入DMS通知管理功能頁面。
在通知管理功能頁面,選擇需要通知的DMS功能模組更新訊息。
在模組/業務類型篩選框中,選擇
。找到待審批業務狀態的工單,單擊右側的修改。
在附加通知使用者參數地區,選擇目標使用者,並單擊確認。
開啟訊息通知。
後續待審批的資料匯出工單通知將直接發送至目標使用者的DingTalk、專屬釘或飛書。
移動端通知效果展示
DingTalk/專屬DingTalk | 飛書 |
您可以單擊審批卡片查看詳情。
相關文檔
DMS支援在移動端快速處理工單,極大地提高了研發效率。具體操作,請參見在移動端審批工單。
常見問題
Q:在個人語音總機中配置了飛書、DingTalk、專屬釘或Lark的渠道資訊,為什麼在飛書、DingTalk或其他渠道中未收到DMS的訊息通知呢?
A:請檢查您是否已開通飛書、DingTalk、專屬釘或Lark通知渠道。開通對應渠道後,您配置的資訊才可生效,DMS將通過該渠道向您發送訊息通知。開通操作,請參見步驟一:在DMS開通並配置通知渠道。
Q:為什麼配置了通知渠道資訊和接收訊息的使用者,還是沒有接收到DingTalk或飛書訊息?
A:請根據如下步驟解決問題:
檢查管理員或DBA是否已在DMS步驟一:在DMS開通並配置通知渠道。
中開啟對應的渠道。更多資訊,請參見單擊DMS帳戶圖片,確保通知方式中對應的通知渠道為開啟狀態。
Q:未修改通知設定,突然無法接收DingTalk或飛書訊息,可能是什麼原因?
A:可能是因為企業自建應用的API調用量超出限制,導致無法接收到訊息。您可以在DingTalk或飛書的開發人員後台查看API調用量。調整API調用次數的操作,請參見DingTalk和飛書。