WhatsApp یوزر نیمز اور BSUIDs: OTP، CRM اور webhooks کے لیے کیا بدل رہا ہے

بزنس اسکوپڈ یوزر آئی ڈی (BSUID) وہ شناختی کوڈ ہے جو Meta اب ہر WhatsApp webhook میں شامل کرتا ہے تاکہ ایک کاروبار صارف کا فون نمبر جانے بغیر اسے میسج بھیج سکے۔ یہ اس لیے متعارف کرایا جا رہا ہے کیونکہ WhatsApp usernames متعارف کرا رہا ہے: ایک بار جب صارف اسے آن کر دیتا ہے، تو وہ کاروبار جس سے حال ہی میں رابطہ نہیں ہوا، اسے اب فون نمبر موصول نہیں ہو سکتا۔ BroadNet انجینئرنگ ٹیم کی طرف سے تیار کردہ یہ گائیڈ اس کے فارمیٹ، ٹائم لائن، ان چیزوں کی وضاحت کرتی ہے جن کے لیے اب بھی فون نمبر درکار ہے، اور webhooks، CRM ریکارڈز اور OTP flows کو منتقل کرنے کا طریقہ بتاتی ہے۔

اہم نکات

• اپریل 2026 کے آغاز سے WhatsApp webhooks میں BSUIDs نظر آنے لگے ہیں، ہر صارف کے لیے، چاہے وہ username استعمال کرے یا نہ کرے۔
• ایک BSUID اس طرح نظر آتا ہے: US.13491208655302741918: ایک ISO 3166 alpha-2 کنٹری کوڈ، ایک نقطہ، اور پھر 128 تک alphanumeric حروف۔
• یہ ہر بزنس پورٹ فولیو اور یوزر کے جوڑے کے لیے منفرد ہے، اور اگر صارف اپنا فون نمبر تبدیل کرتا ہے تو اسے دوبارہ تیار (regenerate) کیا جاتا ہے۔
• جولائی 2026 سے آپ BSUID پر میسجز بھیج سکتے ہیں، سوائے one-tap، zero-tap اور copy-code authentication templates کے، جن کے لیے اب بھی فون نمبر کی ضرورت ہے۔
• Meta کا کہنا ہے کہ پارٹنرز اور براہ راست انٹیگریٹڈ بزنسز کے لیے BSUIDs کی سپورٹ کرنا لازمی ہے تاکہ یوزر نیم صارفین سے میسجز پروسیس کرنے کی صلاحیت سے محروم ہونے سے بچا جا سکے۔
• تصدیق شدہ E.164 فون نمبر کو OTP، SMS فال بیک اور فراڈ چیک کے لیے شناخت کے بنیادی ستون کے طور پر برقرار رکھیں۔ BSUID کو WhatsApp-چینل کی (key) کے طور پر استعمال کریں۔

بزنس اسکوپڈ یوزر ID کیا ہے؟

Meta ایک BSUID کی تعریف یوں کرتا ہے: "ایک منفرد یوزر آئیڈنٹیفائر جسے آپ WhatsApp صارف کو میسج بھیجنے کے لیے استعمال کر سکتے ہیں جب آپ ان کا فون نمبر نہیں جانتے" (Meta، بزنس اسکوپڈ یوزر آئی ڈیز)۔ اس کا فارمیٹ صارف کے ملک کا ISO 3166 الفا-2 کوڈ، ایک نقطہ (period)، اور 128 تک الفابیٹک اور نمبرک کریکٹرز ہے، مثال کے طور پر US.13491208655302741918۔

سسٹم ڈیزائن کے لیے تین خصوصیات اہم ہیں:

