WhatsApp Web API Bridge SaaS

POST /api/v1/start-session

Initialize your WhatsApp session. Required before fetching the QR code.

curl -X POST http://your-domain.com/api/v1/start-session \
  -H "x-api-key: YOUR_GENERATED_API_KEY"

GET /api/v1/instance-status

Fetch connection status. If waiting for QR, it returns the Base64 image.

curl -X GET http://your-domain.com/api/v1/instance-status \
  -H "x-api-key: YOUR_GENERATED_API_KEY"

POST /api/v1/logout

Logout the current WhatsApp session and delete authentication keys.

curl -X POST http://your-domain.com/api/v1/logout \
  -H "x-api-key: YOUR_GENERATED_API_KEY"

POST /api/v1/send-message

Send a text message to any WhatsApp number.

curl -X POST http://your-domain.com/api/v1/send-message \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_GENERATED_API_KEY" \
  -d '{
    "to": "919876543210",
    "message": "Hello from my ERP Software!"
  }'

POST /api/v1/send-media

Send an image, document, or video.

curl -X POST http://your-domain.com/api/v1/send-media \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_GENERATED_API_KEY" \
  -d '{
    "to": "919876543210",
    "type": "document",
    "url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
    "fileName": "Invoice_123.pdf",
    "mimetype": "application/pdf"
  }'

GET /api/v1/get-messages

Fetch message history (inbound and outbound) for a specific phone number.

curl -X GET "http://your-domain.com/api/v1/get-messages?phone=919876543210&limit=50" \
  -H "x-api-key: YOUR_GENERATED_API_KEY"

POST /api/v1/webhook/set

Set a webhook URL to receive incoming messages automatically via HTTP POST.

curl -X POST http://your-domain.com/api/v1/webhook/set \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_GENERATED_API_KEY" \
  -d '{
    "webhookUrl": "https://your-domain.com/webhook/receive"
  }'

Incoming Webhook Payload:

{
  "from": "919876543210",
  "message": "Hello there!",
  "timestamp": "2023-10-05T12:00:00.000Z",
  "messageId": "B1C2D3E4F5A6"
}

The Ultimate WhatsApp API Bridge for your ERP