WhatsApp API میسج ڈیلیور نہیں ہوا: وجوہات، ترتیب وار
وہ میسج جسے WhatsApp API نے قبول کیا ہو، ضروری نہیں کہ ڈیلیور ہو چکا ہو: Meta نتیجہ بعد میں اسٹیٹس ویب ہک کے ذریعے بتاتا ہے، یعنی sent، delivered، read یا failed، اور ناکامی کی صورت میں ایرر کوڈ۔ اسی ترتیب سے جانچیں: ناکام اسٹیٹس اور اس کا کوڈ، 24 گھنٹے کی ونڈو (131047)، ادائیگی کا طریقہ (131042)، ٹیمپلیٹ (132001، 132015)، وصول کنندہ (131026، 131049، 131050)، پھر نمبر کی حدیں اور کنکشن۔
easyCoexistence ہر جڑے ہوئے نمبر پر دن رات نظر رکھتا ہے، جب Meta ڈیلیوری روک دے، کنکشن ہٹا دے یا کوالٹی گر جائے تو آپ کو ای میل بھیجتا ہے، اور Meta کے اسٹیٹس ویب ہکس کو بغیر کسی تبدیلی کے آپ کے سسٹم تک پہنچاتا ہے۔
sent (ایک نشان)، delivered (دو نشان)، read (دو نیلے نشان) اور failed (سرخ ایرر تکون)، جیسا کہ اسٹیٹس ویب ہکس انہیں ظاہر کرتے ہیں۔
وصول کنندہ کے آخری جواب کو 24 گھنٹے سے زیادہ ہو چکے ہیں؛ Meta کے مطابق اس صورت میں ٹیمپلیٹ بھیجیں۔
ڈیلیور نہ ہو سکا: نمبر WhatsApp پر موجود نہیں، وصول کنندہ نے نئی شرائط قبول نہیں کیں، یا پرانا WhatsApp ورژن چل رہا ہے۔
ڈیلیور نہ ہونے والے utility یا marketing ٹیمپلیٹ کی دوبارہ کوشش کی ڈیفالٹ مدت، جس کے بعد اسے چھوڑ دیا جاتا ہے؛ authentication ٹیمپلیٹس کا ڈیفالٹ 10 منٹ ہے۔
جو نمبر WhatsApp Business ایپ اور Cloud API دونوں میں استعمال ہو، اس کا تھروپٹ مقررہ ہوتا ہے۔
قبول شدہ میسج پھر بھی کیوں نہیں پہنچتا؟
کیونکہ API کا جواب اور ڈیلیوری دو الگ واقعات ہیں۔ بھیجتے وقت Meta درخواست قبول کرتے ہی میسج آئی ڈی واپس کر دیتا ہے؛ میسج گاہک کے فون تک پہنچا یا نہیں، یہ بعد میں messages فیلڈ پر اسٹیٹس ویب ہک میں آتا ہے۔ sent کا مطلب ہے کہ میسج Meta کے سرورز سے نکل گیا (ایک نشان)، delivered کا مطلب ڈیوائس تک پہنچ گیا (دو نشان)، read کا مطلب کھولا گیا (دو نیلے نشان)، اور failed کا مطلب بھیجا یا ڈیلیور نہیں کیا جا سکا، جو آپ کو errors array میں دکھائی دیتا ہے: کوڈ، ٹائٹل اور error_data.details۔ اس لیے پہلا قدم کبھی اندازہ لگانا نہیں: اس میسج آئی ڈی کا failed اسٹیٹس تلاش کریں اور اس کا کوڈ پڑھیں۔ اگر آپ کی کوئی ویب ہک منزل نہیں، تو کچھ بھی ریکارڈ نہیں ہوتا۔
وجوہات کون سی ہیں، جانچنے کی ترتیب میں؟
نئے جڑے ہوئے نمبر پر سب سے عام سے لے کر سب سے نادر تک۔ ہر لائن میں Meta کا کوڈ درج ہے، تاکہ ناکام اسٹیٹس سے پتا چلے کہ آپ کس صورت میں ہیں:
- ونڈو بند: 131047، آخری بار گاہک کے لکھنے کے بعد 24 گھنٹے سے زیادہ ہو چکے ہیں۔ آزاد متن کے لیے کھلی ونڈو درکار ہے؛ ٹیمپلیٹ بھیجیں۔
- ادائیگی: 131042، یا ٹیمپلیٹس خاموشی سے ڈراپ ہو جاتے ہیں۔ 1 اکتوبر 2026 سے سروس میسجز بھی رک جاتے ہیں، جب ادائیگی کے طریقے کے بغیر ماہ میں 1,000 استعمال ہو جائیں۔
- ٹیمپلیٹ: 132001 منظور نہیں یا زبان غلط، 132000 متغیرات کی تعداد غلط، 132012 فارمیٹ غلط، 132015 روکا گیا، 132016 غیر فعال۔
- وصول کنندہ: 131026 WhatsApp پر موجود نہیں، پرانا ورژن یا شرائط قبول نہیں؛ 131050 مارکیٹنگ میسجز بند کر دیے گئے؛ 131049 صحت مند انگیجمنٹ کے لیے روکا گیا؛ امریکی نمبروں پر مارکیٹنگ ٹیمپلیٹس ڈیلیور نہیں ہوتے۔
- حدیں: 131048 اسپیم سگنلز کے بعد محدود؛ 131056 ایک شخص کو بہت زیادہ میسجز؛ 130429 تھروپٹ؛ Coexistence نمبر پر فی سیکنڈ 20 میسجز۔
- اکاؤنٹ: 131031 یا 368، یعنی پالیسی کی خلاف ورزی پر WhatsApp Business اکاؤنٹ محدود یا غیر فعال۔
- کنکشن: نمبر اب منسلک نہیں رہا، مثلاً WhatsApp Business ایپ کھولے بغیر 14 دن گزرنے کے بعد۔
وصول کنندہ کی طرف کے کوڈز کو کیسے سنبھالیں؟
مختلف طریقے سے، کیونکہ کچھ کو دوبارہ کوشش کا حق ہے اور کچھ کو کبھی نہیں۔ 131050 کا مطلب ہے کہ شخص نے آپ کے مارکیٹنگ میسجز بند کرنے کا فیصلہ کیا: Meta کہتا ہے دوبارہ کوشش نہ کریں، اور user_preferences ویب ہک بتاتا ہے کہ کب بند یا دوبارہ شروع ہوئے۔ 131049 وہ صورت ہے جب Meta صحت مند انگیجمنٹ برقرار رکھنے کے لیے مارکیٹنگ میسج روکتا ہے، اکثر مارکیٹنگ ٹیمپلیٹس پر فی صارف حد کی وجہ سے؛ Meta کے مطابق دوبارہ بھیجنے سے پہلے کم از کم 24 گھنٹے انتظار کریں، کیونکہ جلدی بھیجنے سے وہی ایرر لوٹ آتا ہے۔ 131026 ان نمبروں کو کور کرتا ہے جو WhatsApp پر نہیں، ان صارفین کو جنہوں نے WhatsApp کی موجودہ شرائط قبول نہیں کیں، اور بہت پرانے ایپ ورژن؛ پہلے نمبر کا فارمیٹ اور کنٹری کوڈ چیک کریں، پھر گاہک سے کسی دوسرے چینل پر رابطہ کریں۔
WhatsApp ڈیلیوری کی کوشش کب تک کرتا ہے؟
میسج کے TTL (time to live) تک۔ جب فون بند ہو یا رینج سے باہر ہو، WhatsApp فوراً ناکام قرار دینے کے بجائے دوبارہ کوشش کرتا رہتا ہے: utility اور marketing ٹیمپلیٹس پر ڈیفالٹ 30 دن، اور authentication ٹیمپلیٹس پر 10 منٹ۔ کاروبار ہر ٹیمپلیٹ کے لیے message_send_ttl_seconds سے اسے کم کر سکتا ہے، utility کے لیے 30 سیکنڈ سے 12 گھنٹے تک، اور authentication کے لیے 30 سیکنڈ سے 15 منٹ تک۔ جو میسج اپنی TTL کے اندر ڈیلیور نہ ہو، اسے چھوڑ دیا جاتا ہے۔ لہٰذا وہ میسج جس کا sent اسٹیٹس ہو اور گھنٹوں بعد بھی delivered نہ ہو، عموماً گاہک کے فون پر انتظار میں ہوتا ہے، گم نہیں ہوا؛ کوڈز اور وقت سے حساس الرٹس کے لیے چھوٹا TTL رکھیں تاکہ دیر سے ڈیلیوری کسی کو الجھن میں نہ ڈالے۔
یہ AI جوابات اور آٹومیشنز کے لیے کیا معنی رکھتا ہے؟
پہلے رن دیکھیں، پھر اسٹیٹس۔ Runs ٹیب میں Skipped رن کچھ نہیں بھیجتا اور وجہ بتاتا ہے: “گاہک کے آخری میسج کے بعد 24 گھنٹے سے زیادہ گزر چکے ہیں”، “آپ نے حال ہی میں اپنے فون سے اس چیٹ کا جواب دیا تھا”، یا “اس گھنٹے میں اس چیٹ کے لیے AI جواب کی حد پوری ہو گئی”۔ Done رن کا مطلب ہے Meta نے ہر جواب قبول کیا، جو ڈیلیوری کا ثبوت نہیں۔ easyCoexistence میسج اسٹیٹسز ذخیرہ نہیں کرتا: آٹومیشنز آن ہوں تو، اگر آپ URL مقرر کریں، وہ آپ کے forward URL تک پہنچتے ہیں، اور ڈائریکٹ موڈ میں وہ سیدھے آپ کے اپنے اینڈ پوائنٹ پر جاتے ہیں۔ ChatGPT یا Claude سے اپنے AI کو کہیں کہ get_number_health چلائے: یہ لائیو اسٹیٹس، کوالٹی ریٹنگ اور آخری 15 مانیٹرنگ ایونٹس واپس کرتا ہے، جن میں Meta کے کوڈ کے ساتھ sending بلاک بھی شامل ہے۔
اسے کیسے سیٹ اپ کریں
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
عام غلطیاں
- 131050 پر دوبارہ کوشش کرنا: شخص نے آپ کے مارکیٹنگ میسجز بند کر دیے ہیں؛ مزید کوششیں کبھی ڈیلیور نہیں ہوتیں اور صرف منفی سگنلز بڑھاتی ہیں۔
- میسج آئی ڈی کو ڈیلیور شدہ سمجھنا: Meta پہلے قبول کرتا ہے اور ناکامیاں بعد میں بتاتا ہے، لہٰذا وہ ورک فلو جو آئی ڈی پر رک جاتا ہے، ہر مسترد شدہ میسج سے محروم رہتا ہے۔
- ایک دن بعد آزاد متن والا جواب بھیجنا: گاہک کا میسج نہ آنے کے 24 گھنٹے بعد صرف ٹیمپلیٹ قبول ہوتا ہے۔
- ویب ہک منزل کے بغیر چلانا: ناکام اسٹیٹسز صرف ویب ہکس کے ذریعے آتے ہیں، اس لیے اس کے بغیر یہ وجہ کھو جاتی ہے کہ میسج کیوں نہیں پہنچا۔
آپ کا AI ChatGPT یا Claude سے get_number_health کے ذریعے کسی بھی نمبر کی جانچ کر سکتا ہے۔ فی نمبر فی ماہ US$ 9 سے US$ 0.75 تک، نمبرز بڑھانے کے ساتھ قیمت کم ہوتی جاتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
میسج کئی گھنٹوں تک ایک ٹک کیوں دکھاتا ہے؟
ایک ٹک sent اسٹیٹس ہے: Meta نے بھیج دیا، لیکن فون نے وصول نہیں کیا، عموماً اس لیے کہ وہ بند ہے یا آف لائن۔ WhatsApp TTL ختم ہونے تک دوبارہ کوشش کرتا رہتا ہے، utility اور marketing کے لیے ڈیفالٹ 30 دن۔
جوابات تو آ جاتے ہیں، ٹیمپلیٹس کیوں نہیں؟
عموماً WhatsApp Business اکاؤنٹ پر ادائیگی کے طریقے کا مسئلہ۔ Meta سروس میسجز کو نمبر کی ماہانہ مفت حد کے اندر بغیر اس کے ڈیلیور کرتا ہے، لیکن ٹیمپلیٹس نہیں۔ Billing & payments میں کارڈ شامل کریں۔
کیا WhatsApp Business ایپ میں ناکام میسجز دیکھے جا سکتے ہیں؟
قابلِ اعتماد نہیں۔ Coexistence نمبر پر API سے بھیجے گئے میسجز ایپ کی چیٹ تھریڈ میں نظر آتے ہیں، لیکن میسج کیوں ناکام ہوا، یہ وجہ صرف اسٹیٹس ویب ہک کے ایرر کوڈ میں آتی ہے۔
کیا Meta ان میسجز کا چارج لیتا ہے جو ڈیلیور نہ ہوئے؟
نہیں۔ Meta صرف ڈیلیور شدہ میسجز کا چارج لیتا ہے، اور روکے گئے ٹیمپلیٹ کی کوششوں کا بھی چارج نہیں ہوتا۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