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

WhatsApp کا user_preferences ویب ہک: جب صارف مارکیٹنگ میسجز بند یا دوبارہ شروع کرے

user_preferences ویب ہک کاروبار کو بتاتا ہے کہ ایک WhatsApp صارف نے Offers and announcements سیٹنگ میں مارکیٹنگ میسجز بند یا دوبارہ شروع کیے ہیں۔ ہر ایونٹ میں کیٹیگری marketing_messages، ویلیو stop یا resume، ایک تفصیلی جملہ، صارف کا wa_id اور BSUID، اور Unix ٹائم اسٹیمپ شامل ہوتے ہیں۔ اسی سیٹنگ میں Interested اور Not interested کا فیڈبیک اس ویب ہک کو نہیں چلاتا۔

easyCoexistence آپ کا WhatsApp Business ایپ نمبر Coexistence کے ذریعے Meta کی Cloud API سے جوڑتا ہے، تاکہ آپ کی AI اور آٹومیشنز اس نمبر پر چلیں جو آپ ایپ میں رکھتے ہیں۔

2

ترجیح کی ممکنہ ویلیوز: stop اور resume، دونوں marketing_messages کیٹیگری میں۔

131050

وہ ناکام اسٹیٹس کوڈ جو مارکیٹنگ ٹیمپلیٹ پر آتا ہے جب وہ ایسے صارف کو بھیجا جائے جس نے آپ کے مارکیٹنگ میسجز بند کیے ہوں۔

Default callback

Meta user_preferences کہاں بھیجتا ہے: یہ ایسا فیلڈ ہے جسے WhatsApp Business اکاؤنٹ یا نمبر اووررائیڈ نہیں کر سکتا۔

whatsapp_business_management

وہ اجازت جو ایپ کو messages اور calls کے علاوہ دیگر ویب ہکس کے لیے درکار ہے، user_preferences سمیت۔

کون سی چیز user_preferences ویب ہک کو چلاتی ہے؟

جب کوئی صارف Offers and announcements کھول کر WhatsApp میں آپ کے کاروبار کے مارکیٹنگ میسجز بند کرنے کا فیصلہ کرے، یا بعد میں دوبارہ شروع کرے، تو یہی دو کام اس ویب ہک کو چلاتے ہیں۔ اسی سیٹنگ میں صارف Interested یا Not interested کا نشان بھی لگا سکتا ہے، اور اس فیڈبیک پر کوئی ویب ہک نہیں جاتا۔ البتہ Not interested اس صارف کے لیے فی صارف مارکیٹنگ حد کم کر سکتا ہے، اور ایک دوسری اسکرین کھولتا ہے جو تمام مارکیٹنگ میسجز بند کرنے کی پیشکش کرتی ہے۔ صرف اگر وہ پھر بند کرنے کا بٹن دبائے تو تب user_preferences چلتا ہے۔

پے لوڈ میں کیا ہوتا ہے؟

contacts array کے ساتھ user_preferences نام کا ایک array، فیلڈ نام user_preferences کے تحت۔ یہاں timestamp ایک integer ہے، جبکہ اسٹیٹس ویب ہکس اسے string کے طور پر بھیجتے ہیں۔ wa_id اس وقت چھوڑ دیا جاتا ہے جب صارف username استعمال کرے اور اس کا فون نمبر شیئر نہ ہو سکے، user_id اس وقت نہیں آتا جب آپ کے کاروبار کے لیے کاروبار کے دائرے میں محدود user IDs فعال نہ ہوں، اور parent_user_id تبھی آتا ہے جب parent BSUIDs آن ہوں۔ دوبارہ شروع ہونے کی Meta کی مثال یہ ہے:

Meta's example: a customer resumes marketing messages
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.506847293015824"
              }
            ],
            "user_preferences": [
              {
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.506847293015824",
                "detail": "User requested to resume marketing messages",
                "category": "marketing_messages",
                "value": "resume",
                "timestamp": 1731705721
              }
            ]
          },
          "field": "user_preferences"
        }
      ]
    }
  ]
}

stop موصول ہونے پر آپ کے نظام کو کیا کرنا چاہیے؟

