Webhook Guide (Baileys Personal WhatsApp)

Automate replies and process incoming WhatsApp messages using your own webhook.

🔧 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

Ready to Connect Your Webhook?

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

Create Account