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

WhatsApp یوزر نیمز اور کاروبار کے دائرے میں صارف آئی ڈیز (BSUID): کلاؤڈ API ویب ہکس میں کیا بدلتا ہے

WhatsApp یوزر نیمز صارفین کو فون نمبر کے بجائے ایک نام دکھانے دیتے ہیں، اس لیے اپریل 2026 کے اوائل سے Cloud API کے میسج ویب ہکس میں user_id اور from_user_id میں کاروبار کے دائرے میں صارف آئی ڈی (BSUID) بھی آتی ہے، جیسے US.13491208655302741918۔ جس صارف کا یوزر نیم ہو، جس نے 30 دن میں اس نمبر سے کوئی میسج یا کال نہ کی ہو اور جو کانٹیکٹ بک میں نہ ہو، اس کے لیے wa_id اور from چھوڑ دیے جاتے ہیں۔

easyCoexistence ایک WhatsApp Business ایپ کے نمبر کو Coexistence کے ذریعے Cloud API سے جوڑتا ہے اور اس کے messages اور smb_message_echoes ویب ہکس کو Meta کی بھیجی ہوئی صورت میں آپ کے اینڈ پوائنٹ پر روٹ کرتا ہے، جن میں BSUID فیلڈز شامل ہیں، جبکہ get_api_credentials آپ کے کوڈ کو وہ سب دیتا ہے جو recipient کے ساتھ جواب دینے کے لیے درکار ہے۔

April 2026

یوزر نیمز WhatsApp صارفین تک پہنچنے سے پہلے ہی BSUIDs کلاؤڈ API ویب ہکس میں آنے لگے۔

July 2026

APIs نے کب سے BSUID پر بھیجے گئے میسجز قبول کرنا شروع کیے، جن میں recipient میں to کی جگہ BSUID رکھا جاتا ہے۔

30 days

لُک بیک ونڈو، جو ہر کاروبار کے فون نمبر کے لیے الگ ہے، جس میں صارف کے ساتھ کوئی بھی میسج یا کال ہو تو ویب ہکس میں اس کا نمبر باقی رہتا ہے۔

128

BSUID کے دو حرفی ملک کوڈ اور نقطے کے بعد زیادہ تر حروف الفا نیومرک ہوتے ہیں۔

131062

Messages API ایرر: Business-scoped User ID (BSUID) recipients are not supported for this message.

user_changed_user_id

BSUID کی تبدیلی کے لیے سسٹم میسج ٹائپ، جو فون نمبر کے بغیر رپورٹ ہوتا ہے، جس میں پرانا BSUID previous_user_id میں ہوتا ہے۔

WhatsApp یوزر نیمز اور BSUIDs کیا ہیں؟

یوزر نیم ایک اختیاری اور منفرد نام ہے جو WhatsApp صارف رکھ سکتا ہے، اور یہ ایپ میں فون نمبر کی جگہ دکھایا جاتا ہے؛ Meta 2026 میں یوزر نیمز کو آہستہ آہستہ متعارف کرا رہا ہے۔ BSUID وہ بیک اینڈ شناخت ہے جو Meta نے اس لیے شامل کی تاکہ کاروبار اب بھی اپنے صارفین کو الگ پہچان سکیں: یہ خودکار طور پر بنتا ہے، ہر Business Portfolio اور صارف کے جوڑے کے لیے منفرد ہوتا ہے، اور اس کی شکل یہ ہوتی ہے: صارف کا ISO 3166 دو حرفی ملک کوڈ، ایک نقطہ، اور زیادہ سے زیادہ 128 الفا نیومرک حروف۔ Meta پارٹنرز اور براہ راست انٹیگریٹ ہونے والے کاروباروں سے اسے سپورٹ کرنے کا تقاضا کرتا ہے، کیونکہ کوئی کاروبار یہ کنٹرول نہیں کرتا کہ اس کے صارفین یوزر نیمز اپنائیں گے یا نہیں۔

کون سے فیلڈز نئی شناخت رکھتے ہیں؟

نئی پراپرٹیز ان فیلڈز کے ساتھ آتی ہیں جن میں پہلے فون نمبر ہوتا تھا، جو messages، status، system اور user_preferences ویب ہکس میں پھیلی ہیں۔ پیرنٹ BSUID فیلڈز صرف ان Business Portfolios کے لیے ظاہر ہوتے ہیں جنہیں Meta نے پیرنٹ BSUIDs کے لیے رجسٹر کیا ہے، جو رجسٹرڈ پورٹ فولیوز میں کام کرتے ہیں:

contacts[].user_idThe user's BSUID, in incoming messages and in sent, delivered and read statuses
messages[].from_user_idThe sender's BSUID, beside from
contacts[].profile.usernameThe username, when the user has one; never on sent statuses
statuses[].recipient_user_idThe recipient's BSUID, unless a send to a phone number failed
parent_user_idA parent BSUID shared by enrolled portfolios, such as US.ENT.11815799212886844830
wa_id, from, recipient_idNow left out when the phone number cannot be shared

فون نمبر کب چھوڑا جاتا ہے؟

جب صارف کا یوزر نیم ہو اور Meta کی تین شرائط میں سے کوئی بھی پوری نہ ہو۔ نمبر ویب ہکس میں اس صورت میں رہتا ہے جب کاروبار کے فون نمبر نے پچھلے 30 دن میں اس صارف کے نمبر پر میسج کیا یا کال کی، یا اس مدت میں اس سے میسج یا کال موصول ہوئی، یا صارف Business Portfolio کی کانٹیکٹ بک میں ہو۔ 30 دن کا لُک بیک ہر کاروبار کے فون نمبر کے لیے الگ گنا جاتا ہے، اس لیے اسی پورٹ فولیو میں دوسرا نمبر اسی صارف کے لیے صرف BSUID وصول کر سکتا ہے۔ بغیر یوزر نیم والے صارف اب بھی اپنا فون نمبر اور BSUID دونوں کے ساتھ آتے ہیں۔

اب میسج کیسا نظر آتا ہے؟

پہلے کی طرح، BSUID فون نمبر کے ساتھ یا اس کی جگہ ہوتا ہے۔ Meta کی مثال میں، جس صارف کا یوزر نیم ہو اور جس کا نمبر شیئر نہ کیا جا سکے، اس کے contacts میں profile.name، profile.username اور user_id ہوتے ہیں، اور میسج میں from_user_id وہاں آتا ہے جہاں پہلے from ہوتا تھا:

messages webhook: a text from a user known only by BSUID
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "102290129340398",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" },
        "contacts": [{
          "profile": { "name": "Sheena Nelson", "username": "realsheenanelson" },
          "user_id": "US.13491208655302741918"
        }],
        "messages": [{
          "from_user_id": "US.13491208655302741918",
          "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=",
          "timestamp": "1749416383",
          "type": "text",
          "text": { "body": "Does it come in another color?" }
        }]
      }
    }]
  }]
}

status ویب ہکس کیسے بدلتے ہیں؟

بھیجے گئے، ڈیلیور اور ریڈ اسٹیٹس میں contacts فیلڈ شامل ہوتا ہے جس میں صارف کا نام، user_id، جب نمبر شیئر ہو سکے تو wa_id، اور delivered اور read پر username ہوتا ہے۔ اسٹیٹسز میں recipient_user_id BSUID رکھتا ہے، اور جب آپ نے BSUID پر بھیجا ہو اور نمبر شیئر نہ ہو سکے تو recipient_id چھوڑ دیا جاتا ہے۔ ناکام اسٹیٹس میں contacts فہرست نہیں ہوتی اور جب میسج فون نمبر پر گیا ہو تو recipient_user_id غائب ہوتا ہے، اس لیے ناکامیوں کو میسج id سے جوڑیں۔

صارفین کو کیسے محفوظ اور میچ کریں؟

پہلے BSUID سے، اور فون نمبر دوسری کلید کے طور پر جب بھی آئے۔ پورا BSUID بطور اسٹرنگ محفوظ کریں، ملک کوڈ اور نقطے سمیت، کیونکہ Meta کسی بھی حصے کو بدلنے والی درخواست مسترد کرتا ہے، اور اگر آپ کے پورٹ فولیوز رجسٹرڈ ہوں تو پیرنٹ BSUID بھی محفوظ کریں۔ موجودہ ریکارڈز کو wa_id پر جوڑیں جب تک وہ آتا ہے، اور BSUID ان کے ساتھ رکھیں، کیونکہ بعد میں یوزر نیم اپنانے والا صارف بغیر نمبر کے واپس آ سکتا ہے۔ Meta کے FAQ میں CRMs اور ان ٹولز میں یہی جوڑ مانگا گیا ہے جو انہیں ڈیٹا دیتے ہیں۔

جب صارف اپنا فون نمبر بدلے تو کیا ہوتا ہے؟

اس کا BSUID دوبارہ بنتا ہے، اور تبدیلی messages فیلڈ پر سسٹم میسج کے طور پر آتی ہے، کیونکہ Meta کے پاس سبسکرائب کرنے کے لیے user_id_update فیلڈ نہیں ہے۔ system.type اس وقت user_changed_number ہوتا ہے جب نیا نمبر آپ کے ساتھ شیئر ہو سکے، یا user_changed_user_id جب صرف BSUID کی تبدیلی رپورٹ ہو سکے؛ system.user_id نیا BSUID رکھتا ہے اور system.previous_user_id پرانا، اور اسی سے ریکارڈ منتقل ہوتا ہے۔ دونوں اقسام کو سنبھالیں۔

صرف BSUID والے صارف کو جواب کیسے دیں؟

/<BUSINESS_PHONE_NUMBER_ID>/messages پر بھیجیں، جس میں recipient BSUID پر ہو اور to چھوڑ دیا گیا ہو؛ دونوں موجود ہوں تو to کو ترجیح ملتی ہے اور جواب فون نمبر پر جاتا ہے۔ اس کے بعد جواب میں contacts کی انٹری input اور user_id رکھتی ہے، نہ کہ wa_id۔ کوئی بھی میسج ٹائپ کام کرتا ہے سوائے one-tap، zero-tap اور copy code authentication ٹیمپلیٹس کے، جنہیں فون نمبر درکار ہوتا ہے، اور صرف اسی Business Portfolio کے نمبر BSUID تک پہنچ سکتے ہیں۔ ایرر 131062 کا مطلب ہے کہ یہ میسج ٹائپ BSUID recipients قبول نہیں کرتا۔

POST /<BUSINESS_PHONE_NUMBER_ID>/messages, sent to a BSUID
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "US.13491208655302741918",
  "type": "text",
  "text": { "body": "Yes, it also comes in blue." }
}

صارف سے فون نمبر کیسے مانگیں؟

REQUEST_CONTACT_INFO بٹن کے ذریعے، جو یوٹیلیٹی یا مارکیٹنگ ٹیمپلیٹ میں شامل کیا جاتا ہے یا request_contact_info ٹائپ کے انٹرایکٹو میسج کے طور پر بھیجا جاتا ہے۔ جو صارف اسے ٹیپ کرتا ہے وہ اپنا نمبر تھریڈ میں شیئر کرتا ہے، اور origin کو contact_request کے ساتھ اور نمبر phones[].wa_id میں رکھ کر contacts ویب ہک آتا ہے؛ ہاتھ سے شیئر کیا گیا کنٹیکٹ origin other اور vCard کے ساتھ آتا ہے۔ Meta نے یہ بٹن جولائی 2026 کے شروع میں دستیاب کیا، اور اس کا لیبل تبدیل نہیں ہو سکتا۔

کانٹیکٹ بک کیا ہے؟

