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.
In previous blogs we have already setup the environment for Wechat development and build some toy services to get familar with overall process.
In this blog, we will implement some feature which interacts with C4C system.
The implementation contains purely nodejs development via Javascript and do not need any development in C4C side.
Implemented feature
Here below is my testing subscription account. When I scan it via my Wechat app,
I can click the Green button “关注” ( subscribe ) to finish subscription to this account.
You must maintain a valid user name and password which could have access to create new individual customer in your C4C system.
The access token will be used when you try to send a message to an user who has subscribed your Wechat account via Wechat Restful API. It will expire by default 2 hours after generation. The token could be refreshed based on appid and secret. For simplification purpose I just generate the token and store it in configuration file.
(2) Once a Wechat user presses “subscribe” button, an event with HTTP post will be sent to the Wechat server which is bound to your subscription account. As a result we have to react to this post request, parse the Wechat ID which has clicked the “subscribe” button, and create a new individual customer in C4C system based on this Wechat ID.
Here below is the source code how we react to the event with event key “subscribe”.
(1) the welcome message “Welcome to Jerry’s subscription account” is hard coded;
(2) The Wechat ID of user who has finished subscription is stored in variable fromUserName
var config = require("../../config.js"); var request = require('request'); var postWCMessage = require("./postMessageToUser.js"); var getTokenOptions = { url: config.individualCustomerurl, method: "GET", json:true, headers: { "content-type": "application/json", 'Authorization': 'Basic ' + new Buffer(config.credential).toString('base64'), "x-csrf-token" :"fetch" } }; function getToken() { return new Promise(function(resolve,reject){ var requestC = request.defaults({jar: true}); requestC(getTokenOptions,function(error,response,body){ var csrfToken = response.headers['x-csrf-token']; if(!csrfToken){ reject({message:"token fetch error"}); return; } resolve(csrfToken); }); // end of requestC }); } function _createIndividualCustomer(token, fromUserName){ return new Promise(function(resolve, reject){ var oPostData = { "FirstName":"Wechat", "LastName":fromUserName, "RoleCode": "ZCRM01", "CountryCode": "US", "StatusCode": "2" }; var requestC = request.defaults({jar: true}); var createOptions = { url: config.individualCustomerurl, method: "POST", json:true, headers: { "content-type": "application/json", 'x-csrf-token': token }, body:oPostData }; requestC(createOptions,function(error,response,data){ if(error){ reject(error.message); }else { resolve(data); } });// end of requestC }); } module.exports = function createAccount(fromUserName){ getToken().then(function(token) { console.log("token received: " + token); _createIndividualCustomer(token, fromUserName).then(function(data){ var message = "account created: " + data.d.results.CustomerID; console.log(message); postWCMessage(fromUserName, message); }); }); };
var config = require("../../config.js"); var request = require("request"); function printObject(oData){ for( var a in oData){ console.log("key: " + a); console.log("value: " + oData[a]); if( typeof oData[a] === "object"){ printObject(oData[a]); } } } function sendWCMeaasge(toUser,sMessage){ console.log("begin to send message to user: " + toUser + " with message: " + sMessage); var options = { url:"https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=" + config.accessToken, method: "POST", json:true, headers: { "content-type": "application/json"}, body:{ "touser":toUser, "msgtype":"text", "text": { "content":sMessage } } }; request(options,function(error,response,data){ console.log("Status message: " + response.statusMessage); console.log("Data: " + data.errmsg); }); } module.exports = sendWCMeaasge;
It is very convenient to use this Restful API to send message to a given Wechat user who has subscribed the testing account. You could test it in postman: