How to use Message Received Webhook

Capture every incoming message and take instant action

Whenever a customer sends you a message on WhatsApp, it is important to capture that information and act on it immediately.

The Message Received webhook helps you do exactly that.

It allows DoubleTick to send incoming message data to any system in real time, so you can automate responses, store data, or trigger workflows.


What is Message Received Webhook?

The Message Received webhook is triggered whenever your business receives a message on your DoubleTick API number.

In simple terms:

Whenever a customer sends you a message, this webhook immediately sends that message data to your configured URL.


When Does This Webhook Trigger?

This webhook is triggered every time:

  • A customer sends a message to your WhatsApp number

  • A new incoming conversation starts

  • A user replies to an existing conversation

This ensures that you never miss any incoming message data.


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

Follow these steps carefully.


Step 1: Go to Webhooks

  • Log in to DoubleTick

  • Go to Settings

  • Open Webhooks


Step 2: Create a New Webhook

  • Click on New Webhook

  • Enter a name

Example: Message Received Webhook


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

You need to provide a webhook URL where the incoming message data will be sent.

Important Understanding

You can use any system here, such as:

  • CRM tools (Zoho, HubSpot, Salesforce)

  • Automation tools (Zapier, Pabbly, Make)

  • Your backend system


How to Get Webhook URL from Bot Studio

  • Open DoubleTick in a new tab

  • Go to Bot Studio

  • Click on Create New Bot

  • Select trigger: On Webhook

  • Copy the webhook 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 Received event

  • Click on Create Webhook

Your webhook is now active.


How to Test the Webhook


Step 1: Send a Message to Your Number

  • Send a message from any number to your WhatsApp number connected with DoubleTick


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 captured data of the incoming message.


What Data Will You Receive?

This webhook captures detailed information about incoming messages.

Some key fields include:

  • Customer phone number (From)

  • Your business number (WABA number)

  • Customer name

  • Message content (text)

  • Message type

  • Message ID

  • Timestamp (date and time when message was received)

This gives you complete visibility of all incoming conversations.


Mapping Data in Bot Studio

To use this data correctly, you need to map key fields.

In Bot Studio:

  • Map Customer Number

    • Select: From

  • Map Your Number (WABA Number)

    • Select: relevant business number field


Sending Data to Google Sheets

You can store incoming message data in Google Sheets.

Steps:

  1. Go to Actions in Bot Studio

  2. Select Google Sheets

  3. Connect it with On Webhook Trigger

  4. Sign in with your Google account

  5. Select your sheet

  6. Map the required fields

Examples:

  • Customer Name

  • Phone Number

  • Message Text (message.text)

  • Timestamp

  1. Save and enable the flow


What Happens After Setup?

Once configured:

  • Every incoming message will be captured

  • Data will be automatically sent to your selected system

  • Logs will be stored without manual effort


Real Business Use Case

Use Case: Lead Capture and Instant Response System

Suppose a customer messages your business asking for product details.

Using this webhook:

  • The message is captured instantly

  • Customer details are stored in Google Sheets or CRM

  • A workflow is triggered (via Zapier, Pabbly, or backend)

  • An automatic reply can be sent to the customer by using conditions.

How businesses use this:

  • Capture all incoming leads automatically

  • Store inquiries in CRM without manual entry

  • Trigger auto-replies or chatbot flows by using conditions

  • Maintain a complete log of customer conversations

This ensures faster response time and better customer experience.


Conclusion

The Message Received webhook is essential for handling incoming communication effectively.

It helps you:

  • Capture every incoming message

  • Store customer data in real time

  • Integrate with external systems

  • Improve response speed and efficiency

Last updated