WhatsApp HTTP API that you can configure in a click! It's really Free! :)
The project provides you HTTP API for Whatsapp that you can use to send and receive messages. You can go through currently supported methods in Swagger
The project is an HTTP API wrapper around https://github.com/orkestral/venom
Only thing that you must have - installed docker. Please follow the original instruction how to install docker
docker pull allburov/whatsapp-http-apiWe're going to go through basic steps and send a text message at the end!
Run WhatsApp HTTP API:
docker run -it --rm -v `pwd`/tokens:/app/tokens -p 127.0.0.1:3000:3000/tcp --name whatsapp-http-api allburov/whatsapp-http-api
# It prints logs and the last line must be
# WhatsApp HTTP API is running on: http://[::1]:3000Open the link in your browser: http://localhost:3000/
Note: We don't recommend expose the API outside the world because it does not support (yet) authorization!
- To start a new session you should have your mobile phone with installed WhatsApp application close to you. Please go and read how what we'll need to a bit later: How to log in - the instruction on WhatsApp site
- Open API documentation at http://localhost:3000/
- Start a new session with a name (you can use
defaultfor the start) - findPOST /api/session/start, click on Try it out, then Execute a bit below.
- Scan QR Code - find
GET /api/screenshotand execute it, it'll show you QR code that you must scan with your device.
- Get a screenshot again - it'll show you the screenshot of you Whatsapp instance. If you can get the actual
screenshot - then you're ready to start sending messages!
Let's try to send a message - you can either find POST /api/sendText in swagger (http://localhost:3000/) or
use curl or just open a link in a browser (change the phone
before!) http://localhost:3000/api/sendText?phone=79776772457&text=Hello+from+WhatsApp+HTTP+API+Free!
# Phone without +
# Using GET
curl "http://localhost:3000/api/sendText?phone=79776772457&text=Hello+from+WhatsApp+HTTP+API+Free!"
# Using POST
export PHONE=79776772457
curl -d "{\"chatId\": \"${PHONE}@c.us\", \"text\": \"Hello from WhatsApp HTTP API Free\" }" -H "Content-Type: application/json" -X POST http://localhost:3000/api/sendTextTo show how to receive messages we'll create a simple "echo" server with two functions:
- When we receive a text message - just send the text back
- When we receive a message with a file (an image, a voice message) - download it and send the path back
In order to send you messages we use Webhooks (look at them below) and configure them via environments variables. So
what you need to
create "echo" server is HTTP server that will receive JSON POST request and then call back WhatsApp HTTP API
via POST /api/sendText endpoint with JSON body.
We use Python. Feel free to create your favorite language example and contribute to the project!
Run "echo" server in one terminal and leave it working:
# if you haven't already
git clone https://github.com/allburov/whatsapp-http-api.git
cd whatsapp-http-api
python -mpip install -r examples/requirements.txt
export FLASK_APP=examples/echo.py
flask runVisit http://localhost:5000 and check that we are good to go further.
Let's start WhatsApp HTTP API and configure the "on message" webhook and point it on our "http://localhost:5000/message" endpoint:
docker run -it -v `pwd`/tokens:/app/tokens --network=host -e WHATSAPP_HOOK_ONMESSAGE=http://localhost:5000/message allburov/whatsapp-http-apiNow go ahead, open the second whatsapp and send to our WhatsApp HTTP API a text message! It must reply the same text.
If you try to send an image the "echo server" will send a path to the downloaded file.
DEBUG- show debug and verbose logs, set in any valueWHATSAPP_API_PORT- listen port for HTTP server (default:3000)WHATSAPP_API_HOSTNAME- Hostname for HTTP server (default:localhost)WHATSAPP_START_SESSION- start session with that name right after launching the app
The description of webhooks you can in Venom README.md, section Events
All webhooks are disabled by default:
WHATSAPP_HOOK_ONANYMESSAGE=http://localhost/uriWHATSAPP_HOOK_ONMESSAGE=http://localhost/uriWHATSAPP_HOOK_ONSTATECHANGE=http://localhost/uriWHATSAPP_HOOK_ONACK=http://localhost/uriWHATSAPP_HOOK_ONADDEDTOGROUP=http://localhost/uri
If you want to look at the payload of the webhooks - use the url for that https://httpbin.org/post.
docker run -it -v `pwd`/tokens:/app/tokens --network=host -e WHATSAPP_HOOK_ONMESSAGE=https://httpbin.org/post allburov/whatsapp-http-apiWHATSAPP_FILES_FOLDER- folder where will be stored files from chats (images, voice messages) ( default:/tmp/whatsapp-files)WHATSAPP_FILES_MIMETYPES- download only these mimetypes from messages (download all files be default). Mimetypes must be separated by a comma, without spaces:audio,image/png,image/gif. In order to choose type use prefix ( likeaudio,image).WHATSAPP_FILES_LIFETIME- to keep free space files will be removed after this time (default:180, in seconds)
If the changes haven't been released yet from main branch - you can build your own version from the git repository
git clone https://github.com/allburov/whatsapp-http-api.git
cd whatsapp-http-api
docker build . -t allburov/whatsapp-http-apiIf you want to support the project - you can either:
- Create a Pull Request for desired functionality
- Support the project one time, every month or get access to telegram channel on Boosty
- Looking for the personal support, have an important feature request for your business, need to develop a whatsapp bot? Reach me out at Telegram!