WMS Cloud Webhook Integration

Easily receive WhatsApp messages when your keyword is triggered.

🔧 How It Works

Once you've registered a webhook URL with your keyword in WMS Cloud, our system will:

✅ Match incoming WhatsApp messages against your keyword
✅ Deduct 1 credit if matched
✅ POST the message data to your provided webhook URL in real-time
✅ Optionally use your webhook reply as the reply to the user

📬 Webhook Payload (POST)

When your keyword is matched, WMS Cloud will send the following JSON to your webhook:

{
  "from": "60123456789",
  "full_message": "appointment John 12PM",
  "keyword": "appointment",
  "message_body": "John 12PM",
  "timestamp": "2025-06-22T11:40:00+08:00"
}

Field Reference:

from – WhatsApp sender's number
full_message – Full incoming message
keyword – The matched keyword
message_body – Portion after the keyword
timestamp – ISO datetime when message was received

💡 Example Webhook Handler (PHP)

This is a basic receiver script you can use to test or log messages:

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

// Save to file for testing
file_put_contents('wms_incoming.txt', date('c') . ' | ' . print_r($data, true), FILE_APPEND);

// Optional: Reply dynamically
$reply = 'Thanks! You sent: ' . $data['message_body'];

echo json_encode(['reply' => $reply]);
?>

Response JSON Example:

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

✅ Advantages of Using Webhooks

⚡ Real-time delivery to your server
🔁 Dynamic replies (customized based on message)
📥 Store or process messages in your CRM / database
🔗 Chain other API services (e.g. send emails, call third-party APIs)

🔒 Security Tips

🔐 Restrict access to your webhook endpoint (IP or token)
📜 Log all incoming requests during development
📤 Respond quickly (< 5 seconds) to avoid timeouts
📦 Store raw payloads for troubleshooting

Ready to Activate?

Set your webhook URL under your keyword settings in your WMS Dashboard.

Create Account