whatsapp-bot-seed

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)

:warning: Warning :warning:

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.

What it does?

• 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...

Installation

• Install the image handling system dependencies on

  opt/system-requirements.sh

• Create a virtualenv and install the requirements

  install -r opt/requirements.pip

• Follow the instructions on

  /config.py

  to get the whatsapp credentials.
• Then just run the server with

  src/server.py

Or with Docker!

$ 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.

To create your own views, check out

/router.py

and

/view/basic_views.py

for examples.