How to Use the Instagram Message Status Update Webhook

Know the Moment Your Instagram Message Is Delivered or Read — in Real Time

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.

---

When Does This Webhook Trigger?

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

---

Step-by-Step Setup Guide

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.

---

How to Test It

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

---

What Data Do You Receive?

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

---

Instagram Message Status Update Webhook – Sample Payload

{
  "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"
}

---

Summary

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.