Wechaty is a Conversational RPA(Robotic Process Automation) SDK(Software Development Kit) for Chatbot Makers. It's well designed with an easy to use API. It supports all operating systems including Linux, OSX, Win32, Docker, and lots of IMs(Instant Messaging services) including WeChat, WeCom, Whatsapp, Lark, Gitter, etc.
As a developer, you can use Wechaty to easily build your bot, effectively manage message sending and receiving, room creation and sending out invitations, contact friends, and delightfully add artificial intelligence between users and your bot.
If you are a total beginner to Wechaty, this project is the best starting point for you. You can run it on a Cloud IDE in a couple of steps or on a local setup on your machine as described in the sections below.
If you encounter difficulties or have any questions, you are welcome to ask for help in our Gitter room at https://gitter.im/wechaty/wechaty.
- It works out of the box on Linux, Mac or Windows.
- Supports all puppets like Web, Pad, Windows, and Mac.
- It replies with a
dong
message when it receives ading
message.
The fastest way to getting started with Wechaty is to use a Cloud based IDE for running the Wechaty Getting Started Project. You can either use Gitpod or Google Cloud Shell.
If you are a total beginner, then we recommed Gitpod.
Using Gitpod ❤️ Wechaty
Gitpod is an online and open source platform for automated and ready-to-code development environments. You can click the button below to access a complete setup of Wechaty Getting Started ding-dong BOT project on gitpod. If you have never used gitpod before, you will be required to login using your gitHub account.
You can learn more about Gitpod ❤️ Wechaty from our blog: Getting Started Without Leaving Your Browser: Wechaty ❤️ Gitpod, @huan, Feb 06, 2021
Google Cloud Shell is an online development and operations environment accessible anywhere with your browser. You can run this project on Google Cloud Shell by clicking the button below.
Generated via open-in-cloud-shell
After opening the Google Cloud Shell editor, there should be an open tutorial in the right panel which you can follow to learn more about Wechaty.
Learn more about running this project on Google Cloud Shell from our blog: Google Cloud Shell Tutorials for Wechaty, @huan, Feb 20, 2021
For you to run this project on your local machine, you need to:
-
Have Node.js v12+ installed on your machine. You can run the command
node -v
on the terminal to check whether you haveNode.js
installed. If you have it, you should be able to see the version printed on the terminal likev15.13.0
. Your version might be different fromv15.13.0
. If it is not installed or your version is below 12,You need to install the latest version by following the links below:Node.js for other platforms can be found at https://nodejs.org/en/download/package-manager/
-
Have Wechaty Puppet Service TOKEN if you want to use RPA protocols other than Web
You need to clone this repository to your local machine and then switch to wechaty-getting-started
directory by running the commands below.
git clone https://github.com/wechaty/wechaty-getting-started.git
cd wechaty-bot
You need to install dependencies by running the command below.
npm install
You can use export
to set environment variables in Linux, and use set
in Windows. If you run into errors while running this command, check the troubleshooting tips in step 4.
export WECHATY_LOG=verbose
export WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts
set WECHATY_LOG=verbose
set WECHATY_PUPPET=wechaty-puppet-wechat
npm start
# the above is equals to the below command:
# npx ts-node examples/ding-dong-bot.ts
You are all set!
If you run into problems while following the above steps, try the options below. You are also welcome to ask questions in our gitter chatroom.
-
You might need to use
taobao
registry mirror for NPM:npm --registry=https://registry.npm.taobao.org install
-
You might also need windows-build-tool if you are using windows:
npm install windows-build-tools
In our getting started example, the ding-dong BOT uses wechaty-puppet-wechat4u when WECHATY_PUPPET
is not set, which is just for newcomer's convenience.
By default, Wechaty will use the Puppet Service for logging in your bot. You can use other Puppet Provider like Whatsapp Web protocol( wechaty-puppet-whatsapp).
If you want to use a Wechaty Puppet Provider for a different protocol, then you need to specify a puppet service provider name (the same as its NPM name) by setting the WECHATY_PUPPET
environment variable.
Thanks to the great contributions from our community, there are many Wechaty Puppets which can be used by Wechaty. They have helped us use protocols like Web, Pad, Mac, and Windows.
Protocol | NPM |
---|---|
Puppet Service | wechaty-puppet-service |
Whatsapp Web | wechaty-puppet-whatsapp |
WeChat Web | wechaty-puppet-wechat |
WeChat Pad | wechaty-puppet-padlocal |
Visit our website to learn more about Wechaty Puppet Service Providers
For example, if you want to use the padlocal
puppet, you should set WECHATY_PUPPET=wechaty-puppet-padlocal
before you run npm start
. You also need a TOKEN for wechaty-puppet-padlocal
which you need to set to the WECHATY_PUPPET_PADLOCAL_TOKEN
environment variable. You can apply for the PadLocal TOKEN from here. The code snippets below illustrate what has been described above on Linux/ MacOS and on Windows.
export WECHATY_PUPPET=wechaty-puppet-padlocal
export WECHATY_PUPPET_PADLOCAL_TOKEN='puppet_padlocal_your-token-here'
npm start
set WECHATY_PUPPET=wechaty-puppet-padlocal
set WECHATY_PUPPET_PADLOCAL_TOKEN='puppet_padlocal_your-token-here'
npm start
Learn more about installing Wechaty on windows from this blog post.
Above is a 10 minute video tutorial. It is using version 0.14 or older versions of Wechaty therefore it is also outdated. It is a good way to start if you are new to Wechaty.
Note: Before you attempt more examples, make sure you have tried out the wechaty getting started project in this repository.
- GitBook: https://wechaty.js.org/api
https://github.com/Chatie/docker-wechaty-getting-started
https://github.com/Chatie/heroku-wechaty-getting-started
WeChat account registered after 2017 will not be able to login via Web API. Learn more about it at wechaty/wechaty#872
Solution: You can use Wechaty support protocols other than Web API, such as pad. Learn more at wechaty/wechaty#1296
The term Puppet in Wechaty is an Abstract Class for implementing protocol plugins. The plugins are the components that help Wechaty to control Wechat and that's the reason why we call it puppet.
The plugins are named PuppetXXX
, for example PuppetWeChat is using the google puppeteer to control the WeChat Web API via a chrome browser, PuppetPadchat uses the WebSocket protocol to connect with a Protocol Server for controlling the iPad Wechat program. For more details you can go to Puppet in wiki.
Learn more about Wechaty Puppet from our documentation at Wechaty Puppet
- TypeScript Wechaty Getting Started
- Python Wechaty Getting Started
- Go Wechaty Getting Started
- Java Wechaty Getting Started
- Scala Wechaty Getting Started
- PHP Wechaty Getting Started
- .NET(C#) Wechaty Getting Started
Using Google Cloud Shell for a quick setup!
Using Gitpod for a quick setup!
Init version
- Code & Docs © 2018-now Huan and Wechaty Contributors
- Code released under the Apache-2.0 License
- Docs released under Creative Commons