• اسکوپ (Scope)۔ ایک BSUID ایک بزنس پورٹ فولیو اور ایک صارف کے لیے منفرد ہوتا ہے۔ ایک ہی شخص کے لیے ہر اس بزنس پورٹ فولیو کے لیے ایک مختلف BSUID ہوتا ہے جس سے وہ بات کرتا ہے، اس لیے آپ اسے غیر متعلقہ پورٹ فولیو کے درمیان صارفین کو میچ کرنے کے لیے استعمال نہیں کر سکتے۔
• استحکام (Stability)۔ جب صارف اپنا فون نمبر تبدیل کرتا ہے تو اسے دوبارہ تیار (regenerate) کیا جاتا ہے۔ جب ایسا ہوتا ہے تو Meta user_changed_user_id ٹائپ کا ایک سسٹم میسج webhook اور ایک الگ user_id_update webhook بھیجتا ہے۔
• پیئرنٹ BSUIDs۔ کئی پورٹ فولیوز رکھنے والے مینیجڈ بزنسز اپنے Meta پوائنٹ آف کانٹیکٹ سے پیئرنٹ BSUIDs میں داخلہ لینے کا کہہ سکتے ہیں، جن میں ENT (مثال کے طور پر US.ENT.11815799212886844830) شامل ہوتے ہیں اور یہ تمام رجسٹرڈ پورٹ فولیوز پر کام کرتے ہیں۔

WhatsApp یوزر نیمز (usernames) کیوں متعارف کروا رہا ہے؟

پرائیویسی کے لیے۔ Meta نے 29 جون 2026 کو اعلان کیا کہ لوگ "اس سال کے آخر میں" استعمال کرنے کے لیے یوزر نیم ریزرو کر سکتے ہیں، اور جب کوئی صارف اسے فعال کر لے گا، تو وہ شخص یا کاروبار جسے وہ پہلی بار میسج کرے گا، اسے اب صارف کا فون نمبر نظر نہیں آئے گا (About Meta)۔ Meta کی ڈویلپر ڈاکومنٹیشن کے مطابق یوزر نیمز 2026 میں بتدریج متعارف کروائے جائیں گے۔

کاروبار بھی یوزر نیمز رکھ سکتے ہیں۔ 29 جون 2026 سے ایک کاروبار WhatsApp Manager، Meta Business Suite یا Username API کے ذریعے وہ یوزر نیم کلیم کر سکتا ہے جو WhatsApp نے اس کے لیے ریزرو کیا ہے، اور منظور شدہ یوزر نیمز فیچر کے لانچ ہونے پر فعال ہو جائیں گے۔ بزنس یوزر نیم کاروبار کا فون نمبر نہیں چھپاتا۔

ٹائم لائن کیا ہے؟

کیا آپ صارف کا فون نمبر کھو دیں گے؟

کبھی کبھار۔ BSUID تمام میسجز webhooks میں ظاہر ہوتا ہے۔ فون نمبر (wa_id، اور ان باؤنڈ میسجز میں 'from') صرف اس وقت شامل کیا جاتا ہے جب Meta کے مطابق درج ذیل میں سے کم از کم ایک شرط پوری ہو رہی ہو:

• webhook ٹرگر ہونے سے 30 دنوں کے اندر آپ نے صارف کے فون نمبر پر میسج یا کال کی ہو؛
• ان 30 دنوں کے دوران آپ کو صارف کے فون نمبر سے میسج یا کال موصول ہوئی ہو؛ یا
• صارف آپ کی کانٹیکٹ بک میں موجود ہو۔

30 دن کا لک بیک (lookback) ہر کاروباری فون نمبر کے لیے الگ سے جانچا جاتا ہے، اس لیے ممکن ہے کہ جو گاہک آپ کی سیلز لائن کے لیے جانا پہچانا ہو، وہ آپ کی سپورٹ لائن کے لیے نامعلوم ہو۔ کانٹیکٹ بک ایک Meta ہوسٹڈ فیچر ہے جو پہلی بات چیت کے بعد فون نمبرز اور BSUIDs کو محفوظ کرتا ہے، تاکہ بعد میں webhooks اس نمبر کو برقرار رکھ سکیں، چاہے صارف یوزر نیم اپنا لے۔ یہ ڈیفالٹ کے طور پر آن رہتا ہے اور اسے Meta Business Suite میں Business settings، Business info کے تحت بند کیا جا سکتا ہے۔ جب تک آپ کے پاس اسے بند کرنے کی کوئی خاص وجہ نہ ہو، اسے آن ہی رہنے دیں۔

کس چیز کے لیے اب بھی فون نمبر کی ضرورت ہے؟

Meta بالکل واضح ہے: BSUIDs کو "ایسے کسی بھی قسم کے میسج بھیجنے کے لیے استعمال کیا جا سکتا ہے سوائے ون-ٹیپ، زیرو-ٹیپ، اور کاپی کوڈ آتھنٹیکیشن ٹیمپلیٹس کے، جن کے لیے صارف کے فون نمبرز درکار ہوتے ہیں"۔ WhatsApp کے علاوہ، موبائل نیٹ ورک پر چلنے والی کسی بھی چیز کے لیے نمبر کی ضرورت ہوتی ہے۔

