لاگ اِن کریںفری ٹرائل شروع کریں
Meta Tech Provider

WhatsApp ویب ہک اسٹیٹس: sent، delivered، read اور failed

اسٹیٹس ویب ہکس بتاتے ہیں کہ کسی بزنس کے WhatsApp Cloud API کے ذریعے بھیجے گئے میسج کے ساتھ کیا ہوا۔ یہ messages فیلڈ پر آتے ہیں، مگر messages array کے بجائے statuses array کے ساتھ: sent (ایک ٹک)، delivered (دو ٹک)، read (دو نیلے ٹک)، وائس میسجز کے لیے played، اور failed کی صورت میں errors array شامل ہوتا ہے۔ statuses[].id کو اس wamid سے ملائیں جو آپ کی send درخواست نے واپس کیا۔

easyCoexistence آپ کے پہلے سے استعمال ہونے والے WhatsApp Business ایپ نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے۔

5

Meta جو اسٹیٹس ویلیوز بھیجتا ہے، وہ یہ ہیں: sent، delivered، read، played (وائس میسجز کا پہلا پلے) اور failed کی ویلیو۔

3

ایک آؤٹ گوئنگ میسج سے الگ الگ اسٹیٹس ویب ہکس بنتے ہیں: sent، delivered اور read کے لیے۔

v24.0

اس Graph API ورژن سے conversation آبجیکٹ حذف ہو جاتا ہے، سوائے free entry point window کے اندر کے میسجز کے۔

0

پچھلا ویب ہک ڈیٹا حاصل کرنے کے لیے کوئی APIs نہیں ہیں؛ Meta کہتا ہے کہ پے لوڈز کو آتے ہی محفوظ کریں۔

messages

X-EC-Event ہیڈر کسی فارورڈ کیے گئے اسٹیٹس پر: اسٹیٹسز messages events کے اندر value.statuses کے تحت سفر کرتے ہیں۔

WhatsApp اسٹیٹس ویب ہکس کہاں آتے ہیں؟

اسی messages فیلڈ پر، جو گاہک کے بھیجے گئے پیغامات لاتا ہے، اسی object، entry اور changes envelope میں۔ فرق value کے اندر ہے: انباؤنڈ میسج میں messages array ہوتا ہے، جبکہ اسٹیٹس میں statuses array ہوتا ہے۔ وہ ہینڈلر جو صرف value.messages پڑھتا ہے، بغیر کسی خرابی کے ہر اسٹیٹس کو ضائع کر دیتا ہے۔ metadata.phone_number_id بتاتا ہے کہ آپ کے کس نمبر نے میسج بھیجا، اور contacts array، جس میں گاہک کا پروفائل نام، wa_id اور BSUID ہوتا ہے، ساتھ آتا ہے، سوائے failed اسٹیٹسز اور گروپ میسجز کے sent اسٹیٹس کے۔ یہ Meta کی اپنی مثال ہے، جس میں ایک مارکیٹنگ ٹیمپلیٹ Meta کے سرورز سے روانہ ہوتا ہے:

Meta's example: a marketing message with status sent
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Pablo M."
                },
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918"
              }
            ],
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
                "status": "sent",
                "timestamp": "1750030073",
                "recipient_id": "16505551234",
                "recipient_user_id": "US.13491208655302741918",
                "conversation": {
                  "id": "72b14d6bd5407799e66f64d1b338e567",
                  "expiration_timestamp": "1750116480",
                  "origin": {
                    "type": "marketing"
                  }
                },
                "pricing": {
                  "billable": true,
                  "pricing_model": "PMP",
                  "type": "regular",
                  "category": "marketing"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

ہر اسٹیٹس ویلیو کا کیا مطلب ہے؟

ہر ویلیو اس نشان سے مماثل ہے جو گاہک WhatsApp میں دیکھتا ہے۔ اسٹیٹس read اسی وقت شمار ہوتا ہے جب میسج delivered ہو چکا ہو، اور جب گاہک کو میسج اس وقت ملتا ہے جب چیٹ پہلے سے کھلی ہو، تو Meta اندرونی آپٹمائزیشن کے طور پر پہلے delivered ویب ہک بھیجے بغیر read بھیجتا ہے۔ اس لیے ٹریکر کو read قبول کرنا چاہیے، چاہے delivered کبھی نہ آیا ہو، اور اسٹیٹسز کو ایک مقررہ ترتیب میں ایک ایک کر کے توقع کرنے کے بجائے ان کی درجہ بندی کرنی چاہیے۔

sentLeft Meta's servers. One gray check in WhatsApp.
deliveredReached the customer's device. Two gray checks.
readDisplayed in an open chat on the device. Two blue checks.
playedFirst play of voice messages. Blue microphone.
failedCould not be sent or delivered. Red error triangle, plus an errors array.

اسٹیٹس آبجیکٹ میں کون سے فیلڈز ہوتے ہیں؟

ایک message سے کم، اور کئی شرطی ہیں۔ Meta کا ریفرنس بتاتا ہے کہ ہر ایک کب موجود ہوتا ہے:

  • id: وہ wamid جو آپ کے بھیجے گئے میسج کا ہے، وہ کلید جس پر مماثلت ہوتی ہے۔
  • status اور timestamp: ویلیو، اور وہ Unix وقت جب ویب ہک چلا، سٹرنگ کی صورت میں۔
  • recipient_id: فون نمبر یا گروپ آئی ڈی، جو اس وقت نہیں ہوتا جب آپ نے BSUID پر بھیجا ہو اور نمبر دستیاب نہ ہو۔
  • recipient_user_id: گاہک کا BSUID، جو failed اسٹیٹس پر نہیں ہوتا جب آپ نے فون نمبر پر بھیجا ہو۔
  • recipient_type اور recipient_participant_id: صرف گروپ میں بھیجے گئے میسجز کے لیے۔
  • biz_opaque_callback_data: صرف تب جب آپ نے اسے send درخواست میں سیٹ کیا ہو۔
  • pricing: صرف sent پر، اور delivered یا read میں سے کسی ایک پر۔ errors: صرف وہاں جہاں اسٹیٹس failed ہو۔

اسٹیٹس کو اس میسج سے کیسے ملایا جاتا ہے جو آپ نے بھیجا تھا؟

wamid کے ذریعے۔ send درخواست messages[0].id واپس کرتی ہے، اور اس میسج کے ہر اسٹیٹس میں statuses[].id میں وہی ویلیو ہوتی ہے۔ بھیجتے وقت اسے اپنے ریکارڈ کے ساتھ محفوظ کریں، اور پھر اسٹیٹسز آنے پر ریکارڈ اپڈیٹ کریں، اور سب سے اونچا پہنچا ہوا اسٹیٹس رکھیں، تاکہ دیر سے آنے والا delivered، read کو اوور رائٹ نہ کرے۔ جس wamid کو آپ نہیں جانتے، اس کا اسٹیٹس نمبر پر کسی اور چیز، جیسے آٹومیشن، نے بھیجا ہوتا ہے، اور اسے نظرانداز یا لاگ کیا جا سکتا ہے۔

statuses.mjs: apply status webhooks to your sends (Node.js)
// statuses.mjs: apply Meta status webhooks to the messages your system sent
const RANK = { sent: 1, delivered: 2, read: 3, played: 4 };

// value: change.value of a "messages" webhook; sends: Map of wamid -> your record
export function applyStatuses(value, sends) {
  for (const s of value.statuses ?? []) {
    const rec = sends.get(s.id); // the wamid your send request returned
    if (!rec) continue; // sent by something else, such as an automation
    if (s.status === "failed") {
      rec.status = "failed";
      rec.error = s.errors?.[0]?.code; // for example 131049, 131050 or 131026
    } else if ((RANK[s.status] ?? 0) > (RANK[rec.status] ?? 0)) {
      rec.status = s.status; // read arriving before delivered is fine; never step back
    }
    rec.updatedAt = Math.max(rec.updatedAt ?? 0, Number(s.timestamp));
  }
}

Coexistence نمبر پر کیا بدلتا ہے؟

اسٹیٹسز وہ بیان کرتے ہیں جو API کے ذریعے بھیجا گیا: آپ کی آٹومیشنز کے جوابات، وہ میسجز جو آپ کے AI نے MCP کنیکٹر کے ذریعے بھیجے، اور وہ سب کچھ جو آپ کا اپنا کوڈ بھیجے۔ مالک WhatsApp Business ایپ میں جو ٹائپ کرتا ہے وہ سافٹ ویئر تک مختلف طریقے سے پہنچتا ہے، smb_message_echoes کے طور پر، جسے Meta ایپ سے بھیجے گئے میسجز کا آئینہ قرار دیتا ہے۔ ایک بار کی ہسٹری امپورٹ میں آنے والے میسجز اپنا اسٹیٹس ہسٹری ویب ہک کے اندر رکھتے ہیں، جن کی ویلیوز میں delivered، read، played، pending اور error شامل ہیں۔

اسٹیٹسز وہیں جاتے ہیں جہاں نمبر کا messages فیلڈ جاتا ہے۔ direct destination کے ساتھ، Meta انہیں براہِ راست آپ کے اینڈ پوائنٹ پر بھیجتا ہے، کیونکہ messages وہ فیلڈ ہے جسے Meta destination سے بدلنے دیتا ہے۔ آٹومیشنز آن ہوں اور Forward URL سیٹ ہو تو وہ اسی URL پر messages events کی صورت میں پہنچتے ہیں۔

آپ کا AI یا آٹومیشن کیسے جانتا ہے کہ میسج ڈیلیور ہوا؟

آپ کے destination کے ذریعے، send کے ذریعے نہیں۔ جب کوئی assistant send_template یا send_message کال کرتا ہے، تو ٹول کے نتیجے میں wamid آتا ہے اور بتایا جاتا ہے کہ Meta نے میسج قبول کر لیا؛ ڈیلیوری بعد میں گاہک کے آلے پر تصدیق ہوتی ہے اور اسٹیٹس کے طور پر رپورٹ ہوتی ہے۔ easyCoexistence کے پاس کوئی اسٹیٹس ہسٹری نہیں جسے کیوری کیا جا سکے، اور کوئی MCP ٹول اسٹیٹسز نہیں پڑھتا، اس لیے جس ایجنٹ کو ڈیلیوری کی تصدیق درکار ہو اسے اپنے سسٹم کے ذریعے بھیجنا چاہیے، یا وہ اسٹیٹسز پڑھے جو آپ کا Forward URL وصول کرتا ہے۔

یہی آٹومیشنز پر بھی لاگو ہوتا ہے: Runs ٹیب میں ایک رن میں ریپلائی کا مرحلہ اس وقت مکمل دکھائی دیتا ہے جب Meta میسج قبول کر لے، اور بعد میں رپورٹ ہونے والی ناکامی آپ کے destination پر صرف failed اسٹیٹس کے طور پر ظاہر ہوتی ہے۔

عام غلطیاں

  • علیحدہ statuses فیلڈ تلاش کرنا۔ اسٹیٹسز messages پر آتے ہیں، اس لیے جو ہینڈلر صرف value.messages پڑھتا ہے وہ انہیں بغیر کسی خرابی کے کھو دیتا ہے۔
  • read سے پہلے delivered کا تقاضا کرنا۔ جب میسج آتے ہی پڑھ لیا جائے تو Meta delivered ویب ہک چھوڑ دیتا ہے۔
  • send ردعمل کو ڈیلیوری سمجھنا۔ wamid کا مطلب ہے Meta نے درخواست قبول کی؛ ناکامی منٹوں بعد failed اسٹیٹس کے طور پر آ سکتی ہے۔
  • گاہکوں کی شناخت صرف recipient_id پر کرنا۔ یہ اس وقت نہیں ہوتا جب آپ نے BSUID پر بھیجا ہو اور فون نمبر دستیاب نہ ہو؛ BSUID recipient_user_id میں ہوتا ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

آپ کی آٹومیشنز، AI یا کوڈ کے بھیجے گئے میسجز کے اسٹیٹسز آپ کے سرور تک جاتے ہیں: direct mode میں براہِ راست Meta سے، یا آٹومیشنز آن ہونے پر آپ کے Forward URL پر فارورڈ ہو کر، X-EC-Signature سے دستخط شدہ، اور وہ بطورِ ڈیفالٹ محفوظ نہیں ہوتے۔ فی نمبر فی ماہ US$ 9 سے US$ 0.75 تک، نمبر بڑھانے کے ساتھ قیمت کم ہوتی جاتی ہے، پہلے 3 دن فری۔

اکثر پوچھے جانے والے سوالات

کیا اسٹیٹس ویب ہکس میں میسج کا متن شامل ہوتا ہے؟

نہیں۔ ایک اسٹیٹس میں wamid، اسٹیٹس، recipient، timestamps اور جہاں لاگو ہو وہاں pricing اور errors ہوتے ہیں۔ اگر آپ کو اسٹیٹس کے ساتھ دکھانا ہو تو جو بھیجا تھا اس کی اپنی کاپی wamid کی کلید کے ساتھ رکھیں۔

کیا میں بعد میں Meta سے پچھلے اسٹیٹسز حاصل کر سکتا ہوں؟

نہیں۔ Meta کی ویب ہک گائیڈ کہتی ہے کہ تاریخی ویب ہک ڈیٹا حاصل کرنے کے لیے کوئی APIs نہیں ہیں، لہٰذا جو اسٹیٹس آپ کا اینڈ پوائنٹ محفوظ نہ کر سکا، وہ Meta کی دوبارہ کوشش روکنے کے بعد، جو 7 دن تک ہو سکتی ہے، ضائع ہو جاتا ہے۔

biz_opaque_callback_data کس کام آتا ہے؟

یہ ایک سٹرنگ ہے جو آپ بھیجتے وقت سیٹ کرتے ہیں، جیسے اپنا آرڈر یا ٹکٹ آئی ڈی۔ Meta اسے اس میسج کے statuses میں واپس کرتا ہے، تاکہ آپ wamid تلاش کیے بغیر اسٹیٹس کو اپنے ریکارڈ سے ملا سکیں۔

کیا مجھے اسٹیٹس ویب ہکس کا جواب 200 سے دینا ہوگا؟

ہاں، کسی بھی ویب ہک POST کی طرح۔ Meta کسی اور ردعمل کو ناکام ڈیلیوری سمجھتا ہے اور دوبارہ کوشش کرتا ہے، اور اسی وجہ سے ایک ہی اسٹیٹس دو بار پہنچ سکتا ہے۔

مزید پڑھیں

WhatsApp میسج کیوں ناکام ہوا: failed اسٹیٹس اور errors پڑھناfailed اسٹیٹس کا مطلب ہے کہ Meta آپ کا WhatsApp میسج بھیج یا پہنچا نہیں سکا۔ errors اور ایرر کوڈ 131047، 131049، 131050 پڑھیں اور جانیں کہ کیا کرنا ہے۔WhatsApp ویب ہک پرائسنگ آبجیکٹ: type، category اور billable (2026)WhatsApp اسٹیٹس ویب ہکس کا پرائسنگ آبجیکٹ بتاتا ہے کہ Meta نے ہر میسج کو کیسے درجہ بند کیا، اور چارجز کیسے گنیں۔WhatsApp ویب ہک کی دوبارہ کوششیں، ڈپلیکیٹس اور ترتیب: انہیں کیسے سنبھالیںMeta ویب ہک کو 7 دن تک دوبارہ کوشش کرتا ہے، اس لیے ڈپلیکیٹ معمول ہیں اور ترتیب کی ضمانت نہیں۔ ڈپلیکیٹ ہٹانے کی کلیدیں، محفوظ ہینڈلر اور جواب دینے کا طریقہ۔واٹس ایپ کالز ویب ہک: Calling API ایونٹس، اور Coexistence نمبر پر کالزکالز ویب ہک فیلڈ WhatsApp Calling API کے ایونٹس بتاتی ہے: کنیکٹ، ٹرمینیٹ، کال اسٹیٹسز اور ریکارڈنگ۔ اصل پے لوڈ، اور Coexistence نمبروں پر کیا لاگو ہوتا ہے۔WhatsApp پیغام آپ کے سرور تک کیسے پہنچتے ہیں: ڈائریکٹ یا مینیج، اور دستخط کی تصدیقڈائریکٹ: Meta آپ کے سرور پر پوسٹ کرتا ہے۔ مینیج: آٹومیشنز جواب دیتی ہیں، اور دستخط شدہ کاپی Forward URL پر جاتی ہے۔ X-EC-Signature، پے لوڈ، دوبارہ کوششیں۔WhatsApp یوزر نیمز اور کاروبار کے دائرے میں صارف آئی ڈیز (BSUID): کلاؤڈ API ویب ہکس میں کیا بدلتا ہےWhatsApp یوزر نیمز کلاؤڈ API ویب ہکس کو کیسے بدلتے ہیں: user_id میں BSUID، wa_id اور from کب ہٹتے ہیں، recipient سے جواب، اور Coexistence کی تبدیلیاں۔

شروع کرنے کے لیے تیار ہیں؟

WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔

فری ٹرائل شروع کریں

تصدیق شدہ تاریخ