اسے صارف کے ریکارڈ میں درج کریں اور جب تک resume نہ آئے، اسے ہر مارکیٹنگ بھیجنے سے باہر رکھیں۔ detail فیلڈ دو میں سے ایک جملہ پڑھتا ہے: "User requested to stop marketing messages" یا "User requested to resume marketing messages"، لیکن کوڈ کو value پڑھنی چاہیے۔

  • ترجیح کو BSUID اور فون نمبر دونوں سے محفوظ کریں، کیونکہ کسی ایونٹ پر ان میں سے کوئی ایک غائب ہو سکتا ہے۔
  • صارف کو مارکیٹنگ ٹیمپلیٹ بھیجنے سے روکیں؛ Meta ویسے بھی انہیں 131050 کے ساتھ رد کر دیتا ہے۔
  • ترجیح صرف فی صارف لاگو کریں: Meta کبھی بھی parent BSUID کی سطح پر ترجیح لاگو نہیں کرتا۔
  • resume آنے پر پابندی ہٹائیں، اور اپنا opt-in ریکارڈ رکھیں جیسا کہ Meta کی opt-in پالیسی تقاضا کرتی ہے۔

اگر user_preferences آپ کے سرور تک نہ پہنچے تو کیا ہوگا؟

Meta پھر بھی بندش نافذ کرتا ہے، اس لیے ویب ہک کی غیر موجودگی آپ کو ناکام ڈیلیوری دیتی ہے، پالیسی کی خلاف ورزی نہیں۔ جب آپ کسی ایسے صارف کو مارکیٹنگ ٹیمپلیٹ بھیجتے ہیں جس نے بند کیا ہو، تو API درخواست قبول کرتی ہے، میسج نہیں بھیجتی، اور اسٹیٹس ویب ہک بھیجتی ہے جس میں status failed، کوڈ 131050 اور یہ عنوان ہوتا ہے: "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business"۔ اس ناکامی کو بالکل بند ہونے کے ایونٹ کی طرح سمجھیں: ریکارڈ کریں اور اس صارف کو مزید مارکیٹنگ بھیجنے سے روکیں۔

easyCoexistence سے جڑے نمبر پر یہ کیسے کام کرتا ہے؟

user_preferences ان فیلڈز میں شامل نہیں جن کے لیے Meta destination override کی اجازت دیتا ہے، اس لیے یہ صرف اس ایپ کے ڈیفالٹ callback پر آتا ہے جس نے اکاؤنٹ کو سبسکرائب کیا ہو۔ easyCoexistence سے جڑے نمبر کے لیے وہ ایپ easyCoexistence خود ہے، اور وہ آج user_preferences سبسکرائب نہیں کرتی، اس لیے یہ ایونٹ نہ کسی براہِ راست destination تک پہنچتا ہے اور نہ Forward URL تک۔ 131050 والا ناکام اسٹیٹس پہنچتا ہے، کیونکہ وہ messages فیلڈ پر سفر کرتا ہے۔

اگر آپ کی AI send_template کے ذریعے مارکیٹنگ ٹیمپلیٹ بھیجتی ہے، تو بندش کی فہرست اپنے نظام میں رکھیں اور پہلے اسے چیک کریں: easyCoexistence ایسی کوئی فہرست نہیں رکھتا۔

عام غلطیاں

  • Not interested کو بندش سمجھنا۔ اس پر کوئی ویب ہک نہیں جاتا اور ڈیلیوری بند نہیں ہوتی، اگرچہ یہ اس صارف کی فی صارف مارکیٹنگ حد کم کر سکتا ہے۔
  • صرف wa_id پر ترجیحات کا ریکارڈ رکھنا۔ جن صارفین کا یوزر نیم ہو اور نمبر شیئر نہ ہو سکے، ان کے لیے یہ فیلڈ غائب ہوتی ہے؛ BSUID بھی محفوظ کریں۔
  • parent BSUID کے تحت سب کو بندش لاگو کرنا۔ Meta ترجیحات فی صارف لاگو کرتا ہے، کبھی parent کی سطح پر نہیں۔
  • 131050 کے بعد دوبارہ کوشش کرنا، بجائے اس کے کہ اسے بندش کے طور پر ریکارڈ کیا جائے۔ ہر دوبارہ کوشش اسی طرح ناکام ہوگی۔
EasyCoexistence کے ساتھ یہ کام کرنا