webhook پہلے اور بعد میں کیسا نظر آتا ہے؟

BSUID سے پہلے، messages webhook میں contacts بلاک میں فون نمبر wa_id میں ہوتا تھا، اور زیادہ تر integrations اسے کسٹمر کی (customer key) کے طور پر استعمال کرتے تھے۔ Meta کے نئے contacts object کے نمونے میں username، BSUID اور جہاں فعال ہو، parent BSUID شامل کیا گیا ہے؛ wa_id صرف اس وقت موجود ہوتا ہے جب نمبر شیئر کیا جا سکے:

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

ان باؤنڈ (Inbound) میسجز میں from_user_id (اور اگر فعال ہو تو from_parent_user_id) بھی شامل ہوتا ہے، اور status webhooks میں recipient_user_id ہوتا ہے، جسے Meta کے مطابق ہمیشہ صارف کے BSUID پر سیٹ کیا جاتا ہے۔ بھیجنے کے لیے، نئے recipient پیرامیٹر میں BSUID ڈالیں۔ آپ to پیرامیٹر (فون نمبر)، recipient پیرامیٹر (BSUID)، یا دونوں سیٹ کر سکتے ہیں؛ جب دونوں موجود ہوں، تو فون نمبر کو ترجیح دی جاتی ہے:

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

بھیجنے کے جواب (send response) میں اب اس کے contacts array میں user_id شامل ہوتا ہے، اور wa_id اختیاری ہو جاتا ہے۔ اگر آپ کا پارسر یہ فرض کرتا ہے کہ wa_id ہمیشہ موجود ہوتا ہے، تو یہ پہلے username صارف پر ناکام ہو جائے گا۔ آپ یہ چیک کرنے کے لیے کہ آپ کی integration کو اصل میں کون سے فیلڈز موصول ہو رہے ہیں، ہمارے webhook payload inspector میں اصل payloads پیسٹ کر سکتے ہیں۔

OTP کے لیے کیا چیز کام کرنا چھوڑ دیتی ہے؟

one-tap، zero-tap یا copy-code بٹنز والے Authentication templates BSUID کو نہیں بھیجے جا سکتے۔ اگر کوئی username صارف آپ سے WhatsApp کے ذریعے رابطہ کرتا ہے اور آپ کے پاس ان کا فون نمبر نہیں ہے، تو آپ انہیں ان اقسام کے WhatsApp OTP نہیں بھیج سکتے۔ تصدیقی عمل (verification flows) کے لیے اس کے دو نتائج ہیں:

• سائن اپ کے وقت فون نمبر کو E.164 فارمیٹ میں جمع کریں اور تصدیق کریں، اور اسے اکاؤنٹ کے تصدیقی ایڈریس کے طور پر محفوظ کریں۔ اسے بعد میں آپ کو فراہم کرنے کے لیے WhatsApp webhook پر بھروسہ نہ کریں۔ دیکھیں کہ E.164 کیا ہے۔
• ایک ایسا چینل رکھیں جو خود نمبر پر کام کرتا ہو۔ SMS OTP، voice OTP اور silent network چیکز سب فون نمبر پر چلتے ہیں، یہی وجہ ہے کہ automatic fallback کے ساتھ ایک multichannel ڈیزائن اس تبدیلی کے بعد بھی بغیر کسی تبدیلی کے برقرار رہتا ہے۔ ہماری multichannel OTP گائیڈ اور BroadNet OTP پروڈکٹ اس پیٹرن کا احاطہ کرتی ہیں۔

CRM اور کسٹمر ڈی ڈپلیکیشن (deduplication) میں کیا مسائل پیدا ہوتے ہیں؟

زیادہ تر CRMs WhatsApp کانٹیکٹ کی شناخت فون نمبر سے کرتے ہیں کیونکہ SMS، وائس اور WhatsApp سب اسے شیئر کرتے تھے۔ یوزر نیمز کے بعد، ایک نیا ان باؤنڈ کانٹیکٹ صرف BSUID کے ساتھ آ سکتا ہے۔ اگر آپ اس کے لیے CRM کا نیا ریکارڈ بناتے ہیں، تو آپ کے کسٹمرز کا ڈیٹا آہستہ آہستہ ڈپلیکیٹ ہو جائے گا۔ ڈیٹا کو صاف رکھنے کے لیے چار اصول درج ذیل ہیں:

