# How to Use the WhatsApp Group Message Received Webhook

This webhook fires every time a participant sends a message in a WhatsApp group connected to your DoubleTick account. It captures who sent the message, what they said, which group it came from, and when it happened — and sends all of that to a system of your choice in real time.

It fires separately for every message. If ten members send messages in the same group, you receive ten separate webhook events.

***

#### <mark style="color:$primary;">**Step-by-Step Setup Guide**</mark>

This webhook activates when a participant sends a message in a WhatsApp group connected to your DoubleTick account.

<figure><img src="/files/uDpPEYy0Gg24s8epjwWG" alt=""><figcaption></figcaption></figure>

#### **Step 1: Open Webhooks in DoubleTick**

1. Log in to your DoubleTick account
2. Go to Settings
3. Click on Webhooks

#### **Step 2: Create a New Webhook**

1. Click New Webhook
2. Give it a name — for example: Group Message Monitor

#### **Step 3: Get Your Webhook URL**

You need a destination URL — this is where DoubleTick will send the data each time a group message is received.

You can connect it to:

* A CRM like Zoho, HubSpot, or Salesforce
* An automation tool like Zapier or Pabbly
* A spreadsheet like Google Sheets
* Your own backend or internal dashboard

For testing, use DoubleTick's Bot Studio to preview the incoming data first:

1. Open a new tab and go to Bot Studio
2. Click Create New Bot
3. Set the trigger to On Webhook
4. Copy the webhook URL that appears

#### **Step 4: Fill in Webhook Details**

1. Go back to the Webhooks page
2. Paste the webhook URL
3. Select your API Number (your WABA/WhatsApp Business number)
4. Click Continue

#### **Step 5: Choose the Event**

1. Select WhatsApp Group Message Received from the event list
2. Click Create Webhook

Your webhook is now active.

***

#### **How to Test It**

1. Add a test number to one of your connected WhatsApp groups
2. Send a message from that test number in the group
3. Go to Bot Studio → Capture Response → View Response Data
4. You will see the message data captured in real time

***

#### **What Data Do You Receive?**

When this webhook fires, it sends the following information to your system:

<table><thead><tr><th width="250.2667236328125">Field</th><th>What It Tells You</th></tr></thead><tbody><tr><td>to</td><td>The unique ID of the WhatsApp group where the message was received</td></tr><tr><td>from</td><td>The phone number of the participant who sent the message</td></tr><tr><td>type</td><td>The channel type — will always be wa_group for WhatsApp group messages</td></tr><tr><td>contact.name</td><td>The name of the participant as saved in DoubleTick</td></tr><tr><td>message.text</td><td>The text content of the message</td></tr><tr><td>message.type</td><td>The format of the message — TEXT, IMAGE, DOCUMENT, AUDIO, VIDEO, and so on</td></tr><tr><td>message.context</td><td>Details of the message being replied to — empty if this is not a reply</td></tr><tr><td>messageId</td><td>The unique WhatsApp ID assigned to this message</td></tr><tr><td>receivedAt</td><td>The exact date and time the message was received</td></tr><tr><td>dtMessageId</td><td>DoubleTick's internal unique ID for this message</td></tr><tr><td>callbackData</td><td>Custom callback data attached to this conversation, if configured — null if not set</td></tr><tr><td>isAgentOffline</td><td>Whether the assigned agent was offline when this message came in</td></tr><tr><td>dtLastMessageId</td><td>DoubleTick's internal ID of the last message in this conversation</td></tr><tr><td>integrationType</td><td>The integration channel — will always be WHATSAPP</td></tr><tr><td>lastMessageOrigin</td><td>Who sent the last message — CUSTOMER or AGENT</td></tr><tr><td>dtPairedTemplateId</td><td>ID of the paired template, if the previous message was a template — null if not applicable</td></tr><tr><td>dtPairedTemplateName</td><td>Name of the paired template, if the previous message was a template — null if not applicable</td></tr><tr><td>dtPairedMessageMetadata</td><td>Metadata of the paired message — null if not applicable</td></tr><tr><td>dtPairedTemplateLanguage</td><td>Language of the paired template — null if not applicable</td></tr></tbody></table>

***

**WhatsApp Group Message Received Webhook – Sample Payload**

json

{% code expandable="true" %}

```json
{
  "to": "grp_3665bc49a5",
  "from": "918169776684",
  "type": "wa_group",
  "contact": {
    "name": "Jyoti Kumari - DoubleTick"
  },
  "message": {
    "text": "Hey @919686651328 You were reaching out to rhitam for some query? Could you let me know the issue?",
    "type": "TEXT",
    "context": {}
  },
  "messageId": "wamid.HBgSMTIwMzYzNDI1MjUzNTczMjQ4FQgAEhgWM0VCMEIzQzg5RjU3MEVEMDg2QzI5NBwYDDkxODE2OTc3NjY4NBUCAAA=",
  "receivedAt": "2026-05-26T07:48:17.239Z",
  "dtMessageId": "464c920a-bc9a-461a-83f6-6098d1269602",
  "callbackData": null,
  "isAgentOffline": false,
  "dtLastMessageId": "b54343dd-0830-4cde-81dd-8d1930180052",
  "integrationType": "WHATSAPP",
  "lastMessageOrigin": "CUSTOMER",
  "dtPairedTemplateId": null,
  "dtPairedTemplateName": null,
  "dtPairedMessageMetadata": null,
  "dtPairedTemplateLanguage": null
}
```

{% endcode %}

***

#### <mark style="color:$primary;">**Real-Life Business Use Case: An EdTech Company Routing Student Queries from WhatsApp Groups Automatically**</mark>

**The Situation**

An EdTech company runs live online courses for working professionals. Each batch of 80 to 120 students has its own WhatsApp group — the primary place where students ask questions, flag issues, and request study materials. With 14 active batches running simultaneously, 14 groups are active at any given time, each with a designated academic coordinator.

**The Problem**

Coordinators are also managing student records, scheduling sessions, and handling calls. Monitoring 14 groups on top of everything else means messages get missed. A student who posts a question at 11 AM may not get a response until 3 PM — too late if they have a submission deadline that evening.

There is also no way to tell an urgent query from a casual comment. Both sit in the group with no prioritisation. And if a query goes unanswered and the student escalates it later, the support team has no searchable log to look back at.

**How the WhatsApp Group Message Received Webhook Solves This**

The company connects this webhook to their internal ticketing system.

The moment any student sends a message in any group, it is automatically logged in the ticketing system with the student's name, phone number, group name, and timestamp. The system then scans the message content — anything flagged as an access issue, technical error, or payment query is marked high priority and assigned to the right coordinator instantly.

If the coordinator does not respond within 30 minutes, the ticket escalates automatically to the academic head, who gets a WhatsApp notification with the student's name, message, and how long it has been waiting.

Every message is now on record. If a student complains that their query went unanswered, the team can look it up immediately.

**The Result**

Every message across all 14 groups is captured and logged automatically — nothing is missed due to group volume or coordinator availability

Urgent queries are routed to the right coordinator immediately, without anyone manually triaging the group

Unanswered queries escalate automatically after 30 minutes

The team has a complete, searchable message history outside of WhatsApp for accountability and review

***

#### <mark style="color:$primary;">**Summary**</mark>

The WhatsApp Group Message Received Webhook gives your business real-time visibility into every message sent across your connected WhatsApp groups. Set it up once, and every group message becomes a structured data point your systems can log, route, and act on — without anyone needing to watch the group manually.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.doubletick.io/webhooks/how-to-use-the-whatsapp-group-message-received-webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.