Guides
What the gateway is, how to run it, and how to send and receive WhatsApp messages over HTTP.
This gateway turns a WhatsApp number into a REST API. You pair a phone once, then send and receive messages over HTTP — from your own code or from the dashboard.
The two parts
| Part | What it is | What it does |
|---|---|---|
| Gateway | A Go service | Holds the WhatsApp connection, serves the REST API, and emits the event stream. |
| Dashboard | The web frontend | Where people sign in, pair numbers, create API keys, and watch messages. |
Both parts use the same database. You can run them on one machine for yourself, or deploy them on separate hosts.
This can get your number banned
The gateway talks to WhatsApp through an unofficial client — software that connects to WhatsApp without using its official Business API. WhatsApp prohibits bots and unofficial clients; automated use may violate its Terms and get the number banned. The built-in rate limiting and human-mimicry (read receipts, typing presence) reduce that risk but do not remove it. Use a number you can afford to lose, and use it at your own risk.
Start here
Read these top to bottom the first time through. Each page builds on the one before it.
Getting started
Run the database, start both apps, sign up, and find your organization.
Connect a number
Create a session and link a phone with a QR code or pairing code.
Send messages
Send text, polls, locations, and contact cards.
Receive events
Receive events over a realtime WebSocket or webhooks.
Event shape
The event envelope and a field-by-field catalog of every payload.
API keys
Create org-scoped keys for programmatic access.
Organizations
Share a connection by inviting collaborators into an org.
The dashboard
Admin and user surfaces, the viewer, and contacts.
For exact request and response shapes, follow the links into the API reference.