WhatsApp Integration

Total Access supports WhatsApp Business messaging through the Total Integration module. Send and receive messages, manage connections, and automate notifications.

Prerequisites

WhatsApp Business API account or QR-code connection
Total Access account with WhatsApp module access
API key with whatsapp:connect, whatsapp:send, and whatsapp:receive scopes

Connecting WhatsApp

Option 1: QR Code Connection

Navigate to Total Integration → WhatsApp
Click Connect WhatsApp
Open WhatsApp on your phone
Scan the QR code displayed
Wait for connection confirmation

Option 2: WhatsApp Business API

Navigate to Total Integration → WhatsApp
Click Connect via API
Enter your WhatsApp Business API credentials
Configure webhook URL for receiving messages
Save and verify the connection

Sending messages

curl -X POST https://totalaccess.co.za/api/v1/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+27821234567",
    "message": "Hello from Total Access!",
    "type": "text"
  }'

Message types

Type	Description	Additional Fields
`text`	Plain text message	`message`
`template`	Pre-approved template message	`template_name`, `template_params`
`image`	Image message	`image_url`, `caption`
`document`	Document message	`document_url`, `filename`
`location`	Location message	`latitude`, `longitude`, `address`

Receiving messages

Incoming WhatsApp messages are delivered via webhook. Configure an outbound webhook with the whatsapp.message_received event:

{
  "event": "whatsapp.message_received",
  "timestamp": "2026-07-22T14:00:00Z",
  "data": {
    "from": "+27821234567",
    "message_id": "msg_abc123",
    "type": "text",
    "text": "Hello!",
    "timestamp": "2026-07-22T14:00:00Z"
  }
}

Connection status

curl -X GET https://totalaccess.co.za/api/v1/whatsapp/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true,
  "data": {
    "connected": true,
    "phone_number": "+27821234567",
    "name": "Business Name",
    "connected_at": "2026-07-22T10:00:00Z"
  }
}

Scopes

Scope	Description
`whatsapp:connect`	Connect/disconnect WhatsApp instances
`whatsapp:send`	Send WhatsApp messages
`whatsapp:receive`	Receive WhatsApp messages via webhooks
`whatsapp:status`	Check WhatsApp connection status

WhatsApp Business API has its own rate limits and pricing. See the WhatsApp Business documentation for details.

WhatsApp Integration

On this page