Article / 文章中心

微信开发系列之一 - 微信公众号开发的开发环境搭建

发布时间:2021-11-29 点击数:352

文章系列目录

Wechat development series 1 – setup your development environment

Wechat development series 2 – development Q&A service using nodejs

Wechat development series 3 – Trigger C4C Account creation in Wechat app

Wechat development series 4 – Send C4C Data change notification to Wechat app

Wechat development series 5 – embedded your UI5 application to Wechat app

Wechat development series 6 – Retrieve Wechat User info via oAuth2 and display it in UI5 application

Wechat development series 7 – use Redis to store Wechat conversation history

Wechat development series 8 – Map integration

Wechat development series 9 – Create C4C Social Media Message and Service within Wechat app

Wechat development series 10 – Use Wechat app to receive Service Request reply made from C4C

Tencent’s WeChat, a social networking app with more than 760 million monthly active users, is becoming a dominant mobile channel connecting businesses and customers. This series will illustrate how to do some development on Wechat so it could interact with SAP product like SAP Cloud for Customer.


Prerequisite

(1) You should have already registered an subscription account in Wechat Official Account platform: https://mp.weixin.qq.com

(2) You should have basic knoledge about nodejs development.

Detail steps for environment setup

Log on to Official Account platform https://mp.weixin.qq.com, menu Development->Basic configuration,


image.png


The most important setting here is the server url, where the custom logic of your Wechat official subscription account is hosted.


image.png


In this series, I will use nodejs plus Heroku to host the server. This server is responsible to serve the request which is delegated by Wechat platform issued originally by your Wechat official subscription account’s followers. Before Wechat platform will really delegate user request to this server, you must first pass the verification defined by Wechat’s development guide: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1472017492_58YV5

Unfortunately the verification flow chart in the guide is drawn with Chinese text:

image.png


And the provided sample code is written by Python, so here I will provide a nodejs solution instead.


As long as you press “Submit” button, Wechat platform will send a http request to the server specified via this URL:


image.png


The http request looks like below:


https:///?signature=096abd439b41f9610aeabe2d7534084fd8dafa20&echostr=16168327802220428137&timestamp=1512810825&nonce=384289189


The responsibility of your server is then to calculate a result based on your subscription account token, the timestamp and the nonce field, and compare it with the echostr passed with the request url. If the comparison result is not equal, you will see error message “Token authentication failed”.


image.png


Only after your server has passed the verification then it is ready for subsequent development.


Below is the step how to develop your server to pass the verification.


(1) Create a new nodejs project with the following package.json. The highlighted part is relevant for server verification.


image.png


(2) Implement server.js with following source code:

image.png

(3) deploy this nodejs application to Heroku. For detail steps, please refer to my blog Step by step to host your UI5 application in Heroku.


Once done, perform the verification in Wechat Official Account platform.


Then in Heroku application console we can see that the signature passed from Wechat platform is equal to the value calculated in our nodejs server, as a result the verification is finished successfully:


image.png


You can see now the Server configuration in Wechat platform is marked as enabled, which is ready for subsequent development.


image.png