WMS Personal - Webhook Guide

🔧 How It Works

When a WhatsApp message is received, and your device has a webhook URL configured:

📥 The message is forwarded via POST to your webhook
💳 1 credit is deducted from your account for the inbound message if a webhook is set
⚡ If your webhook returns a valid {"reply": "..."} JSON, it is sent as a reply
💳 Another credit will be deducted for an outbound reply if your webhook returns a valid {"reply": "..."} and the system successfully sends it. If no reply is returned or sent, no outbound credit will be charged.

📬 Webhook Payload (POST)

Here’s what will be sent to your webhook URL:

{
  "user_id": 123,
  "device_id": "abc123",
  "whatsapp_id": "60123456789@s.whatsapp.net",
  "from": "60123456789",
  "message": "Hello, I need help",
  "message_id": "ABCDEF123456",
  "timestamp": 1722337200
}

Field Reference:

user_id – Your user ID
device_id – Your device ID
whatsapp_id – WhatsApp sender JID
from – Sender's phone number
message – Text content of the message
message_id – Unique message ID
timestamp – UNIX timestamp

💡 Example Webhook Handler (PHP)

Use this sample PHP script to process incoming messages and optionally reply:

<?php
$input = file_get_contents('php://input');
$data = json_decode($input, true);

// Log to file (for development)
file_put_contents('personal_incoming.txt', date('c') . " | " . print_r($data, true), FILE_APPEND);

// Return dynamic reply
$reply = "Thanks! You said: " . $data['message'];
header('Content-Type: application/json');
echo json_encode(['reply' => $reply]);
?>

Expected Webhook Response:

{
  "reply": "Thanks! Your appointment has been scheduled."
}

✅ Benefits of Using a Webhook

⚡ Real-time message delivery to your backend
🧠 Smart, dynamic replies based on user input
📊 Log or process chats in your database or CRM
🔗 Connect with other APIs (email, chatbot, booking)

🔒 Security Best Practices

✅ Validate incoming requests with IP or secret token
📜 Log all payloads for debugging
⏱️ Respond quickly (< 5 seconds) to avoid timeouts
🧪 Use staging/test servers during development

🌐 Integration Samples

See how you can connect WMS Personal webhooks to various platforms and automation tools.

Google Sheets Integration

Automatically log WhatsApp messages into Google Sheets and reply automatically via Apps Script.

View Guide

Ready to Connect Your Webhook?

Set your webhook URL under your device settings in your WMS Personal Dashboard.

Create Account

Webhook Guide (Baileys Personal WhatsApp)