Skip to main content

Wechaty tutorials overview

These tutorials take you by the hand through a series of steps to create a chatbot application.

Build your first chatbot with wechaty

If you are a total beginner to Wechaty or chatbot application development in general, we recommend you to start from the Getting started tutorials. In these tutorials you'll be building a ding-dong bot which replies with a dong message when it recieves a ding message.

The fastest way to get started with Wechaty is to use a Cloud based IDE for running the bot. To understand how it works, You can either use:

If you are a total begginer then we recommend using Gitpod.

Once you get basic idea of ding-dong bot, you can try out building it from scratch by following our Running Locally tutorial.

Advanced Tutorials (Using plugins with wechaty)

If you have some experience with Wechaty or Chatbot application development, we have intermediate to advanced tutorials on the following topics as well.

You can skip to any of them.

Explore more bots (Adding more features to your bot)

If you have already run your ding-dong bot successfully, you can now explore some more bots with wechaty.

For better understanding we have classified the bots under three categories taking you from building basic to professional bots.


  • World's Shortest Chatbot: The very first wechaty example showcasing how easy it is to get started
  • Starter Bot: Most basic bot built using wechaty which can be used as a template for creating advanced bots.
  • Ding Dong bot: Practical example demonstrating how to do message handling
  • Contact bot: List all contacts by Wechat ID & Name


  • Demo in tutorial: The demo bot from tutorial
  • Busy bot: Auto response busy message for you when you are busy
  • Media file bot: Save media attachment in message to local files
  • Room bot: Practical examples illustrating how to do room handling
  • Friend bot: Practical example illustrating how to do friend handling
  • Gist bot: Best template for bigger modules, with each handler in separated files