WhatsApp Status Upload API

Upload an image, video, or text-only WhatsApp Status directly from your connected session using Baileys REST Mongo API.

This endpoint supports external webhooks and Hybrid Authentication (API Keys + JWT).

🔗 Endpoint

POST https://api.walytic.com/api/whatsapp/:sessionId/update-status

Uploads a new WhatsApp status update (text, image, or video) for the connected WhatsApp session.

🔐 Required Headers

Header	Type	Required	Description
`x-api-key`	`String`	✅ Yes	Your API key (for external API integrations).
`Authorization`	`String`	Optional	JWT Bearer token (for logged-in dashboard users).
`Content-Type`	`String`	✅ Yes	Must be `application/json`.

📤 Request Body Parameters

Field	Type	Required	Description
`fileUrl`	`String`	❌ Optional	Publicly accessible URL of the media (image or video). Required for media statuses.
`caption`	`String`	❌ Optional	Optional caption text for the status. If `fileUrl` is not provided, caption alone will be posted as a text-only status.
backgroundColor	string	#101010
font		SANS_SERIF

{
  "fileUrl": "https://res.cloudinary.com/demo/image/upload/sample.jpg",
  "caption": "My weekend vibes 🌴",
  "backgroundColor": "#101010",
  "font": "SANS_SERIF"
}

⚙️ Supported Media Types

Media Type	Description
`image/*`	JPEG, PNG, or WEBP images.
`video/*`	MP4 or MOV video formats.
Text only	When only `caption` is sent and no `fileUrl` is provided.

🧠 Internal Workflow (For Developers)

Request hits
controllers/whatsappController.js → updateStatus()
Retrieves the active Baileys session via
sessionManager.getSession(sessionId)
Downloads the media (if fileUrl is present) using axios.get(fileUrl)
Detects MIME type → validates it as image/* or video/*

Sends the status via Baileys:

sock.sendMessage("status@broadcast", content)

Triggers the configured external webhook with metadata:

{
  "event": "statusUpdated",
  "sessionId": "session-919876543210",
  "mediaType": "image",
  "fileUrl": "https://example.com/image.jpg",
  "caption": "Hello everyone 👋",
  "timestamp": "2025-10-27T06:21:11Z"
}

🧩 Example Request (Node.js)

const axios = require("axios");

async function uploadWhatsAppStatus() {
  try {
    const response = await axios.post(
      "https://api.walytic.com/api/whatsapp/session-919876543210/update-status",
      {
        fileUrl: "https://example.com/myvideo.mp4",
        caption: "Weekend vibes! 😎"
      },
      {
        headers: {
          "x-api-key": "YOUR_API_KEY",
          "Content-Type": "application/json"
        }
      }
    );

    if (response.data.success) {
      console.log("✅ Status uploaded successfully!");
      console.log(response.data);
    } else {
      console.log("❌ Error:", response.data.error);
    }
  } catch (error) {
    console.error("Request failed:", error.response?.data || error.message);
  }
}

uploadWhatsAppStatus();

🧾 Example Request (cURL)

$curl -X POST https://api.walytic.com/api/whatsapp/session-919876543210/update-status \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "fileUrl": "https://example.com/pic.jpg",
  "caption": "Good Morning 🌞"
}'

📦 Example Response (✅ Success)

{
  "success": true,
  "message": "WhatsApp status updated successfully",
  "data": {
    "sessionId": "session-919876543210",
    "mediaType": "image",
    "caption": "Good Morning 🌞",
    "timestamp": "2025-10-27T06:21:11Z"
  }
}

❌ Example Response (Error)

{
  "success": false,
  "message": "Failed to update status",
  "error": "Session not found or not connected"
}

{
  "success": false,
  "message": "Only image or video types allowed for status"
}

📡 Webhook Event Examples

✅ Status Updated Event

{
  "event": "statusUpdated",
  "sessionId": "session-919876543210",
  "mediaType": "image",
  "fileUrl": "https://example.com/pic.jpg",
  "caption": "Good Morning 🌞",
  "timestamp": "2025-10-27T06:21:11Z"
}

📝 Text-only Status Event

{
  "event": "statusUpdated",
  "sessionId": "session-919876543210",
  "mediaType": "text",
  "caption": "Just checking in 👋",
  "timestamp": "2025-10-27T06:25:11Z"
}

🔒 Authentication Flow

Source	Auth Method	Header
External Clients	API Key	`x-api-key`
Internal Dashboard	JWT	`Authorization: Bearer <token>`

Middleware hybridAuth validates either method before routing to the controller.

⚙️ Notes

Works only if the WhatsApp session is connected (/api/whatsapp/:sessionId/status can be used to check).
Supports text, image, or video status updates.
Triggers webhook updates automatically when status is uploaded.
Uses Baileys WebSocket for WhatsApp Web protocol handling.
Media must be accessible via public HTTPS URLs.
Upload limits depend on WhatsApp (max ~30 seconds for video).