通过 SAP C4C 系统将消息回复到用户微信 App 上
本文前半部分,我们已经实现了这样的场景:某微信用户关注微信公众号之后,接下来发送给该公众号的每一条文本信息,都会以Social Media Message的模型,自动转存到C4C系统中:
同时,每一条C4C Social Media Message都会自动生成一条Service Ticket,下图ID为1034309的Ticket是一个例子:
本文实现的场景则更进一步。C4C座席人员在系统里回复该Service Ticket,比如下图是座席人员的回复,大意是:“亲爱的客户,我们已经收到了您的服务请求,正在处理中”。
通过本文介绍的增强步骤,C4C座席人员的回复,将会自动推送到微信用户的手机上:
下面是具体的实现步骤。
在C4C系统里创建一个类型为Rest Service的Mashup:
Mashup详细信息维护如下,最关键的字段是URL,需要指向部署到云平台的nodejs应用暴露出的一个endpoint,本文的例子是/fromc4c:
当C4C Service Ticket被座席人员回复时,对应的数据会被C4C转换成XML格式,通过HTTP POST,发送到上图Mashup URL字段维护的endpoint去:
http://wechatjerry.herokuapp.com/fromc4c
将新建好的Mashup Service分配到本文上半部分创建的自定义Channel ZJERRYWC中去:
在微信消息服务器实现的index.js里,当endpoint /fromc4c收到HTTP POST请求时,调用handleReplyFromC4C函数,将C4C座席人员的回复内容,调用微信API转发给微信用户。
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标签页里:
如果忘记了这个逻辑,可以重新阅读本系列前一篇文章:如何将微信用户发送到微信公众号的消息保存到SAP C4C系统。
因此,handleReplyFromC4C需要三个实现步骤:
(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 这两个方向的交互。