Meta ہر Business Portfolio کے لیے ایک اسٹور میزبانی کرتا ہے، جس کے لیے انٹیگریشن کا کوئی کام نہیں: جب کوئی کاروباری فون نمبر صارف کے فون نمبر پر میسج کرے، کال کرے یا اس سے میسج یا کال موصول کرے، تو وہ نمبر اور BSUID ریکارڈ ہوتے ہیں اور بعد کے ویب ہکس کو فون نمبر سے بھرنے کے لیے استعمال ہوتے ہیں، یوزر نیم ہو یا نہ ہو۔ صرف اس کے لانچ کے بعد کے تعاملات شمار ہوتے ہیں۔ اسے Meta Business Suite، Business settings، Business info میں بند کیا جا سکتا ہے، جس سے اس کا ڈیٹا حذف ہو جاتا ہے، اور GET یا DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book کے ساتھ bsuid دے کر ایک انٹری چیک یا ہٹائی جا سکتی ہے۔

Coexistence انٹیگریشن کو کیا بدلنا چاہیے؟

صرف Coexistence نمبر کو ملنے والے تین ویب ہکس کو ہینڈل کرنے کا طریقہ، جو خود بھی بدلتے ہیں۔ history میں ہر تھریڈ کو wa_id، user_id اور username کے ساتھ ایک context آبجیکٹ ملتا ہے، اور اس کے messages کو from_user_id ملتا ہے۔ smb_message_echoes میں contacts فہرست شامل ہوتی ہے، اور message_echoes[].to چھوڑا جا سکتا ہے جبکہ to_user_id BSUID رکھتا ہے؛ WhatsApp Business ایپ میں کی گئی ترامیم اور منسوخیاں اسی طرح آتی ہیں۔ smb_app_state_sync میں کسی کنٹیکٹ کا phone_number چھوڑا جا سکتا ہے، جس کے ساتھ user_id اور username ہوتے ہیں۔ echoes اور امپورٹ شدہ چیٹس کو نمبر کے ساتھ user_id پر بھی میچ کریں۔

یوزر نیمز اپنانے سے پہلے کیسے ٹیسٹ کریں؟

Meta کے ٹیسٹ ٹول کے ذریعے، App Dashboard میں: Use cases، Connect with customers through WhatsApp، Customize، Configuration، پھر messages ویب ہک کے ساتھ Test لنک، جو آپ کے اینڈ پوائنٹ پر نمونہ بھیجتا ہے۔ یہ چار منظرناموں میں آنے والے میسجز اور اسٹیٹسز کو کور کرتا ہے:

  • یوزر نیم کے بغیر صارف: BSUID اور فون نمبر کے فیلڈز، اور کوئی یوزر نیم نہیں۔
  • یوزر نیم والا صارف جس کا نمبر دستیاب نہیں: یوزر نیم اور BSUID، فون نمبر کے فیلڈز کے بغیر۔
  • یوزر نیم والا صارف جس کا نمبر دستیاب ہے: یوزر نیم، BSUID اور فون نمبر۔
  • ایسا Business Portfolio جو پیرنٹ BSUIDs میں رجسٹر ہو: پورٹ فولیو کے اپنے BSUID کے ساتھ ایک پیرنٹ BSUID۔

easyCoexistence BSUIDs کو کیسے ہینڈل کرتا ہے؟

یہ انہیں ویسے ہی آگے بھیجتا ہے جیسے Meta بھیجتا ہے۔ جو نمبر set_webhook_destination کے ساتھ آپ کے اینڈ پوائنٹ پر روٹ کیا گیا ہو، اس کے messages اور smb_message_echoes ویب ہکس براہ راست Meta سے آتے ہیں، جن میں user_id، from_user_id، to_user_id اور username شامل ہیں، اور آٹومیشنز یا فارورڈنگ آن ہونے پر easyCoexistence Meta کی بھیجی ہوئی ویلیو کو بغیر تبدیلی کے فارورڈ کرتا ہے۔ BSUID پر جواب دینے کے لیے آپ کا کوڈ get_api_credentials استعمال کرتا ہے، جو نمبر کا phone number ID، اس کا send اینڈ پوائنٹ اور، دستیاب ہو تو آپ کا اپنا ٹوکن واپس کرتا ہے؛ send_message اور send_template ٹولز بین الاقوامی ڈیجیٹس میں فون نمبر لیتے ہیں۔

