WhatsApp Direct Messaging API

Overview

This API allows external systems to send direct text and media messages through WappCloud’s platform.

POST https://client-api.wappcloud.com/api/v1/external/process

Header	Description
`x-api-key`	(Required) Your API Key for authentication
`Authorization`	Pass Bearer Token
`Content-Type`	`multipart/form-data` (for media) or `application/json` (for text)

{
  "contact_number": "+919876541230",
  "messageType": "text",
  "message": {
    "messageBody": "Hello, this is a test message"
  }
}

{
  "success": true,
  "code": 200,
  "message": "Message sent successfully"
}

To send media, use form-data in Postman:

Key	Value (Example)	Type
`chatMedia`	Upload your file (image, video, or document)	File
`messageType`	`file`	Text
`mediaType`	`image` (or `video`, `audio`, `document`)	Text
`contact_number`	`+919876541230`	Text

{
  "success": true,
  "code": 200,
  "message": "Message sent successfully"
}

Do not change field names → They must match exactly (contact_number, messageType, mediaType, chatMedia).
Contact number rules:
- Must start with + and include country code.
- No dashes or spaces allowed. Example: +919876541230.
For media messages, use form-data instead of raw JSON.
Supported media types: image, video, document, audio.
Make sure to set the correct mediaType that matches your uploaded file type.