How to use Message Status Update Webhook

Track every message you send — including sent, delivered, read, and failed status

When you send messages from DoubleTick, especially template messages, it is important to know what happens after sending them.

Did the message/template reach the customer? Did the customer read it? Did the message/template fail?

The Message Status Update webhook helps you track all of this automatically.

---

What is Message Status Update Webhook?

The Message Status Update event is triggered whenever there is a change in the status of a message sent through DoubleTick.

In simple terms:

Every time you send a message, this webhook keeps updating your system with the latest status of that message/template.

---

When Does This Webhook Trigger?

This webhook is triggered at every stage of the message lifecycle:

• When the message is sent

• When the message is delivered

• When the message is read

• When the message fails (not sent or not delivered)

This gives you complete visibility into your message performance.

---

Step-by-Step: How to Set Up Message Status Webhook

Follow these steps carefully.

---

Step 1: Go to Webhooks

• Log in to DoubleTick

• Go to Settings

• Search and open Webhooks

---

Step 2: Create a New Webhook

• Click on New Webhook (top right corner)

• Enter a name

Example: Message Status Tracker

---

Step 3: Add Webhook URL (Where Data Will Be Sent)

At this step, you need to provide a Webhook URL. This is where DoubleTick will send the data.

Important Understanding

You can use any system URL here, such as:

• CRM tools (Zoho, HubSpot, Salesforce)

• Automation tools (Zapier, Pabbly, Make)

• Your own backend or server

Wherever you want to receive and process the data, that system will provide you with a webhook URL.

---

How to Get a Test Webhook URL from Bot Studio

• Open DoubleTick in a new tab

• Go to Bot Studio

• Click on Create New Bot

• Select trigger: On Webhook

You will see a webhook URL.

• Copy this URL

---

Step 4: Add Webhook Details

• Go back to the Webhooks page

• Paste the webhook URL

• Select your API Number (WABA number)

• Click on Continue

---

Step 5: Select Event

• Select Message Status Update

• Click on Create Webhook

Your webhook is now active.

---

How to Test the Webhook

---

Step 1: Send a Template Message

• Go to New Chat

• Enter your number

• Start the chat

• Send a template message

---

Step 2: Capture Response

• Go to Bot Studio

• Click on Capture Response

---

Step 3: View Response Data

• Click on View Response Data

You will now see all the webhook data captured.

---

What Data Will You Receive?

The webhook provides detailed information about each message.

This includes:

• Customer number (To)

• Your sending number (Sent By / WABA number)

• Message status (Sent, Delivered, Read, Failed)

• Message type (Template or Text)

• Template name

• Message body

• Buttons (if included in the template)

• Assigned agent

• Failure reason (if the message fails)

• Customer full name

• Timestamp (date and time)

This gives you a complete log of every message you send.

---

Mapping Data in Bot Studio

After capturing the response, you need to map key fields.

In Bot Studio:

• First dropdown → Map Customer Number

  • Select: To

• Second dropdown → Map Your Number (WABA Number)

  • Select: Sent By

This ensures proper identification of sender and receiver.

---

Sending Data to Google Sheets

You can store webhook data in Google Sheets for tracking and reporting.

Steps:

1. Go to Actions in Bot Studio

2. Search and select Google Sheets

3. Connect it to the On Webhook Trigger

4. Click on Sign in with Google

5. Select your Google account

6. Choose your sheet

7. Map the required fields to columns

8. Save and enable the flow

---

What Happens After Setup?

Once your webhook is set up:

• Every message you send will generate logs

• You will get separate entries for:

  • Sent

  • Delivered

  • Read

  • Failed

All data will be automatically stored in your connected system (Google Sheets, CRM, or any tool you choose).

---

Real Business Use Case

Use Case: Campaign Tracking and Performance Optimization

Suppose you run a WhatsApp campaign and send a template message to multiple customers.

Using this webhook:

• You track how many messages were sent successfully

• You monitor how many were delivered

• You see how many customers actually read the message

• You identify messages that failed and understand the reason

How businesses use this:

• Maintain a live dashboard in Google Sheets

• Retry failed messages automatically

• Send follow-ups only to users who have not read the message

• Update CRM systems with real-time message status

This helps businesses make better decisions and improve campaign performance.

---

Conclusion

The Message Status Update webhook is a powerful tool for tracking and managing message performance.

It helps you:

• Monitor the full lifecycle of messages

• Track delivery, read, and failure status

• Automate reporting

• Integrate with external systems

• Improve communication efficiency