WhatChimp API ke through Message Delivery Status hasil karein

Track karein ki aapke messages send hue, deliver hue, read hue ya fail hue.

Updated 5 February 2026

Track karein ki aapke messages send hue, deliver hue, read hue ya fail hue — aur pata lagayein ki message kyun nahi gaya.

Shuru karne se pehle: Ensure karein ki aapke paas aapki API key aur phone number ID hai. Setup instructions ke liye Getting Started with WhatChimp Developer API dekhein.

Endpoint

GET/POST /api/v1/whatsapp/get/message-status

https://app.whatchimp.com/api/v1/whatsapp/get/message-status

Parameters

Parameter	Type	Required	Description
`apiToken`	String	Haan	Aapki WhatChimp API key
`wa_message_id`	String	Haan	WhatsApp message ID (jab aapne message bheja tha tab return hua)
`whatsapp_bot_id`	Number	Haan	Aapki WhatsApp bot ID

wa_message_id kahan se milega? WhatChimp API ke through har successful send response me wa_message_id return karta hai. Is value ko save karein delivery status check karne ke liye baad me.

whatsapp_bot_id kahan se milega? User Info endpoint call karein (GET /user/myInfo) — yeh aapka whatsapp_bots_details array return karega bot IDs ke saath.

Request Examples

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/message-status?apiToken=API-KEY&wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=&whatsapp_bot_id=123

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/message-status' \
  -d 'apiToken=API-KEY' \
  -d 'wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=' \
  -d 'whatsapp_bot_id=123'

Message Delivery Status endpoint showing parameters and response in the API console

Response

{
  "status": "1",
  "message": {
    "message_status": "delivered",
    "delivery_status_updated_at": "2024-07-28 13:21:03",
    "read_time": null,
    "failed_time": null,
    "failed_reason": ""
  }
}

Delivery Status Values

Status	Matlab
`sent`	Message WhatsApp servers ko send ho gaya — delivery ke liye wait kar raha hai
`delivered`	Message recipient ke device par deliver ho gaya
`read`	Message recipient ne read kar liya (blue ticks)
`failed`	Message deliver nahi ho paya — details ke liye `failed_reason` check karein

Response Fields

Field	Description
`message_status`	Current delivery status (upar table dekhein)
`delivery_status_updated_at`	Jab status last update hua uska timestamp
`read_time`	Jab message read hua (null agar abhi read nahi hua)
`failed_time`	Jab failure hui (null agar fail nahi hua)
`failed_reason`	Agar message fail hua to error description

Common Failure Reasons

Reason	Matlab Kya Hai	Fix
Phone number not on WhatsApp	Recipient ka number WhatsApp par registered nahi hai	Verify karein ki number correct hai aur WhatsApp par active hai
Template not approved	Template reject ho gaya ya abhi pending hai	Bot Manager > Message Template me template status check karein
Rate limit exceeded	Bahut jyada messages short time me bheje gaye	Apni send rate slow karein, apni messaging tier check karein
Invalid phone number format	Number ka format incorrect hai	Country code use karein bina `+` sign ke (e.g., `919999999999`)

Use Cases

Delivery receipts — Messages deliver hue confirm karein apne workflow me next action lene se pehle
Read tracking — Jaan lein jab customer ne aapka message dekh liya
Error handling — Failed messages detect karein aur retries ya alerts trigger karein
SLA monitoring — Time-sensitive messages jaise OTPs ke liye delivery times track karein

Get Conversation History via WhatChimp API — Subscriber ke saath pura conversation retrieve karein
Send Template Messages via WhatChimp API — Template messages bhejein (wo wa_message_id return karta hai jo aapko chahiye)
Getting Started with WhatChimp Developer API — API setup aur authentication