WhatsApp میسج کیوں ناکام ہوا: failed اسٹیٹس اور errors پڑھنا
failed ویب ہک کا مطلب ہے کہ Meta وہ میسج نہ بھیج سکا نہ پہنچا سکا جو کاروبار نے API کے ذریعے بھیجا تھا۔ یہ messages فیلڈ میں آتا ہے، جس میں status کی قدر failed ہوتی ہے اور errors array ہوتا ہے، جس میں code، title، message، error_data.details اور href شامل ہوتے ہیں۔ کوڈ وجہ بتاتا ہے: 131047 ونڈو بند، 131026 ناقابلِ ترسیل، 131049 مارکیٹنگ حد، 131050 مارکیٹنگ بند، 131042 ادائیگی کا مسئلہ۔
easyCoexistence آپ کا WhatsApp Business ایپ والا نمبر Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے، اور failed اسٹیٹسز کو براہ راست یا آٹومیشن فعال ہونے پر دستخط شدہ فارورڈز کے ذریعے آپ کے سرور تک پہنچاتا ہے۔
24 گھنٹے سے زیادہ گزر چکے ہیں جب وصول کنندہ نے آخری بار جواب دیا تھا؛ Meta کا حل یہ ہے کہ اس کے بجائے ٹیمپلیٹ بھیجیں۔
ایکو سسٹم میں صارفین کی دلچسپی صحت مند رکھنے کے لیے میسج پہنچایا نہیں گیا؛ مارکیٹنگ ٹیمپلیٹ دوبارہ بھیجنے سے پہلے کم از کم 24 گھنٹے انتظار کریں۔
وصول کنندہ نے کاروبار سے مارکیٹنگ میسج بند کرنے کا فیصلہ کیا ہے؛ Meta کہتا ہے دوبارہ کوشش نہ کریں۔
failed اسٹیٹس میں contacts array شامل نہیں ہوتا، اس لیے ناکامی کو statuses.id کے ذریعے ملائیں۔
Meta ان چیزوں کے پیسے لیتا ہے: میسج کا چارج تب لگتا ہے جب وہ پہنچ جائے، بھیجنے پر نہیں۔
failed اسٹیٹس کیسا دکھائی دیتا ہے؟
باقی اسٹیٹسز کی طرح، مگر ساتھ میں errors بھی ہوتا ہے۔ contacts array غائب ہوتا ہے، جب میسج فون نمبر پر بھیجا گیا ہو تو recipient_user_id شامل نہیں ہوتا، اور pricing object بھی نہیں ہوتا۔ title اور message ایک ہی متن رکھتے ہیں، error_data.details ایک جملے میں وضاحت کرتا ہے، اور href، Meta کی ایرر کوڈ فہرست کی طرف لے جاتا ہے۔ یہ Meta کی اپنی مثال ہے، ایک مارکیٹنگ ٹیمپلیٹ جو فی صارف حد کی وجہ سے رک گیا:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}سب سے زیادہ کون سے ایرر کوڈ آتے ہیں، اور ان کا کیا مطلب ہے؟
Meta ایرر کوڈ بھیجنے کے جواب میں، failed اسٹیٹس میں، یا دونوں جگہ بھیجتا ہے، اس لیے وہی کوڈ کسی بھی طرح پہنچ سکتا ہے، اور آپ کے ہینڈلر کو دونوں جگہ پڑھنا چاہیے۔ یہ وہ کوڈ ہیں جو زیادہ تر ایسے میسجز کی وجہ بتاتے ہیں جو کبھی نہیں پہنچتے، ساتھ میں Meta کی اپنی وجہ اور پہلا قدم جو آزمانا ہے؛ مکمل فہرست Meta کے ایرر کوڈ حوالہ میں ہے:
ہینڈلر ہر طرح کی ناکامی پر کیسا ردعمل دے؟
کسی بھی دوبارہ کوشش سے پہلے کوڈ کو طے کریں کہ اگلا قدم کیا ہے۔ ہر کوڈ پر بلا امتیاز دوبارہ کوشش کرنے سے مارکیٹنگ کی بندش بار بار ناکامی میں بدل جاتی ہے اور بلاک بڑھ سکتا ہے، جبکہ عارضی خرابی کو چھوڑ دینے سے وہ میسج ضائع ہو جاتا ہے جو ایک منٹ بعد پہنچ سکتا تھا۔
- وقفے کے ساتھ دوبارہ کوشش: 131000 نامعلوم، 131016 سروس دستیاب نہیں، 130429 تھرو پٹ کی حد پوری ہو گئی۔
- پہلے انتظار کریں: 131049، کم از کم 24 گھنٹے، کیونکہ جلدی دوبارہ کوشش سے اس صارف کو مزید 24 گھنٹے تک بلاک کیا جا سکتا ہے۔
- میسج بدلیں: 131047 کے لیے منظور شدہ ٹیمپلیٹ درکار ہے، کیونکہ 24 گھنٹے کی ونڈو بند ہے۔
- اس کسٹمر کے لیے رک جائیں: 131050، جب تک
user_preferencesکا resume موصول نہ ہو۔ - اکاؤنٹ یا مواد درست کریں: 131042 ادائیگی، 131031 اکاؤنٹ محدود، 131053 میڈیا۔
کون سی ناکامیاں صرف failed اسٹیٹس کے طور پر ظاہر ہوتی ہیں؟
وہ جو Meta درخواست قبول کرنے کے بعد طے کرتا ہے۔ بھیجنے کے عمل میں wamid واپس آتا ہے، اور انکار بعد میں اسی ویب ہک پر آتا ہے۔ Meta مارکیٹنگ ٹیمپلیٹ ایسے WhatsApp صارفین کو نہیں بھیجتا جن کے فون نمبر امریکہ کے ہوں (امریکی ایریا کوڈ کے ساتھ +1)، وہ مارکیٹنگ ٹیمپلیٹ جو ایسے کسٹمر کو بھیجا گیا جس نے مارکیٹنگ میسج بند کیے ہوں، پروسیس ہو کر 131050 کے ساتھ failed رپورٹ ہوتا ہے، اور فی صارف مارکیٹنگ حد 131049 کو اسی طرح رپورٹ کرتی ہے۔
اگر نمبر کا کوئی ویب ہک ڈیسٹینیشن نہ ہو تو یہ ناکامیاں کہیں نظر نہیں آتیں اور میسج بس بھیجا ہوا دکھائی دیتا ہے۔ جب کوئی کسٹمر کچھ وصول نہ کرے، تو جانچ کی مکمل ترتیب کے لیے WhatsApp API کے وہ میسج دیکھیں جو نہیں پہنچے۔
Coexistence نمبر پر کیا بدلتا ہے؟
دو باتیں اہم ہیں۔ پہلی، 24 گھنٹے کی ونڈو صرف API پر لاگو ہوتی ہے۔ Meta کی Coexistence گائیڈ کہتی ہے کہ WhatsApp Business ایپ سے بھیجے گئے میسجز کسٹمر سروس ونڈو کے تابع نہیں ہوتے، اس لیے 131047 کے بعد مالک فون سے اس کسٹمر کو جواب دے سکتا ہے، جبکہ آپ کا سسٹم منظور شدہ ٹیمپلیٹ بھیجتا ہے۔
دوسری، تھرو پٹ طے شدہ ہے۔ ایک نمبر جو ایپ اور API دونوں پر بیک وقت استعمال ہو، زیادہ سے زیادہ 20 میسج فی سیکنڈ بھیجتا ہے، اور اس سے آگے جانے پر 130429 واپس آتا ہے۔ باقی سب کچھ کسی بھی Cloud API نمبر جیسا ہی پڑھا جاتا ہے: وہی فیلڈ، وہی errors array، وہی کوڈ۔
آٹومیشنز اور آپ کا AI ناکامی کو کیسے دیکھتے ہیں؟
یہ اس پر منحصر ہے کہ Meta کب انکار کرتا ہے۔ بھیجنے کے وقت انکار، جیسے 131047، آٹومیشن کے مرحلے کو ناکام کر دیتا ہے: رن میں Runs ٹیب پر Meta کے میسج کے ساتھ Failed دکھائی دیتا ہے، اور مالک کو ای میل ملتی ہے تاکہ وہ خود اس کسٹمر کو جواب دے سکے۔ آٹومیشنز آزاد متن والے جواب بھیجنے سے پہلے ونڈو بھی جانچتی ہیں، اور کوشش کرنے کے بجائے window_closed کے ساتھ چھوڑ دیتی ہیں۔
Meta کی بعد میں رپورٹ کی گئی ناکامی ایک failed اسٹیٹس کے طور پر آپ کے Forward URL یا براہ راست ڈیسٹینیشن پر آتی ہے، اور رن اپنی حالت میں رہتا ہے۔ جو AI MCP connector کے ذریعے ٹیمپلیٹ بھیجتا ہے، وہ wamid اور "sent: true" دیکھتا ہے؛ اس wamid کا اسٹیٹس اپنے سسٹم سے پوچھیں، یا جب کئی میسجز ایک ساتھ ناکام ہوں تو اسسٹنٹ سے get_number_health چلوائیں۔
عام غلطیاں
- 131050 کو لوپ میں دوبارہ کوشش کرنا۔ کسٹمر نے مارکیٹنگ میسج بند کیے ہیں، اس لیے ہر کوشش اسی طرح ناکام ہوگی جب تک وہ دوبارہ شروع نہ کریں۔
- 131049 کا مارکیٹنگ ٹیمپلیٹ گھنٹوں کے اندر دوبارہ بھیجنا۔ Meta کم از کم 24 گھنٹے مانگتا ہے، اور جلدی کی کوششیں اس صارف کو مزید 24 گھنٹے تک بلاک کر سکتی ہیں۔
- صرف title لاگ کرنا۔ error_data.details مخصوص وجہ رکھتا ہے، اس لیے code اور details دونوں کو wamid کے ساتھ محفوظ کریں۔
- ویب ہک ڈیسٹینیشن کے بغیر چلانا اور ڈیلیوری کا فیصلہ بھیجنے کے جواب سے کرنا، جو صرف یہ بتاتا ہے کہ Meta نے میسج قبول کیا۔
جب بھیجنے کے وقت آٹومیشن کا جواب انکار ہو جائے، تو رن Meta کی خرابی دکھاتا ہے اور آپ کو ای میل ملتی ہے، اور ہر نمبر کی 24/7 نگرانی ہوتی ہے تاکہ کنکشن ٹوٹنے اور کوالٹی میں کمی کا فوراً پتا چلے۔ US$ 9 سے US$ 0.75 تک فی نمبر فی مہینہ، نمبر بڑھانے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن فری ٹرائل کے ساتھ۔
اکثر پوچھے جانے والے سوالات
کیا Meta ناکام میسج کا چارج لیتا ہے؟
Meta کے قیمت کے صفحات کہتے ہیں کہ وہ ان میسجز کا چارج لیتا ہے جو پہنچ جائیں، نہ کہ ان کا جو صرف بھیجے گئے ہوں۔ failed اسٹیٹس میں pricing object نہیں ہوتا۔ چارجز کاروبار کے اپنے WhatsApp Business Account کو جاتے ہیں؛ easyCoexistence انہیں کبھی مارک اپ نہیں کرتا۔
کیا 131026 کا مطلب ہے کہ کسٹمر نے کاروبار کو بلاک کیا؟
Meta کی 131026 کی فہرست دوسری وجوہات بتاتی ہے: یہ نمبر WhatsApp پر نہیں ہے، وصول کنندہ نے تازہ ترین شرائط قبول نہیں کیں، یا اس کا WhatsApp ورژن بہت پرانا ہے۔ Meta مشورہ دیتا ہے کہ ان کی تصدیق کے لیے کسٹمر سے کسی دوسرے چینل پر پوچھیں۔
recipient_user_id بعض ناکامیوں پر کیوں آتا ہے اور بعض پر نہیں؟
Meta failed اسٹیٹس پر اسے اس وقت شامل نہیں کرتا جب میسج فون نمبر پر بھیجا گیا ہو۔ جب آپ نے کسٹمر کے BSUID پر بھیجا ہو، تو ناکامی میں یہ شامل ہوتا ہے، اور recipient_id غائب ہو سکتا ہے۔
کیا میسج پہنچنے کے بعد ناکام ہو سکتا ہے؟
Meta کا حوالہ failed کو بھیجنے یا پہنچانے میں ناکامی کے طور پر بیان کرتا ہے۔ جب میسج ڈیوائس تک پہنچ جائے، تو اس کے بعد آپ جو اسٹیٹسز دیکھ سکتے ہیں وہ read ہیں، یا وائس میسجز کے لیے played۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