Integrate Wechat Personal Account to Microsoft BotFramework with a BotBuilder Wechaty Connector-优快云博客

本文介绍了一种将个人微信账号连接到Microsoft Bot Framework的方法，通过创建botbuilder-wechaty-connector实现。此连接器简化了开发过程，使得开发者能够轻松地为个人微信账号构建聊天机器人。

BotFramework

Microsoft BotFramework is a robust platform that supports almost all kinds of the instance messengers like Facebook messenger, Skype, Slack, and backed by the powerful Cognitive Services like LUIS.ai, QnAMaker.ai, Azure Machine Learning. BotBuilder is a powerful SDK provides all we need when we are developing a ChatBot. I started learning them about 18 months ago, and I love them very much.

However, it does not support Wechat Individual Account, so I decided to make some fun on it: connect Wechat PERSONAL Account to the BotBuilder by creating a new Connector: botbuilder-wechaty-connector.

Update

Jan 14, 2019: The botbuilder-wechaty-adapter realeased for Bot Builder V4 support.
Apr 18, 2018: The botbuilder-wechaty-connecter realeased for Bot Builder V3 support.)

The Connector is a bridge between the BotBuilder and the Instance Messenger, in our case, Wechat.

There’s some document at Bot Builder for Node.js Libraries - Interface IConnector with two examples: ChatConnector and ConsoleConnector. However, I found the most useful example is a Wechat Official Account Connector: https://github.com/jyfcrw/botbuilder-wechat-connector whose code is concise and clean, so I decided to start from here.

It’s not very difficult for me to replace the two NPM module wechat & wechat-api to wechaty, and rewrite all the code to TypeScript, then add linting & testing, setup DevOps CI/CD to publish on NPM. It takes me about three hours to finish them.

Contract to the Wechat Official Account, Personal Account will be very easy to start because you only need to scan the QR code on the phone to log in instead of register an official account with APP_ID & APP_SECRET.

The following code simple setup a connector between BotBuilder and Wechat, ask and answer elementary questions:

What’s your name?
OK, ${your name}
What’s your age?
All right, ${your age}
How are you, ${your name}

   import * as builder from 'botbuilder'

import { WechatyConnector } from 'botbuilder-wechaty-connector'

// Create wechat personal account connector
const wechatyConnector = new WechatyConnector()

const bot = new builder.UniversalBot(wechatyConnector)

// Bot dialogs
bot.dialog('/', [
  function (session) {
      if (session.userData && session.userData.name) {
        session.send('How are you, ' + session.userData.name)
      } else {
        builder.Prompts.text(session, 'Whats your name?')
      }
  },
  function (session, results) {
      session.userData.name = results.response
      session.send('OK, ' + session.userData.name)
      builder.Prompts.text(session, 'Whats your age?')
  },
  function (session, results) {
      session.userData.age = results.response
      session.send('All right, ' + results.response)
  },
])

wechatyConnector.listen()

  