1. 1BSUID کو چینل آئیڈنٹیٹی کے طور پر ماڈل کریں، نہ کہ کسٹمر آئی ڈی کے طور پر۔ ایک کسٹمر کے پاس کئی BSUID ہو سکتے ہیں (ہر بزنس پورٹ فولیو کے لیے ایک) اور نمبر کی تبدیلی کے بعد ایک نیا BSUID ہو سکتا ہے۔
2. 2BSUID، پورٹ فولیو، فون نمبر (جب معلوم ہو)، پہلی بار دیکھا گیا (first seen) اور آخری بار دیکھا گیا (last seen) کا ایک میپنگ ٹیبل رکھیں، اور ہر webhook پر اسے اپ ڈیٹ کریں، بشمول user_id_update۔
3. 3صرف ثبوت کی بنیاد پر ڈیٹا کو مرج (merge) کریں، اندازوں پر نہیں: جیسے کہ تصدیق شدہ فون نمبر، لاگ ان، یا وہ آرڈر ریفرنس جو کسٹمر چیٹ میں فراہم کرتا ہے۔
4. 4wa_id کی عدم موجودگی کو کبھی بھی نئے کسٹمر کے طور پر نہ لیں۔ اس کا مطلب صرف یہ ہے کہ اس ایونٹ پر نمبر شیئر نہیں کیا جا سکتا۔

آپ مائیگریشن کیسے کرتے ہیں؟ مرحلہ وار چیک لسٹ

1. 1webhook پارسرز کو اپ ڈیٹ کریں تاکہ وہ user_id، from_user_id، recipient_user_id اور یوزر نیم کو پڑھ سکیں، اور wa_id اور 'from' کو اختیاری (optional) کے طور پر استعمال کریں۔
2. 2جہاں بھی آپ WhatsApp کانٹیکٹس محفوظ کرتے ہیں، وہاں ایک BSUID کالم (اور اگر آپ ایک مینیجڈ بزنس ہیں تو پیرنٹ BSUID) شامل کریں۔
3. 3بیک فل: اپریل 2026 کے آغاز سے اب تک کے ہر ان باؤنڈ ایونٹ کے لیے، BSUID کو اس فون نمبر کے ساتھ لنک کریں جو آپ کے پاس پہلے سے موجود ہے۔
4. 4نئے BSUID کو کسٹمر کے ساتھ دوبارہ لنک کر کے user_changed_user_id سسٹم میسج اور user_id_update webhook کو ہینڈل کریں۔
5. 5اپنے سینڈ پاتھ (send path) میں وصول کنندہ (recipient) پیرامیٹر شامل کریں، اور جب آپ کے پاس فون نمبر نہ ہو تو اسے بطور فال بیک استعمال کریں۔
6. 6OTP کو فون نمبر پر روٹ کریں، کبھی بھی BSUID پر نہیں، اور SMS یا وائس کو فال بیک چینل کے طور پر رکھیں ۔
7. 7WhatsApp Manager، Meta Business Suite یا Username API کے ذریعے اپنا بزنس یوزر نیم محفوظ کریں۔
8. 8یوزر نیمز کے آپ کے کسٹمرز تک پہنچنے سے پہلے، یوزر نیم سے فعال اکاؤنٹ کے ساتھ ٹیسٹ کریں۔

اگر BroadNet آپ کا WhatsApp فراہم کنندہ ہے، تو پروڈکشن کوڈ تبدیل کرنے سے پہلے ٹیسٹ رسائی کی درخواست کریں اور اس بات کی تصدیق کریں کہ آپ کے اکاؤنٹ کے لیے webhooks میں BSUID فیلڈز کیسے نظر آتی ہیں۔ ہمارے developer hub اور WhatsApp Business API page میں تفصیلات موجود ہیں، اور omnichannel routing اس SMS فال بیک کو ہینڈل کرتا ہے جس پر اب آتھنٹیکیشن فلو منحصر ہیں۔

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

WhatsApp BSUID کیا ہے؟

