Public guide

Integration overview for API and webhook setup.

Use this page to connect another project to the WhatsApp panel without signing in first.

Endpoints

Primary routes

`POST /api/v1/messages`

Main JSON API for sending messages from another project.

`POST /send`

Compatibility route for simpler Fonnte-style integrations.

Per-device webhook

Set a webhook URL and secret on the device page to receive WhatsApp events back into your app.

JSON API

Send message example

curl -X POST http://localhost:34871/api/v1/messages
-H "Authorization: Bearer YOUR_DEVICE_API_KEY"
-H "Content-Type: application/json"
-d "{\"target\":\"628123456789\",\"body\":\"Hello from another project\",\"messageType\":\"text\"}"

Compat route

Simple send example

curl -X POST http://localhost:34871/send
-H "Authorization: YOUR_DEVICE_API_KEY"
-d "target=08123456789&message=Hello&countryCode=62"

Webhook

What events you get

`device.ready`

Device finished connecting.

`message.inbound`

New incoming WhatsApp message.

`message.ack`

Delivery/read state update.

`device.disconnected`

Session dropped or disconnected.

Setup flow

Typical steps

1. Create a device session

Connect one WhatsApp account per device.

2. Copy the API key

Each device has its own token.

3. Send requests

Call `/api/v1/messages` or `/send` from your app.

4. Configure webhook

Receive event callbacks in your CRM or project.

Back to login Full repo guide: docs/INTEGRATION.md