عام غلطیاں

  • wa_id پر اکیلے کانٹیکٹس کی کلید بنانا۔ جس صارف کا یوزر نیم ہو اور جس کا 30 دن میں نمبر سے کوئی رابطہ نہ ہوا ہو، وہ صرف user_id اور from_user_id کے ساتھ آتا ہے، اور جو ہینڈلر wa_id مانگتا ہے وہ میسج کھو دیتا ہے۔
  • BSUID کا ملک کا سابقہ کاٹنا۔ Meta پوری ویلیو چاہتا ہے، ملک کوڈ اور نقطے سمیت، اور کسی بھی حصے کے بدلنے سے درخواست ناکام ہوتی ہے۔
  • user_id_update فیلڈ کا انتظار۔ Meta کے پاس ایسا کوئی فیلڈ نہیں: BSUID کی تبدیلیاں messages پر سسٹم میسجز کی صورت میں آتی ہیں، جن کی قسم user_changed_number یا user_changed_user_id ہوتی ہے۔
  • smb_message_echoes میں صرف to سے میچ کرنا۔ اس میں to فیلڈ چھوڑا جا سکتا ہے، اس لیے ایپ میں ٹائپ کیا گیا جواب اس وقت تک نظر نہیں آتا جب تک to_user_id بھی میچ نہ کیا جائے۔
EasyCoexistence کے ساتھ یہ کام کرنا

ہر کنکشن 24/7 مانیٹر ہوتا ہے۔ فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھانے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن مفت ہیں۔

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

کیا بغیر یوزر نیم والے صارفین کو بھی BSUID ملتا ہے؟

جی ہاں۔ Meta messages ویب ہکس میں user_id ہمیشہ سیٹ کرتا ہے، چاہے صارف کا یوزر نیم ہو یا نہ ہو، اس لیے زیادہ تر صارف اپنے فون نمبر اور BSUID دونوں کے ساتھ آتے ہیں۔

کیا Coexistence نمبر کا کاروباری یوزر نیم ہو سکتا ہے؟

جی ہاں۔ 29 جون 2026 سے کاروبار Meta Business Suite، WhatsApp Manager، WhatsApp Business ایپ یا Username API میں ایک یوزر نیم اپنا یا تبدیل کر سکتا ہے؛ اس سے کاروباری نمبر چھپتا نہیں، اور business_username_updates ہر اسٹیٹس تبدیلی رپورٹ کرتا ہے۔

کیا BSUID مختلف Business Portfolios میں کام کرتا ہے؟

نہیں۔ BSUID ایک پورٹ فولیو اور ایک صارف سے منسلک ہوتا ہے، اور دوسرے پورٹ فولیو کا نمبر اسے میسج نہیں کر سکتا۔ Meta جن منظم کاروباروں کو رجسٹر کرتا ہے انہیں ملک کوڈ کے بعد ENT کے ساتھ پیرنٹ BSUIDs ملتے ہیں، جو ان کے رجسٹرڈ پورٹ فولیوز میں کام کرتے ہیں۔

easyCoexistence کا ایک WhatsApp نمبر کے لیے کتنا خرچ ہوتا ہے؟

فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، آپ کے کنکشنز کی تعداد پر منحصر، اور پہلے 3 دن مفت ہیں۔ Meta کے اپنے میسج چارجز آپ کے WhatsApp Business Account کے ادائیگی کے طریقے پر ہی رہتے ہیں۔

مزید پڑھیں

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

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

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

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