ایک بزنس کے دائرہ کار میں موجود یوزر آئی ڈی: یہ ایک ایسی شناخت ہے جو Meta ہر WhatsApp صارف کو ہر بزنس پورٹ فولیو کے لیے فراہم کرتا ہے، تاکہ بزنس صارف کا فون نمبر جانے بغیر اسے میسج بھیج سکے۔ یہ webhooks میں user_id کے طور پر ظاہر ہوتا ہے۔

BSUID کیسا دکھتا ہے؟

ایک ISO 3166 الفا-2 کنٹری کوڈ، ایک نقطہ، اور پھر 128 تک الفابیٹک اور نمبر والے حروف، مثال کے طور پر US.13491208655302741918۔ مینیجڈ بزنسز کے لیے پیرنٹ BSUIDs میں ENT شامل ہے، مثال کے طور پر US.ENT.11815799212886844830۔

جب صارفین یوزر نیم اپنائیں گے تو کیا میں ان کا فون نمبر کھو دوں گا؟

صرف کچھ webhooks میں۔ اگر آپ نے گزشتہ 30 دنوں میں اس نمبر پر کوئی میسج یا کال کی ہے، یا اگر صارف آپ کی کانٹیکٹ بک میں موجود ہے، تو نمبر پھر بھی شامل ہوگا۔ ورنہ wa_id کو چھوڑ دیا جاتا ہے اور آپ کو صرف BSUID موصول ہوتا ہے۔

کیا میں BSUID کو میسجز بھیج سکتا ہوں؟

جی ہاں، جولائی 2026 سے، send API کے recipient پیرامیٹر کا استعمال کرتے ہوئے یہ ممکن ہے۔ ون-ٹیپ، زیرو-ٹیپ اور کاپی-کوڈ آتھنٹیکیشن ٹیمپلیٹس کے علاوہ ہر قسم کا میسج کام کرتا ہے، کیونکہ ان کے لیے صارف کا فون نمبر ضروری ہوتا ہے۔

کیا میں BSUID کو آتھنٹیکیشن (OTP) ٹیمپلیٹس بھیج سکتا ہوں؟

نہیں۔ ون-ٹیپ، زیرو-ٹیپ اور کاپی کوڈ آتھنٹیکیشن ٹیمپلیٹس کے لیے فون نمبر کی ضرورت ہوتی ہے۔ ہر اکاؤنٹ کے لیے ایک تصدیق شدہ فون نمبر رکھیں اور متبادل کے طور پر SMS یا وائس OTP کا استعمال کریں۔

کیا BSUIDs مختلف بزنس پورٹ فولیو پر کام کرتے ہیں؟

نہیں۔ ایک BSUID ایک مخصوص بزنس پورٹ فولیو اور صارف کے جوڑے کے لیے منفرد ہوتا ہے۔ مینیجڈ بزنسز پیرنٹ BSUID کے بارے میں Meta سے پوچھ سکتے ہیں، جو ان پورٹ فولیو پر کام کرتے ہیں جو ایک ساتھ رجسٹرڈ ہوں۔

کیا BSUID کبھی تبدیل ہوتا ہے؟

جی ہاں۔ جب صارف اپنا فون نمبر تبدیل کرتا ہے تو اسے دوبارہ تیار (regenerate) کیا جاتا ہے، اور Meta اس کی نشاندہی user_changed_user_id سسٹم میسج اور user_id_update webhook کے ذریعے کرتا ہے۔

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

29 جون 2026 سے، WhatsApp Manager، Meta Business Suite یا Username API کے ذریعے دستیاب ہوگا۔ ایک منظور شدہ یوزر نیم اس وقت فعال ہو جاتا ہے جب یوزر نیم فیچر لانچ ہوتا ہے، اور یہ آپ کے بزنس فون نمبر کو نہیں چھپاتا۔

ذرائع

• ڈویلپرز کے لیے Meta، Business-scoped user IDs (فارمیٹ، ٹائم لائن، webhook فیلڈز، کانٹیکٹ بک، سینڈ پیرامیٹر، آتھنٹیکیشن-ٹیمپلیٹ استثنیٰ)، رسائی کی تاریخ 26 ستمبر 2026۔
• Meta کے بارے میں، اپنا WhatsApp یوزر نیم ریزرو کرنے کا وقت آگیا ہے، 29 جون 2026، رسائی کی تاریخ 26 ستمبر 2026۔