# 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="/files/MpDSI8HnLqSACbWkG58u" 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.


---

# 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-tag-added-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.