WhatsApp

Send messages, templates, and manage conversations via GoWA or Meta Cloud API.

Requires a WhatsApp account connected in the dashboard (GoWA self-hosted or Meta Cloud API). Supports text messages, template messages with variables, media attachments, and conversation management.

Endpoints

MethodPathPermission
POST
whatsapp.send
POST
whatsapp.send
POST
whatsapp.send
GET
whatsapp.history
GET
whatsapp.history
GET
whatsapp.history
GET
whatsapp.history
DELETE
whatsapp.send

Send Message

POST /api/v1/whatsapp/send

Request

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "queued",
    "to": "+33612345678",
    "body": "Hello! Your appointment is confirmed for tomorrow at 3pm."
  }
}
json

Send Template

POST /api/v1/whatsapp/send-template

Request

Response

{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440000",
    "status": "queued",
    "to": "+33612345678",
    "templateName": "order_confirmation"
  }
}
json

List Conversations

GET /api/v1/whatsapp/conversations

Request

Response

{
  "success": true,
  "data": [
    {
      "id": "conv-uuid-1",
      "contact": "+33612345678",
      "lastMessage": "Thanks for confirming!",
      "lastMessageAt": "2026-03-18T14:30:00Z",
      "unreadCount": 2
    },
    {
      "id": "conv-uuid-2",
      "contact": "+33698765432",
      "lastMessage": "When will my order arrive?",
      "lastMessageAt": "2026-03-18T13:15:00Z",
      "unreadCount": 1
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 45, "total_pages": 3 }
}
json