# How to Configure and Register a Webhook

Webhooks allow DoubleTick to send real-time data to your systems whenever an event happens — for example, when a message is sent, delivered, read, or failed. Many businesses use webhooks to automate workflows, push updates to CRM systems, store event logs, trigger notifications, or hand off data to other tools.

In this guide, we will walk you through the complete process of:

1. Generating a webhook from Bot Studio
2. Registering it using the DoubleTick API Docs
3. Testing and confirming that the webhook works

This article assumes you're using DoubleTick for the first time and provides slow and clear instructions so you can follow along confidently.

***

### **What You Will Need**

Before you begin, make sure you have:

✔ A DoubleTick account with Bot Studio access\
✔ A valid WABA (WhatsApp Business) number\
✔ Access to Postman (or any REST API testing tool)

No coding knowledge is required.

***

### **Step 1: Generate Webhook Credentials in Bot Studio**

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FgHQi8Kr2csBdf9ZLSsWM%2FUntitled%20design%20(8).gif?alt=media&#x26;token=83a73f4b-8ec3-425f-a6e6-7279c1875706" alt=""><figcaption></figcaption></figure>

1. Open the **Bot Studio** on DoubleTick.
2. Drag the block called **“On Webhook Trigger”** onto the workflow canvas.
3. As soon as you add it, DoubleTick will generate:
   * A **Webhook URL**
   * An **Authorization Key**

These two values are very important because:

* The **Webhook URL** tells DoubleTick *where* to send the data
* The **Authorization Key** ensures only allowed systems can access the webhook

👉 **Copy both** — we will use them in the registration step.

***

### **Step 2: Go to Webhook Registration Page**

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F3O3UPLB9zlDZUOXllsnI%2FUntitled%20design%20(9).gif?alt=media&#x26;token=da745843-9791-49e5-a61f-fd903b10c3f6" alt=""><figcaption></figcaption></figure>

1. Open the link: <https://docs.doubletick.io/reference/register-webhook>
2. Click on **“Register a New Webhook”**

Here, we are telling DoubleTick what webhook we want to use, for which WABA number, and what kind of events we want to receive.

***

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FfnWL8l9iaBFPtRExeHGi%2FUntitled%20design%20(10).gif?alt=media&#x26;token=231f22da-49e3-457b-b013-0e9ba19184df" alt=""><figcaption></figcaption></figure>

### **Step 3: Paste the Webhook URL**

1. In the request body, find the field named **URL**
2. Paste the Webhook URL copied from Bot Studio

Normally the method here will be `POST`, so make sure it is set correctly.

### **Step 4: Add Authorization Header (Required)**

This step is important because DoubleTick will not send sensitive data to an unsecured system.

1. Go to the **Headers** section
2. Click **Add New Header**
3. Enter the following:

**Key:**

```
Authorization
```

**Value:**\
Paste the Authorization Key from Bot Studio

✔ This allows secure transmission of webhook data\
✔ Prevents unauthorized access

***

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FAGFFpQs7IdElKnKi9LRT%2FUntitled%20design%20(11).gif?alt=media&#x26;token=b41531c4-670e-407a-90a1-87b251a0056b" alt=""><figcaption></figcaption></figure>

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

Under **Webhook Event**, you can choose what type of data you want to receive.

Example:\
`message_status_update` → sends events whenever message delivery status changes

Other events may include:

* message received
* message sent
* template status update
* message delivered
* message read

Choose the event that matches your use case.

### **Step 6: Enter WABA Number & Name**

1. Enter your **WABA Number** in international format\
   Example: `+91XXXXXXXXXX`
2. Optionally, give the webhook a **Name** such as:

   ```
   test_ctwa_new_6
   ```

Naming webhooks helps if you manage multiple business numbers or workflows.

***

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F7G3xbWvfENT1axqpiPk5%2FUntitled%20design%20(12).gif?alt=media&#x26;token=cbefb511-a553-4132-8a6f-8ff3df7b1c2b" alt=""><figcaption></figcaption></figure>

### **Step 7: Generate and Copy the cURL Command**

Once all details are filled:

1. Click **Generate cURL**
2. Copy the cURL command that appears on screen

This command is what we will use to register the webhook via Postman.

### **Step 8: Import cURL into Postman**

1. Open the **Postman** application
2. Click on **Import**
3. Paste the cURL command in the import box
4. Click **Continue**

Postman will now create a new request based on the cURL and show you the body, headers, and endpoint.

### **Step 9: Adjust Authorization in Postman**

Postman often adds **Basic Authorization** automatically, but DoubleTick does not require this for webhook registration.

So:

1. Go to **Authorization** tab
2. Remove **Basic Auth**
3. Do not add anything else here — the Authorization Key in headers is enough

### **Step 10: Test the Webhook Registration**

Click **Send**

If everything is correct, you should receive:

```
200 OK
```

This means the webhook has been successfully registered.

***

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2Fhw7GzPAyojQXRo2LFTm1%2FUntitled%20design%20(13).gif?alt=media&#x26;token=46a1271c-95e5-4691-a157-27fd912db970" alt=""><figcaption></figcaption></figure>

### **Step 11: Verify the Webhook in DoubleTick**

To confirm it is active:

1. Go to **DoubleTick**
2. Open **Settings → Webhooks**
3. Look for the webhook name you created\
   Example: `test_ctwa_new_6`

If it appears, your setup is complete.

***

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FzQYVe6ipP1UoTVWmh5RV%2FUntitled%20design%20(16).gif?alt=media&#x26;token=82a26579-9446-4c34-aa33-9c99add43ee9" alt=""><figcaption></figcaption></figure>

### **Step 12: Trigger the Webhook (Test Event)**

Since in our example we used `message_status_update`, the webhook will be triggered when message delivery status changes.

To test:

1. Open any chat in DoubleTick
2. Send a test message
3. Wait until message receives status ticks\
   Example:
   * Sent
   * Delivered
   * Read

When the status updates, DoubleTick will send data to your webhook.

4. In Bot Studio, click **Capture Response**

You should now see structured JSON data appear.

***

### **What You Can Do Next**

Once the webhook data is captured, you can:

✔ Trigger automation\
✔ Build conditions\
✔ Push data to CRMs\
✔ Log delivery events\
✔ Notify internal systems\
✔ Connect with 3rd party tools

This is where webhook-based automation becomes powerful.

***

### **Why Webhooks Are Useful for Businesses**

Webhooks help automate workflows such as:

* Updating lead stages
* Notifying sales teams
* Tracking message success
* Measuring campaign performance
* Storing delivery logs
* Triggering workflows in Bot Studio

Without webhooks, these tasks must be done manually.

***