اس کے ذریعے بھیجے گئے مارکیٹنگ ٹیمپلیٹ آپ کے اپنے WhatsApp Business اکاؤنٹ سے جاتے ہیں، اور بندش والے صارف کی اطلاع دینے والے ناکام اسٹیٹس یا تو براہِ راست آپ کے سرور تک پہنچتے ہیں یا دستخط شدہ forwards کی شکل میں۔ فی نمبر، فی مہینہ US$ 9 سے US$ 0.75 تک، نمبر بڑھنے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن مفت۔

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

کیا بندش صارف کے اپنے میسجز کے جواب بھی روکتی ہے؟

Meta کی دستاویزات کے مطابق بندش مارکیٹنگ میسجز پر لاگو ہوتی ہے، اور واپس آنے والی خرابی بھی مارکیٹنگ میسجز کا ذکر کرتی ہے۔ وہ صارف جو آپ کو لکھے، اس کے میسجز کے جواب سروس میسجز ہیں، جو ایک الگ زمرہ ہے۔

کیا کاروبار کو بلاک کرنا user_preferences کو چلاتا ہے؟

نہیں۔ یہ ویب ہک صرف Offers and announcements سیٹنگ میں stop اور resume پر چلتا ہے۔ بلاک کرنا ایک الگ عمل ہے اور اس فیلڈ پر رپورٹ نہیں ہوتا۔

کیا دوبارہ شروع ہونا opt-in شمار ہوتا ہے؟

اس کا مطلب ہے کہ صارف نے دوبارہ آپ سے مارکیٹنگ میسجز وصول کرنے کا فیصلہ کیا۔ Meta کی پالیسی کے تحت آپ کی اپنی opt-in ذمہ داریاں پھر بھی لاگو ہیں، اس لیے ریکارڈ رکھیں کہ اس صارف نے کس طرح اور کب آپ سے پیغامات وصول کرنے پر رضامندی دی تھی۔

میں کون سا ویب ہک فیلڈ سبسکرائب کروں؟

user_preferences، App Dashboard میں WhatsApp > Configuration کے تحت، اس ایپ پر جو WhatsApp Business اکاؤنٹ کو سبسکرائب ہو۔ یہ messages سے الگ فیلڈ ہے اور whatsapp_business_management درکار ہے۔

مزید پڑھیں

WhatsApp میسج کیوں ناکام ہوا: failed اسٹیٹس اور errors پڑھناfailed اسٹیٹس کا مطلب ہے کہ Meta آپ کا WhatsApp میسج بھیج یا پہنچا نہیں سکا۔ errors اور ایرر کوڈ 131047، 131049، 131050 پڑھیں اور جانیں کہ کیا کرنا ہے۔WhatsApp ویب ہک اسٹیٹس: sent، delivered، read اور failedWhatsApp بتاتا ہے کہ آپ کے بھیجے گئے میسج کے ساتھ کیا ہوا: statuses array، ہر ویلیو، ہر فیلڈ، اور wamid کے ذریعے مماثلت۔WhatsApp ایرر 131050: صارف نے آپٹ آؤٹ کیا ہےایرر 131050 کا مطلب ہے کہ وصول کنندہ نے آپ کے کاروبار کے میسجز لینے سے انکار کیا ہے۔ اس فیصلے کا احترام کریں۔کاروبار کی طرف سے شروع کیے گئے میسجز کے لیے WhatsApp آپٹ اِن کی شرائطMeta کی WhatsApp پالیسی کے مطابق کاروبار کو میسج کرنے سے پہلے کیا درکار ہے: دو شرائط، آپٹ اِن میں کیا لکھنا ہے اور آپٹ آؤٹ کے اصول۔WhatsApp مارکیٹنگ آٹومیشن، ٹیمپلیٹ اور آپٹ ان کے ساتھMeta کی اجازت کے مطابق WhatsApp مارکیٹنگ کو خودکار بنائیں: پہلے آپٹ ان، منظور شدہ مارکیٹنگ ٹیمپلیٹ، خودکار جوابات اور معیار برقرار رکھیں۔WhatsApp ویب ہک فیلڈز اور ان کی منزلCoexistence کنکشن کے آٹھ ویب ہک فیلڈز، ہر ایک کا پے لوڈ، اور آپ کے اینڈ پوائنٹ یا مانیٹرنگ تک جانے والے فیلڈز۔

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

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

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

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