本系列的前三篇文章,咱们顺次介绍了微信公众号开发环境的搭建,微信公众平台 API 的调用,以及地图功能的集成。

本文作为该系列第四篇文章,介绍如何实现 SAP Cloud for Customer 零碎同微信公众号的双向通信性能。

所谓双向通信,行将用户发送给微信公众号的音讯,转存到 SAP Cloud for Customer 零碎(本文余下局部应用缩写 C4C 来代替),以及从 C4C 间接回复音讯到用户微信 App 这两个方向的交互。

上面咱们别离介绍。

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

用户通过微信 app 将音讯发送到 SAP C4C 零碎

微信用户点击“关注”按钮,关注了某微信公众号之后:

在SAP C4C零碎主动生成了下列数据:
(1) 一个代表该微信用户的individual customer主数据
(2) 一个绑定到customer主数据的C4C Social Media User Profile
这两条数据的ID,会通过微信音讯推送回微信用户的微信app上:

这些胜利创立的C4C数据的ID,在微信音讯服务器,即nodejs利用的管制台上也能察看到:

依据返回给微信用户的客户主数据ID,到C4C零碎找到该主数据,在其Social Profiles面板里,能看到该Social Profile的渠道类型(Channel Type)为自定义的Jerry's Wechat Channel:

一旦微信用户给微信公众号发送文本信息,该文本信息通过微信公众号的音讯服务器作为直达,调用C4C API,在C4C零碎创立一条内容为该文本信息的Social Media Message数据。
下图是一个例子:我发送一条"Hello C4C Agent ......"的文本信息,在SAP C4C零碎创立的Social Media Message ID为59610:

依据ID在C4C零碎找到这条Social Media Message:

同时,C4C零碎还会基于新建的Social Media Message,主动生成一条新的Service Ticket,这是C4C零碎的规范性能,无需额定编程实现。

上面是这个场景具体的实现步骤。
关上C4C配置的Activity List:

创立一个自定义Channel:

记下这个新建Channel的Type Code:905

基于上图的Channel 905创立一个新的Social Media Channel,ID为ZJERRYWC:

在我这个Github仓库下有个service文件夹,蕴含了三个JavaScript文件:

(1) createAccountInC4C.js:负责微信用户关注微信公众号之后, 调用C4C OData API创立individual customer.
(2) createSocialMediaProfile.js:调用API创立C4C Social Media Profile.
(3) bindSocialProfileWithIndividualCustomer.js: 负责将前两步创立的C4C数据绑定起来。

在第二步创立Social Media Profile时,调用C4C API传入的输出负载里,将ChannelCode硬编码成之前在C4C零碎里新建的自定义Channel的Type Code:905

在createAccountInC4C.js的实现里,这三步按程序实现在函数createAccount里:

在微信音讯服务器的事件处理函数里,一旦接管到“关注”事件( 事件类型值:subscribe)时,调用createAccount函数,实现上述三个步骤:

微信用户关注了公众号之后,发送文本音讯给该公众号,微信音讯服务器调用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….”: 微信用户发送给微信公众号的文本信息。

应用函数createSocialMessage,在C4C零碎创立以微信用户发送给微信公众号的文本信息作为内容的Social Media Message,创立胜利后返回其ID给微信用户:59160.

依据ID 59160到C4C零碎查问到该Social Media Message,查看其Message字段的值,同微信用户发送给微信公众号的文本信息完全一致。

通过 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....
将新建好的Mashup Service调配到本文上半局部创立的自定义Channel ZJERRYWC中去:

在微信音讯服务器实现的index.js里,当endpoint /fromc4c收到HTTP POST申请时,调用handleReplyFromC4C函数,将C4C座席人员的回复内容,调用微信API转发给微信用户。

https://github.com/wangzixi-d...

所以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 这两个方向的交互。