arrow_back Back to Home

WaselOne Developer API & Integration Guides

Integrate official WhatsApp messaging, Onyx ERP invoice dispatch, and custom automated bot flows into your software stack with our high-throughput REST API.

Getting Started 1. Overview & Auth 2. Send WhatsApp Message 3. Onyx ERP Invoice Dispatch 4. Webhook Listeners

1. Authentication

Authenticate all API requests using a Bearer token in the Authorization HTTP header. Generate tokens in your WaselOne Workspace Settings.

Authorization: Bearer wasel_live_98a72b10f54c3e8a...

POST /api/v1/messages/send-template

Send an approved WhatsApp Business template message to a verified phone number.

{
  "recipientPhone": "+966501234567",
  "templateName": "order_confirmation_v2",
  "language": "ar",
  "components": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "سعود العتيبي" },
        { "type": "text", "text": "#ORD-9824" },
        { "type": "text", "text": "149.99 SAR" }
      ]
    }
  ]
}

POST /api/v1/onyx/dispatch-invoice

Hook called automatically by the Onyx ERP connector upon invoice save event.

{
  "invoiceNumber": "INV-2026-9041",
  "customerPhone": "+966555123456",
  "pdfDownloadUrl": "https://cdn.waselone.sa/invoices/9041.pdf",
  "vatAmount": 19.50,
  "totalAmount": 149.50
}

4. Webhook Event Notifications

Configure your webhook endpoint to receive real-time delivery status, customer read receipts, and inbound message replies.

message.delivered

message.read (Blue Checks)

customer.replied

onyx.invoice_delivered