Webhooks

⚡ Real-Time Data Streams

Webhooks & Event Notifications

Don't waste server resources polling for updates. Use Webhooks to get instant notifications when a customer messages you, clicks a button, or reads your message.

View API Reference

Webhooks are the backbone of automation. Whether you are building Intelligent Chatbots or a custom CRM integration, webhooks ensure your application reacts immediately to user activity on WhatsApp.

📱

User Actions

Customer sends a message

➜

☁️

BotLinkd Cloud

Processes Event

➜

🖥️

Your Server

Receives JSON Payload

1. Setting Up Your Webhook

To start receiving data, you need to expose a public POST endpoint on your server (e.g., https://yoursite.com/api/webhook).

Method: POST
Format: JSON
Timeout: Please respond with 200 OK within 3 seconds to avoid retries.

Your Dashboard Configuration

Webhook URL:

https://api.your-domain.com/whatsapp/callback

✅ Message Received ✅ Message Read

2. Event: Incoming Message

Triggered when a user sends a text, image, or button reply to your number. This is essential for building 2-way conversation flows.

Use Case: Logging chats to CRM or triggering an OpenCart/WooCommerce order status check.

{
  "event": "message",
  "instance_id": "10922",
  "data": {
    "from": "447123456789",  // Sender's WhatsApp Number
    "to": "15550123456",     // Your Business Number
    "type": "text",
    "body": "Hello, where is my order?",
    "message_id": "wamid.HBgLM...",
    "timestamp": 1678900000
  }
}

3. Event: Delivery Status (ACK)

Triggered when the status of a message you sent changes. Use this to track campaign performance.

Status	Meaning
`sent`	Message left the server.
`delivered`	Delivered to user's phone.
`read`	User opened the chat (Blue Ticks).

{
  "event": "ack",
  "instance_id": "10922",
  "data": {
    "message_id": "wamid.HBgLM...",
    "status": "read",        // sent, delivered, or read
    "timestamp": 1678900055
  }
}

4. Don't Have a UI? Use Ours.

Building a frontend to visualize these webhooks takes time. Skip the development and use our Client-Side Cloud Portal.

It's a standalone web interface where you can login with just your API Keys to chat manually, view history, and monitor incoming webhook messages in real-time.

🔒 Secure Client-Side Auth: Your keys are stored locally in your browser. No account login required.

Open Cloud Chat Portal ↗

Cloud Chat Interface

💬

BotLinkd Cloud Chat

Enter AppKey & AuthKey to start chatting.

App Key: b07b...

Auth Key: mT1G...

Ready to Build?

Now that you have the events, use the API to reply.

Go to API Docs ➜