> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/webhooks/how-to-use-the-instagram-message-status-update-webhook.md).

# How to Use the Instagram Message Status Update Webhook

You send a message to a customer on Instagram. But did they receive it? Did they read it? Without real-time status updates, your team is left guessing — and following up at the wrong time.

The Message Status Update webhook fires the moment the status of a message you sent changes — so your system always knows whether a message was delivered, read, or failed, the instant it happens.

**Note: This webhook is only available for organisations that have an Instagram channel connected in DoubleTick.**

***

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

This webhook fires every time the delivery or read status of an outbound message changes on your connected Instagram channel.

***

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

<figure><img src="/files/xaVfvOmKQ0fjeD1WpTtk" 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: Instagram Message Status Tracker

**Step 3: Get Your Webhook URL**

You need a destination URL — this is where DoubleTick will send the status update data each time a message status changes.

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. Enter the webhook name
3. Paste the webhook URL
4. Under Channel Type, select Instagram
5. Select your Instagram channel
6. Click Continue

**Step 5: Choose the Event**

1. Select Message Status Update from the event list
2. Click Save

Your webhook is now active.

***

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

1. Send a message to an Instagram customer from your connected DoubleTick account
2. Have the recipient open and read the message
3. Go to Bot → Capture Response → View Response Data
4. You will see the status update captured in real time

***

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

<table><thead><tr><th width="185.2000732421875">Field</th><th>What It Tells You</th></tr></thead><tbody><tr><td><strong>to</strong></td><td>The Instagram handle of the customer the message was sent to</td></tr><tr><td><strong>handle</strong></td><td>The Instagram handle of the customer — same as to</td></tr><tr><td><strong>status</strong></td><td>The current status of the message — for example, READ, DELIVERED, or FAILED</td></tr><tr><td><strong>messageId</strong></td><td>The unique ID of the message whose status changed</td></tr><tr><td><strong>channelType</strong></td><td>Will always be INSTAGRAM</td></tr><tr><td><strong>dtCustomerId</strong></td><td>DoubleTick's internal unique ID for this customer</td></tr><tr><td><strong>channelHandle</strong></td><td>The Instagram handle of your connected business account</td></tr><tr><td><strong>integrationType</strong></td><td>Will always be INSTAGRAM</td></tr><tr><td><strong>statusTimestamp</strong></td><td>The exact date and time the status change occurred</td></tr></tbody></table>

***

#### <mark style="color:$primary;">**Instagram Message Status Update Webhook – Sample Payload**</mark>

```json
{
  "to": "abhishxo",
  "handle": "abhishxo",
  "status": "READ",
  "messageId": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDAwMTU5Nzg3MDg2OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI1OTY3MTY4OTc5NTQ4MzU3MzozMjg2NDgyOTI5ODM2OTc4NzQ4NzE0NzIwNzI0MTQ5ODYyNAZDZD",
  "channelType": "INSTAGRAM",
  "dtCustomerId": "customer_Ehrc3Ls7kS",
  "channelHandle": "your_business_handle",
  "integrationType": "INSTAGRAM",
  "statusTimestamp": "2026-06-16T10:37:04.639Z"
}
```

***

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

The Instagram Message Status Update Webhook gives your team real-time visibility into whether your messages are being delivered and read. Set it up once, and every status change becomes a precise signal your system can use to time follow-ups, trigger reminders, and track engagement — automatically.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-instagram-message-status-update-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.