A small python seed to create a Whatsapp Bot, with regex-callback routes (just like a web framework).
(practical extension of the examples on https://github.com/tgalal/yowsup)
Unfortunately, after some updates in the whatsapp servers, bots are beeing banned real quickly. Some just last a couple hours.
Whatsapp does not have an open protocol, so yowsup -- the core implementation behind this seed -- relies on reverse engineering to understand the messages exchange. Right now there is a lot of issues with this implementation.
This project had a good run, was really useful and bots prior to the server update could run for months without any trouble. Right now is very unstable and unreliable due the ban problem.
If a new library/protocol update solves this issue, the work will return. Until then, sadly, the project will be on hold.
-
Basic message handling:
-
Automatic media (images and videos) download, and url print screens
-
Youtube Video Downloads, and Text to Speech
-
Google image and web search
-
Group administration
and a bit more...
- Install the image handling system dependencies on
bash opt/system-requirements.sh - Create a virtualenv and install the requirements
pip install -r opt/requirements.pip - Follow the instructions on
src/config.pyto get the whatsapp credentials. - Then just run the server with
python src/server.py
$ git clone https://github.com/joaoricardo000/whatsapp-bot-seed/
$ cd whatsapp-bot-seed
(Edit Dockerfile to include your credentials)
$ docker build -t whatsapp-bot .
$ docker run -p 0.0.0.0:9005:9005 whatsapp-bot
The server will be running. Access http://localhost:9005 (default: admin:password) for process controll and logs.