Skip to content
Back to search

waha

WAHA - WhatsApp HTTP API (REST API) that you can configure in a click! Multiple engines: WEBJS (browser based), NOWEB (websocket nodejs), GOWS (websocket go), WPP (browser)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/devlikeapro--waha/badge.svg)](/listings/devlikeapro--waha)

HTML

<a href="/listings/devlikeapro--waha"><img src="/api/listings/devlikeapro--waha/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements

Only thing that you must have - installed docker. Please follow the original instruction <a href="https://docs.docker.com/get-docker/" target="_blank" rel="noopener">how to install docker -></a>.

When you are ready - come back and follows the below steps to send the first text message to WhatsApp via HTTP API!

Send your first message

Let's go over steps that allow you to send your first text message via WhatsApp HTTP API!

1. Download image

Assuming you have installed [Docker](https://docs.docker.com/get-docker/), let's download the image.

docker pull devlikeapro/waha
docker login -u devlikeapro -p {KEY}
docker pull devlikeapro/waha-plus
docker logout

Read more about how to get `PASSWORD` for [**➕ WAHA Plus**](https://waha.devlike.pro/docs/how-to/waha-plus/)

2. Run WhatsApp HTTP API

Run WhatsApp HTTP API:

docker run -it --rm -p 3000:3000/tcp --name waha devlikeapro/waha

# It prints logs and the last line must be
# WhatsApp HTTP API is running on: http://[::1]:3000

Open the link in your browser [http://localhost:3000/](http://localhost:3000/) and you'll see API documentation (Swagger).

3. Start a new session

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: <a href="https://faq.whatsapp.com/381777293328336/?helpref=hc_fnav" target="_blank"> How to log in - the instruction on WhatsApp site </a>

When your ready - find `POST /api/sessions`, click on **Try it out**, then **Execute** a bit below.

The example payload:

{
  "name": "default"
}

By using the request with `name` values you can start multiple session (WhatsApp accounts) inside the single docker container in Plus

4. Get and scan QR

Find `GET /api/screenshot` and execute it, it shows you QR code.

**Scan the QR with your cell phone's WhatsApp app.**

5. Get the screenshot

Execute `GET /api/screenshot` after a few seconds after scanning the QR - 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!

6. Send a text message

Let's send a text message - find `POST /api/sendText` in [swagger](http://localhost:3000/) and change `chatId` this way: use a phone international phone number without `+` symbol and add `@c.us` at the end.

For phone number `12132132131` the `chatId` is `12132132131@c.us`.

The example payload:

{
  "chatId": "12132132130@c.us",
  "text": "Hi there!",
  "session": "default"
}

Also, you can use `curl` and send POST request like this:

# Phone without +
export PHONE=12132132130
curl -d "{\"chatId\": \"${PHONE}@c.us\", \"text\": \"Hello from WhatsApp HTTP API\" }" -H "Content-Type: application/json" -X POST http://localhost:3000/api/sendText

What is next?

[Go and read the full documentation!](https://waha.devlike.pro/docs/overview/introduction/)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 164 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # WAHA
  2. <p align="center">
  3. <img src="./logo.png" style='border-radius: 50%' width='150'/>
  4. </p>
  5. **WAHA** - **W**hats**A**pp **H**TTP **A**PI (REST API) that you can install on your own server and run in less than 5 minutes!
  6. [![Docker Pulls](https://img.shields.io/docker/pulls/devlikeapro/waha)](https://hub.docker.com/r/devlikeapro/waha)
  7. - Documentation: [https://waha.devlike.pro/](https://waha.devlike.pro/)
  8. - Dashboard Example: [https://waha.devlike.pro/dashboard](https://waha.devlike.pro/dashboard)
  9. - Swagger Example: [https://waha.devlike.pro/swagger](https://waha.devlike.pro/swagger)
  10. # Tables of Contents
  11. <!-- toc -->
  12. - [Quick start](#quick-start)
  13. * [Requirements](#requirements)
  14. * [Send your first message](#send-your-first-message)
  15. + [1. Download image](#1-download-image)
  16. + [2. Run WhatsApp HTTP API](#2-run-whatsapp-http-api)
  17. + [3. Start a new session](#3-start-a-new-session)
  18. + [4. Get and scan QR](#4-get-and-scan-qr)
  19. + [5. Get the screenshot](#5-get-the-screenshot)
  20. + [6. Send a text message](#6-send-a-text-message)
  21. * [What is next?](#what-is-next)
  22. - [Development](#development)
  23. * [Start the project](#start-the-project)
  24. <!-- tocstop -->
  25. # Quick start
  26. ## Requirements
  27. Only thing that you must have - installed docker. Please follow the original
  28. instruction <a href="https://docs.docker.com/get-docker/" target="_blank" rel="noopener">how to install docker -></a>.
  29. When you are ready - come back and follows the below steps to send the first text message to WhatsApp via HTTP API!
  30. ## Send your first message
  31. Let's go over steps that allow you to send your first text message via WhatsApp HTTP API!
  32. ### 1. Download image
  33. Assuming you have installed [Docker](https://docs.docker.com/get-docker/), let's download the image.
  34. ```bash
  35. docker pull devlikeapro/waha
  36. ```
  37. Looking for **WAHA Plus**? It's now part of the main `devlikeapro/waha` image - all Plus features are included.
  38. Read more: [WAHA 2026.6 - Plus is now Core](https://waha.devlike.pro/blog/waha-2026-6/)
  39. ### 2. Run WhatsApp HTTP API
  40. Run WhatsApp HTTP API:
  41. ```bash
  42. docker run -it --rm -p 3000:3000/tcp --name waha devlikeapro/waha
  43. # It prints logs and the last line must be
  44. # WhatsApp HTTP API is running on: http://[::1]:3000
  45. ```
  46. Open the link in your browser [http://localhost:3000/](http://localhost:3000/) and you'll see API documentation
  47. (Swagger).
  48. ### 3. Start a new session
  49. To start a new session you should have your mobile phone with installed WhatsApp application close to you.
  50. Please go and read how what we'll need to a bit
  51. later:
  52. <a href="https://faq.whatsapp.com/381777293328336/?helpref=hc_fnav" target="_blank">
  53. How to log in - the instruction on WhatsApp site
  54. </a>
  55. When your ready - find `POST /api/sessions`, click on **Try it out**, then **Execute** a bit below.
  56. The example payload:
  57. ```json
  58. {
  59. "name": "default"
  60. }
  61. ```
  62. By using the request with different `name` values you can start multiple sessions (WhatsApp accounts) inside the single docker container.
  63. ### 4. Get and scan QR
  64. Find `GET /api/screenshot` and execute it, it shows you QR code.
  65. **Scan the QR with your cell phone's WhatsApp app.**
  66. ### 5. Get the screenshot
  67. Execute `GET /api/screenshot` after a few seconds after scanning the QR - it'll show you the screenshot of you Whatsapp
  68. instance. If you can get the actual screenshot - then you're ready to start sending messages!
  69. ### 6. Send a text message
  70. Let's send a text message - find `POST /api/sendText` in [swagger](http://localhost:3000/) and change `chatId` this
  71. way: use a phone international phone number without `+` symbol and add `@c.us` at the end.
  72. For phone number `12132132131` the `chatId` is `12132132131@c.us`.
  73. The example payload:
  74. ```json
  75. {
  76. "chatId": "12132132130@c.us",
  77. "text": "Hi there!",
  78. "session": "default"
  79. }
  80. ```
  81. Also, you can use `curl` and send POST request like this:
  82. ```bash
  83. # Phone without +
  84. export PHONE=12132132130
  85. curl -d "{\"chatId\": \"${PHONE}@c.us\", \"text\": \"Hello from WhatsApp HTTP API\" }" -H "Content-Type: application/json" -X POST http://localhost:3000/api/sendText
  86. ```
  87. ## What is next?
  88. [Go and read the full documentation!](https://waha.devlike.pro/docs/overview/introduction/)
  89. # Development
  90. ## Start the project
  91. 1. Clone the repository
  92. 2. Make sure you're using node>=22 (check [.nvmrc](/.nvmrc) to get the version)
  93. 3. Install the **whatsapp-rust-bridge prerequisites**:
  94. ```bash
  95. # Bun runtime used by whatsapp-rust-bridge prepare scripts
  96. curl -fsSL https://bun.sh/install | bash -s -- bun-v1.3.9
  97. # Rust nightly toolchain used for whatsapp-rust-bridge
  98. curl -fsSL https://sh.rustup.rs | bash -s -- -y --default-toolchain nightly-2026-01-30
  99. rustup target add wasm32-unknown-unknown
  100. cargo install wasm-pack --vers 0.14.0 --locked
  101. ```
  102. 4. Run the following commands:
  103. ```bash
  104. # Install dependencies
  105. yarn install
  106. # Fetch and compile proto files
  107. yarn gows:proto
  108. # Run
  109. yarn start
  110. # open http://localhost:3000
  111. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.