# How to use Tag Added Webhook

Your team is handling dozens — sometimes hundreds — of conversations every day.

To stay organized, you use tags like:

* Hot Lead
* Interested
* Follow-up Required
* VIP Customer

It works well for categorization.

But here’s the problem — tagging alone doesn’t take action.

A lead might be marked as “Hot Lead”… but no one follows up immediately.\
A VIP customer gets tagged… but doesn’t receive priority service.

Opportunities slip through.

The **Tag Added Webhook** solves this instantly.

The moment a tag is added to a customer or conversation, your system is notified — and can take action immediately.

***

#### <mark style="color:$primary;">**What Is the Tag Added Webhook?**</mark>

This webhook triggers whenever a tag is added to:

* A customer profile
* A conversation

In simple terms:

**Tag added → webhook fires → action happens instantly**

Instead of just labeling customers, you can now **automate what happens next**.

***

#### <mark style="color:$primary;">**When Does This Webhook Trigger?**</mark>

This webhook activates whenever a tag is added, regardless of how it was applied:

* When a team member adds a tag manually
* When a bot adds a tag automatically
* When a workflow assigns a tag

No matter the source — the webhook will trigger every time.

***

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

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FibaYX7aF20bhR0WNLBzP%2FUntitled%20design%20-%202026-04-07T123203.140.gif?alt=media&#x26;token=622b9522-3f80-4442-b633-56e6cac61580" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$primary;">**Step 1: Go to Webhooks**</mark>

* Log in to your DoubleTick account
* Go to **Settings**
* Click on **Webhooks**

#### <mark style="color:$primary;">**Step 2: Create a New Webhook**</mark>

* Click **New Webhook**
* Enter a name (example: *Tag Added Automation*)

#### <mark style="color:$primary;">**Step 3: Add Webhook URL**</mark>

This is where DoubleTick will send the data.

You can connect it to:

* CRM tools (Zoho, HubSpot, Salesforce)
* Automation tools (Zapier, Pabbly, Make)
* Your backend system

**For testing:**

* Open **Bot Studio**
* Click **Create New Bot**
* Select trigger → *On Webhook*
* Copy the webhook URL

#### <mark style="color:$primary;">**Step 4: Add Webhook Details**</mark>

* Go back to **Webhooks**
* Paste the webhook URL
* Select your API Number (WABA number)
* Click **Continue**

#### <mark style="color:$primary;">**Step 5: Select Event**</mark>

* Select **Tag Added**
* Click **Create Webhook**

Your webhook is now live.

***

#### <mark style="color:$primary;">**How to Test It**</mark>

Add a tag to any customer or conversation — or wait for a tag to be applied via bot or workflow

Go to **Bot Studio → Capture Response → View Response Data**

You will see all the tag details captured instantly at the exact moment the tag was added.

***

#### <mark style="color:$primary;">**What Data Do You Receive?**</mark>

| Field         | What It Tells You          |
| ------------- | -------------------------- |
| customerPhone | Customer’s WhatsApp number |
| Tag name      | Name of the tag added      |
| tag ID        | Unique ID of the Tag       |
| Tag added     | true                       |

This data helps you understand **who was tagged, what tag was added, and when it happened** — enabling real-time automation.

***

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

```json
{
  "from": "919136943362",
  "tagId": "tag_iC0uqfNy47",
  "tagName": "bad review",
  "tagAdded": true
}
```

***

#### <mark style="color:$primary;">**What Can You Do with This Data?**</mark>

You can use this webhook to:

* Automatically segment customers
* Trigger workflows based on tags
* Send data to your CRM
* Prioritize high-value leads
* Build reports based on customer categories

***

#### <mark style="color:$primary;">**Real-Life Business Use Case: Automatically Prioritizing and Routing High-Intent Leads**</mark>

**The Situation**

A sales team handles hundreds of leads daily through WhatsApp.

Agents manually tag leads based on intent, such as:

* Hot Lead
* Interested
* Not Interested

**The Problem**

* Tagged leads were not acted upon instantly
* Hot leads were not prioritized
* Follow-ups were delayed
* No structured lead routing

**The Solution**

The business connects the Tag Added webhook to their CRM and automation system.

Now, whenever a tag like **“Hot Lead”** is added:

* The lead is instantly marked as high priority
* Assigned to a senior sales agent
* A follow-up task is created immediately
* The lead is added to a high-intent campaign

**The Result**

* Faster response to high-intent leads
* Improved conversion rates
* Better lead management
* No missed opportunities

***

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

The **Tag Added Webhook** transforms simple tagging into real-time action.

Instead of just organizing conversations, you can now:

* Automate workflows instantly
* Prioritize the right customers
* Improve response time
* Scale your operations efficiently

Set it up once — and every tag starts working for you.