調(diào)用REST端口實現(xiàn)釘釘通知

釘釘已經(jīng)成為很多企業(yè)日常工作必備的交流軟件，知行軟件也在釘釘通知上做出了一些努力，利用知行之橋的REST端口調(diào)用釘釘機器人API從而實現(xiàn)釘釘通知的功能，這樣當客戶在EDI系統(tǒng)上收到數(shù)據(jù)后，釘釘群組同時會發(fā)送通知消息，客戶可以及時處理信息，提高效率。

一，創(chuàng)建釘釘機器人

釘釘?shù)娜航M有一個自定義機器人的功能，可以利用這個功能來創(chuàng)建消息通知的釘釘機器人，實現(xiàn)釘釘通知。

1、打開群組設置，點擊添加機器人。

2、選擇自定義機器人

3、設置機器人姓名

這里可以進行自定義比如：【消息通知】。選擇對應需要接收通知消息的群組，添加安全設置。如下圖所示，這里是三選一，一般選擇自定義關(guān)鍵字即可，注意這個關(guān)鍵字需要在REST端口傳輸?shù)膉son文件中使用到。例如添加了一個自定義關(guān)鍵詞：“收到”，則這個機器人所發(fā)送的消息，必須包含“收到”這個詞，才能發(fā)送成功。

4、設置完成后機器人就會開始工作

需要注意的是，機器人的設置界面會有一個帶有access_token的url，復制保存，在調(diào)用時需要用到這個帶有access_token的url。

二 調(diào)用API

在知行之橋的REST端口設置帶有access_token的url，方法為：POST 頭部為Content_Type:application/json 另外需要注意的是：發(fā)起POST請求時，必須將字符集編碼設置成UTF-8。

配置好這些，下一步就是在實際業(yè)務轉(zhuǎn)換結(jié)束時生成一份json文件，這份json文件需要包括以下參數(shù)。

要實現(xiàn)釘釘通知，需要傳輸?shù)膉son文件的格式如下所示。

三 實現(xiàn)消息傳輸

1、釘釘通知-訂單通知

如圖所示，可以在知行之橋中搭建工作流，我們要完成的功能是：為一個Excel方案添加接收方向的釘釘通知demo。 在正常接收到X12報文，并將X12報文轉(zhuǎn)換為XML后通過上圖所示的Demo_Copy端口復制一份轉(zhuǎn)換后的xml文件，得到兩份相同的xml文件。一份按照正常的流程繼續(xù)經(jīng)Excel端口后再通過郵箱端口發(fā)送到客戶郵箱，另一份來進行釘釘通知。

但是在進行釘釘通知之前，需要先經(jīng)過一個Schedule端口進行幾分鐘的延時，以確保真實的數(shù)據(jù)完全進入到客戶的郵箱后，再進行釘釘通知。完成Schedule端口延時之后經(jīng)過Script端口，提取報文名稱和主鍵信息，轉(zhuǎn)為釘釘機器人可以讀取的json文件，然后經(jīng)過REST端口發(fā)送到釘釘群組，即可實現(xiàn)釘釘通知的功能。以下是幾種釘釘通知的界面展示。

艾特到具體人的釘釘通知

艾特所有人的釘釘通知

不做任何艾特的文本消息通知

2、報錯預警-AS2端口自動巡檢

EDI對外的連接端口有時也會因為各種各樣的情況出現(xiàn)問題，比如修改http為https后，出現(xiàn)設置的SSL證書問題，這樣就會導致EDI環(huán)境掛掉，因此可以利用釘釘通知功能來進行自動巡檢，當環(huán)境出現(xiàn)問題后，用戶就可以及時知道并進行處理。 如上圖所示，我們在知行之橋EDI系統(tǒng)上創(chuàng)建一個Script端口和AS2端口，利用Script端口來實現(xiàn)當AS2端口的出現(xiàn)問題時，及時進行釘釘通知，方便運維人員及時進行檢查并糾正。 Script端口具體代碼如下：

其中，postdata里的內(nèi)容就是調(diào)用釘釘機器人的json文件內(nèi)容。 報警示例：

這樣，通過REST端口調(diào)用釘釘通知的功能就可以實現(xiàn)，用戶通過知行之橋EDI系統(tǒng)進行數(shù)據(jù)收發(fā)時，可以及時在釘釘群組中收到通知消息，確保信息能夠得到及時處理，提高響應效率。

審核編輯：符乾江