For different instant messaging (IM) systems (such as WeChat, Whatsapp, and TikTok), the Wechaty community builds separate RPA modules for each, and we call those modules Wechaty Puppet.
Wechaty Puppet Service is gRPC for Wechaty Puppet. To use a Wechaty Puppet Service, you need a TOKEN for that service, and pass it to Wechaty, then you will be able to use that Puppet Service.
export WECHATY_PUPPET=wechaty-puppet-serviceexport WECHATY_PUPPET_SERVICE_TOKEN="__TOKEN__"
You can switch between different Wechaty Puppet Services by changing your TOKEN. All your source code should work between different tokens without any changes.
If you want to learn more about the concepts behind TOKEN, please read our blog post: Introducing Wechaty Puppet Service
You can get a short-term free TOKEN for testing, get a long-term free TOKEN by joining our Wechaty Contributor Program, or buy a TOKEN from our Wechaty Puppet Service Providers.
If you have any questions about the Wechaty Puppet Service, please feel free to talk to us by joining our Gitter network if you aren’t already a member.
Short-term TOKEN（7 days） is for those developers who want to test Wechaty Puppet Service to make sure the service can meet their needs.
TODO: list a easy to follow steps how to apply free token
- Paimon: Register here
- wxwork/donut: Using WeCom Account(Not WeChat) with administrator rights here
- Padlocal: 👉🏻 Get Free PadLocal Token 👈🏻
Long-term TOKEN is for those developers who has joined our Wechaty Contributor Program.
Anyone who has a merged PR to our GitHub repos will be welcome to join.
TODO: give a short intro for steps to join the WCP.
Paid TOKEN is the easiest one to getting started with the Wechaty Puppet Service.
Select a Wechaty Puppet Service from the list below and follow the steps in its page, then contact the Puppet Service Provider to buy one.
If you want to buy more than 10 at a time, or you need consulting servcies, please contact us in Gitter room at https://gitter.im/wechaty/wechaty.
Now, we have the following Wechaty Puppet Services:
If you are interested in using a Wechaty Puppet Provider directly in your program instead of a Puppet Service, please visit our Wechaty Puppet Directory
We have a great blog post to explain those term in detail. Please read: Introducing Wechaty Puppet Service
TOKEN is a unique string for authorizing Wechaty Puppet Service.
Here's some TOKEN examples:
puppet_wxwork_7ce4cf8a1ab789166c39c6: WXWork TOKEN
puppet_padlocal_7ce48a1ab789166c39c6: PadLocal TOKEN
puppet_paimon_7ce4cf8a1ab789166c39c6: Paimon TOKEN
puppet_donut_e7ce4cf8a1ab789166c39c6: Donut TOKEN
56945fa4-7ce8-4cf8-a1a9-b789166c39c6: UUIDv4 TOKEN
When you are using a Wechaty Puppet Service, you need to provide TOKEN to it so that it can serve you correctly.
The following shell commands demonstrated how to use it under Linux/macOS:
export WECHATY_PUPPET_SERVICE_TOKEN=__TOKEN__ ts-node bot.ts// or: node bot.js// or: make bot
__TOKEN__is your TOKEN
To be written.
Please feel free to list yourself to our list at Wechaty Puppet Provider Repo, and add your introduction in this README by submitting a Pull Request!
If you want to become a Wechaty Puppet Service Provider, please do not hesitate to file an issue to introduce yourself in this repository, then contact firstname.lastname@example.org!
Learn more about the Wechaty Puppet Service Providers from:
- The relationship between Wechaty OSS Project and the Commercial Puppet Service Provider (CPSP) #11
- Wechaty Puppet Service Registration & Discovery (w.r.t. token) #39
- Wechaty OSS Project and the Commercial Puppet Service Provider (CPSP)
- Wechaty Starter Project Template that works out-of-the-box
- How to create your own Wechaty Puppet Service Token with the Web Protocol