jlucaso1/user-bot

a simple open source automation tool that helps you simplify and manage your WhatsApp interactions easily.

xstro golang

an open source tool that works with whatsapp. it is made with golang and uses the whatsmeow client to connect to whatsapp and do things like send messages, reply to chats, and run tasks for you.

what you need to understand

• this tool is not made to spam people.
• this tool is for educational purposes only.
• this tool must be used according to WhatsApp's Terms of Service.
• this tool is in no way affiliated nor endorse by WhatsApp, and by using it, you agree that you accept the responsibilities and consequences that comes with using this software.
• this tool stores all your authentication in a local sqlite db file, you can verify by checking client.go file.
• if you use this tool to perform illegal things such as spam, or stalking, i will not take responsibility for such

how to use

• it's built in go lang, if you don't know what go/go-lang programming is, read it's docs.
• there are some cli packages that are needed for important utility functions, such as creation of stickers, and various media commands that processes image and video files.
• ensure that ffmpeg, cwebp and webpmux libraries are installed on your system to get the full experience
• node 16 or newer is required to help with sticker metadata conversion and related node scripts
• if you are not running in a docker container, i'll assume you are running this software for development purposes on your local machine. you will need to install ffmpeg, cwebp, webpmux, and nodejs if you plan to use the sticker metadata features.

• windows

  1. download and install ffmpeg from https://ffmpeg.org/download.html
  2. download and install libwebp from https://developers.google.com/speed/webp/download
  3. add both ffmpeg and libwebp bin folders to your system path

• macos

  1. install homebrew if you don't have it (https://brew.sh)
  2. run brew install ffmpeg webp

• linux (debian/ubuntu)

  1. run sudo apt update
  2. run sudo apt install ffmpeg webp nodejs npm

• linux (arch)

  1. run sudo pacman -S ffmpeg libwebp nodejs npm

• once these packages are installed, you can confirm they exist by running in your terminal: ffmpeg -version, cwebp -version, webpmux -version, node -v
• once all of these packages are confirmed to exist, you can start the process by running go run . or build it before running if you prefer.
• ensure that you have your .env file ready, and inside the file, put this data. USER_PN is your phone number, it's required.

• env

  USER_PN=12345678912

features

• send messages such as text, image, video and audio
• receive all kinds of messages excluding view_once_message, because of missing node in message content.
• send gif and animated sticker
• manage group chats (still in progress)
• save broadcast messages (whatsapp status) (still in progress)

contributing

anyone can help make this project better. you can fix bugs, add new features, improve the code, or even just update the docs. before you start, please read the contributing guidelines to understand how i work on this project.

some ways you can contribute:

• report bugs or suggest features by opening an issue.
• send a pull request with code changes.
• help test new updates and give feedback.
• improve readme files or other documentation.