本系列的前三篇文章，我們依次介紹了微信公眾號開發環境的搭建，微信公眾平臺 API 的呼叫，以及地圖功能的整合。

本文作為該系列第四篇文章，介紹如何實現 SAP Cloud for Customer 系統同微信公眾號的雙向通訊功能。

所謂雙向通訊，即將使用者傳送給微信公眾號的訊息，轉存到 SAP Cloud for Customer 系統(本文餘下部分使用縮寫 C4C 來代替)，以及從 C4C 直接回復訊息到使用者微信 App 這兩個方向的互動。

下面我們分別介紹。

https://www.jianshu.com/p/91ba1ec3e8f7

# 使用者透過微信 app 將訊息傳送到 SAP C4C 系統

微信使用者點選“關注”按鈕，關注了某微信公眾號之後：

![](https://img-blog.csdnimg.cn/img_convert/e5aba6b89693d4d00f509acb4ceb5123.png)

在SAP C4C系統自動生成了下列資料：
(1) 一個代表該微信使用者的individual customer主資料
(2) 一個繫結到customer主資料的C4C Social Media User Profile
這兩條資料的ID，會透過微信訊息推送回微信使用者的微信app上：

![](https://img-blog.csdnimg.cn/img_convert/46ac4c8e374307aeaa1241eda9a9a68d.png)

這些成功建立的C4C資料的ID，在微信訊息伺服器，即nodejs應用的控制檯上也能觀察到：

![](https://img-blog.csdnimg.cn/img_convert/4ee65ca72bab335d767da6f401dc40fc.png)

根據返回給微信使用者的客戶主資料ID，到C4C系統找到該主資料，在其Social Profiles皮膚裡，能看到該Social Profile的渠道型別(Channel Type)為自定義的Jerry's Wechat Channel:

![](https://img-blog.csdnimg.cn/img_convert/77bad6feeb1affc0d56b92a8407de62c.png)

一旦微信使用者給微信公眾號傳送文字資訊，該文字資訊透過微信公眾號的訊息伺服器作為中轉，呼叫C4C API，在C4C系統建立一條內容為該文字資訊的Social Media Message資料。
下圖是一個例子：我傳送一條"Hello C4C Agent ......"的文字資訊，在SAP C4C系統建立的Social Media Message ID為59610：

![](https://img-blog.csdnimg.cn/img_convert/5ce4b2f4de4e2affeee4a60eebc930ee.png)

根據ID在C4C系統找到這條Social Media Message：

![](https://img-blog.csdnimg.cn/img_convert/7af5d8977146ebb3565baa7e377a6fe5.png)

同時，C4C系統還會基於新建的Social Media Message，自動生成一條新的Service Ticket，這是C4C系統的標準功能，無需額外程式設計實現。

![](https://img-blog.csdnimg.cn/img_convert/51873545f0ddd4da05e00088eba4a966.png)

下面是這個場景具體的實現步驟。
開啟C4C配置的Activity List：

![](https://img-blog.csdnimg.cn/img_convert/98dce2d4ca41c667402a621b3e900936.png)

建立一個自定義Channel：

![](https://img-blog.csdnimg.cn/img_convert/f9caa63b40c4d57979418e409cbc546a.png)

記下這個新建Channel的Type Code：905

![](https://img-blog.csdnimg.cn/img_convert/7aac66cad20a0799293d7cfe8c15fbec.png)

基於上圖的Channel 905建立一個新的Social Media Channel，ID為ZJERRYWC:

![](https://img-blog.csdnimg.cn/img_convert/36e770f4dd0d052c43791481eeb85cfb.png)

在我這個Github倉庫下有個service資料夾，包含了三個JavaScript檔案：

(1) createAccountInC4C.js：負責微信使用者關注微信公眾號之後, 呼叫C4C OData API建立individual customer.
(2) createSocialMediaProfile.js：呼叫API建立C4C Social Media Profile.
(3) bindSocialProfileWithIndividualCustomer.js: 負責將前兩步建立的C4C資料繫結起來。

![](https://img-blog.csdnimg.cn/img_convert/0769a7bcd478e2cc36e452f452c446f2.png)

在第二步建立Social Media Profile時，呼叫C4C API傳入的輸入負載裡，將ChannelCode硬編碼成之前在C4C系統裡新建的自定義Channel的Type Code：905

![](https://img-blog.csdnimg.cn/img_convert/b4bfcf9c4e59a4795c04ba0257d217e5.png)

在createAccountInC4C.js的實現裡，這三步按順序實現在函式createAccount裡：

![](https://img-blog.csdnimg.cn/img_convert/2acba116430ae8c8b6f2881bb235fea5.png)

在微信訊息伺服器的事件處理函式里，一旦接收到“關注”事件( 事件型別值：subscribe)時，呼叫createAccount函式，完成上述三個步驟：

![](https://img-blog.csdnimg.cn/img_convert/205345b90ace766b53e4fc737037f671.png)

微信使用者關注了公眾號之後，傳送文字訊息給該公眾號，微信訊息伺服器呼叫createSocialMediaActivity.js裡的函式createSocialMessage, 在C4C系統裡建立一條新的Social Media Message.

在unittest資料夾下有一個單元測試用例，展示了該函式的用法。

五個輸入引數：

(1) o0KlM1i2_4-zHRm-IWGRlA1Cjc：傳送訊息給微信公眾號的微信使用者ID
(2) 1003: 待建立的Social Media Message ID，傳一個非空值即可，因為C4C系統會根據自己的Number Range生成該ID，並返回給API呼叫者。
(3) 6066: 當前微信使用者在C4C系統裡對應的Social Media User Profile ID，該ID是在微信使用者關注公眾號時，在C4C系統生成並返回的。
(4) ZJERRYWC: 之前已經介紹過，在C4C系統手動建立的自定義Channel ID.
(5) “Hello C4C Agent….”: 微信使用者傳送給微信公眾號的文字資訊。

![](https://img-blog.csdnimg.cn/img_convert/2ffe2d3d79d96f0b47581b83b2907501.png)

使用函式createSocialMessage，在C4C系統建立以微信使用者傳送給微信公眾號的文字資訊作為內容的Social Media Message，建立成功後返回其ID給微信使用者：59160.

![](https://img-blog.csdnimg.cn/img_convert/506fda71f32869a801f61c16699c48f5.png)

根據ID 59160到C4C系統查詢到該Social Media Message，檢查其Message欄位的值，同微信使用者傳送給微信公眾號的文字資訊完全一致。

![](https://img-blog.csdnimg.cn/img_convert/c8db3ca05d9b5b588178c11ceb90fee9.png)

# 透過 SAP C4C 系統將訊息回覆到使用者微信 App 上

本文前半部分，我們已經實現了這樣的場景：某微信使用者關注微信公眾號之後，接下來傳送給該公眾號的每一條文字資訊，都會以Social Media Message的模型，自動轉存到C4C系統中：

![](https://img-blog.csdnimg.cn/img_convert/33b112996281da167dc5dab3fdc9a788.png)

同時，每一條C4C Social Media Message都會自動生成一條Service Ticket，下圖ID為1034309的Ticket是一個例子：

![](https://img-blog.csdnimg.cn/img_convert/5f06a2eaabecabc9fa2ff39f347b1fb8.png)

本文實現的場景則更進一步。C4C座席人員在系統裡回覆該Service Ticket，比如下圖是座席人員的回覆，大意是：“親愛的客戶，我們已經收到了您的服務請求，正在處理中”。

![](https://img-blog.csdnimg.cn/img_convert/97a1f102f6dff16cacb78d45671350b9.png)
![](https://img-blog.csdnimg.cn/img_convert/b6f037a59a49f08778b681840e2b0651.png)

透過本文介紹的增強步驟，C4C座席人員的回覆，將會自動推送到微信使用者的手機上：

![](https://img-blog.csdnimg.cn/img_convert/1cc5c22976e5122300fae84de1c26fc2.png)

下面是具體的實現步驟。
在C4C系統裡建立一個型別為Rest Service的Mashup：

![](https://img-blog.csdnimg.cn/img_convert/c7403def9572a021b9ce952b19b9024c.png)

Mashup詳細資訊維護如下，最關鍵的欄位是URL，需要指向部署到雲平臺的nodejs應用暴露出的一個endpoint，本文的例子是/fromc4c:

![](https://img-blog.csdnimg.cn/img_convert/0933f69267e23afaa4b8ed22711e5821.png)

當C4C Service Ticket被座席人員回覆時，對應的資料會被C4C轉換成XML格式，透過HTTP POST，傳送到上圖Mashup URL欄位維護的endpoint去：

http://wechatjerry.herokuapp.com/fromc4c
將新建好的Mashup Service分配到本文上半部分建立的自定義Channel ZJERRYWC中去：

![](https://img-blog.csdnimg.cn/img_convert/43bd518a30cd22a71ab16692e6017b86.png)

在微信訊息伺服器實現的index.js裡，當endpoint /fromc4c收到HTTP POST請求時，呼叫handleReplyFromC4C函式，將C4C座席人員的回覆內容，呼叫微信API轉發給微信使用者。

![](https://img-blog.csdnimg.cn/img_convert/08bc4b10a95c427e01ff55ff327f69d2.png)

https://github.com/wangzixi-diablo/wechat-sap-integration/blob/main/jerryapp/routes/index.js

所以C4C座席人員回覆Service Ticket之後，資料流向為：

C4C Mashup->微信公眾號訊息伺服器->微信app
handleReplyFromC4C.js的完整實現程式碼如下。

微信訊息伺服器接收到透過C4C Mashup推送過來的HTTP POST資料，如何知道該轉發給哪一個微信使用者呢？答案是透過微信使用者的Wechat ID，該ID早在該微信使用者第一次關注微信公眾號的時候，就自動維護在C4C系統裡，自動建立的客戶主資料對應的Social Profiles標籤頁裡：

![](https://img-blog.csdnimg.cn/img_convert/b923e046751777db44948f2654e12783.png)

如果忘記了這個邏輯，可以重新閱讀本系列前一篇文章：如何將微信使用者傳送到微信公眾號的訊息儲存到SAP C4C系統。
因此，handleReplyFromC4C需要三個實現步驟：

![](https://img-blog.csdnimg.cn/img_convert/dd53c793a9ac7a5c9a5dd2a6a98cbdfa.png)

(1) C4C Mashup推送給微信訊息伺服器的資料中包含了Social Media Message ID，需要根據該ID，呼叫API得到message明細，從中取出Social Media User Profile ID.

(2) 根據Social Media User Profile ID，呼叫API拿到Profile明細，從明細中取出微信使用者Wechat ID.

(3) 呼叫微信API，將Service Ticket回覆的內容，傳送給Wechat ID對應的微信使用者。這樣，微信使用者就能在其手機上，看到C4C座席人員在系統裡回覆Service Ticket的文字內容了。

# 總結

本系列的前三篇文章，我們依次介紹了微信公眾號開發環境的搭建，微信公眾平臺 API 的呼叫，以及地圖功能的整合。本文作為該系列第四篇文章，詳細介紹如何實現 SAP Cloud for Customer 系統同微信公眾號的雙向通訊功能。

所謂雙向通訊，即將使用者傳送給微信公眾號的訊息，轉存到 SAP Cloud for Customer 系統(本文餘下部分使用縮寫 C4C 來代替)，以及從 C4C 直接回復訊息到使用者微信 App 這兩個方向的互動。

如何打通 SAP Cloud for Customer 系統和微信公眾號的雙向訊息通訊功能

相關文章