# أسماء مستخدمي WhatsApp وBSUIDs: ما الذي سيتغير بالنسبة لـ OTP وCRM وwebhooks

> تعني أسماء مستخدمي WhatsApp أن الشركات قد لا ترى رقم هاتف العميل. الحل من Meta هو معرف المستخدم الخاص بالأعمال (BSUID). إليك تفاصيل هذا المعرف، وما الذي لا يزال يتطلب رقم هاتف، وكيفية نقل تدفقات webhooks وCRM وOTP.

- الرابط الأساسي: https://www.broadnet.me/ar/blog/whatsapp-usernames-bsuid-developer-guide
- اللغة: ar
- آخر تحديث: 2026-10-20
- الناشر: BroadNet (https://www.broadnet.me)

- تاريخ النشر: 2026-09-26
- الكاتب: BroadNet Engineering

يُعد معرف المستخدم الخاص بنطاق الأعمال (BSUID) هو المعرف الذي تضعه Meta الآن في كل خطاف ويب (webhook) WhatsApp حتى تتمكن الشركة من مراسلة المستخدم دون معرفة رقم هاتفه. وهو موجود لأن WhatsApp تقدم أسماء المستخدمين: بمجرد أن يقوم المستخدم بتفعيل أحدها، قد لا تتلقى الشركة التي لم تتواصل معه مؤخرًا الرقم بعد الآن. يوضح هذا الدليل المقدم من الفريق الهندسي لـ BroadNet التنسيق، والجدول الزمني، وما الذي لا يزال يتطلب رقم هاتف، وكيفية ترحيل خطافات الويب (webhooks)، وسجلات نظام إدارة علاقات العملاء (CRM)، وتدفقات OTP.

## النقاط الرئيسية المستخلصة

- ظهرت معرفات BSUID في خطافات ويب WhatsApp منذ أوائل أبريل 2026، لكل مستخدم، سواء استخدم اسم مستخدم أم لا.
- يبدو US.13491208655302741918 مثل BSUID: رمز دولة مكون من حرفين (alpha-2) لـ ISO 3166، تليها نقطة، ثم ما يصل إلى 128 حرفًا رقميًا.
- إنه فريد لكل زوج من محفظة الأعمال (business portfolio) والمستخدم، ويتم إعادة إنشائه إذا قام المستخدم بتغيير رقم هاتفه.
- منذ يوليو 2026، يمكنك إرسال رسائل إلى BSUID، باستثناء قوالب المصادقة (Authentication) ذات النقرة الواحدة، والصفرية، ونسخ الرمز، والتي لا تزال تتطلب رقم الهاتف.
- تقول Meta إن الشركاء والشركات المتكاملة مباشرة يجب أن تدعم BSUID لتجنب فقدان القدرة على معالجة الرسائل من مستخدمي اسم المستخدم.
- احتفظ برقم هاتف E.164 الذي تم التحقق منه كمرساة للهوية لـ OTP، والرجوع الاحتياطي إلى SMS وفحوصات الاحتيال. تعامل مع BSUID كمفتاح لقناة WhatsApp.

## ما هو معرف المستخدم الخاص بنطاق الأعمال؟

تُعرف Meta الـ BSUID بأنها "معرف مستخدم فريد يمكن استخدامه لمراسلة مستخدم WhatsApp عندما لا تعرف رقم هاتفه" ([Meta، معرفات المستخدم الخاصة بنطاق الأعمال](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/)). التنسيق هو بلد المستخدم كرمز دولة (alpha-2) لـ ISO 3166، تليها نقطة، وما يصل إلى 128 حرفًا رقميًا، على سبيل المثال US.13491208655302741918.

ثلاث خصائص تهم تصميم النظام:

- النطاق. معرف BSUID فريد لمحفظة أعمال (business portfolio) واحدة ومستخدم واحد. يمتلك نفس الشخص معرف BSUID مختلفًا لكل محفظة أعمال (business portfolio) يتحدث إليها، لذا لا يمكنك استخدامه لمطابقة العملاء عبر محافظ أعمال غير مرتبطة.
- الاستقرار. يتم إعادة إنشائه عندما يقوم المستخدم بتغيير رقم هاتفه. ترسل Meta خطاف ويب (webhook) لرسالة نظام من النوع user_changed_user_id، وخطاف ويب user_id_update منفصل، عند حدوث ذلك.
- الـ BSUID الأبوية. يمكن للشركات المُدارة التي تمتلك عدة محافظ أعمال (business portfolio) أن تطلب من جهة الاتصال الخاصة بـ Meta التسجيل في الـ BSUID الأبوية، والتي تحتوي على ENT (على سبيل المثال US.ENT.11815799212886844830) وتعمل عبر جميع المحافظ المسجلة.

## لماذا تقوم WhatsApp بتقديم أسماء المستخدمين؟

من أجل الخصوصية. أعلنت Meta في 29 يونيو 2026 أنه يمكن للأشخاص حجز اسم مستخدم لاستخدامه "في وقت لاحق من هذا العام"، وأنه عندما يقوم مستخدم بتفعيل أحدها، فإن الشخص أو الشركة التي يراسلها للمرة الأولى لن يرى رقم هاتفه بعد الآن ([حول Meta](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/)). تقول وثائق المطورين الخاصة بـ Meta إن أسماء المستخدمين سيتم طرحها تدريجياً في عام 2026.

يمكن للشركات الحصول على أسماء مستخدمين أيضاً. بدءاً من 29 يونيو 2026، يمكن للشركة المطالبة باسم مستخدم قامت WhatsApp بحجزه لها من خلال WhatsApp Manager، أو Meta Business Suite، أو Username API، وتصبح أسماء المستخدمين المعتمدة نشطة عند إطلاق الميزة. اسم مستخدم الشركة لا يخفي رقم هاتف الشركة.

## ما هو الجدول الزمني؟

| التاريخ | ما حدث أو ما سيحدث | ما ينبغي على المطورين فعله |
|---|---|---|
| أوائل أبريل 2026 | تبدأ الـ BSUID في الظهور في خطافات ويب الرسائل (user_id) | تخزين الـ BSUID جنباً إلى جنب مع رقم الهاتف في كل حدث وارد |
| 29 يونيو 2026 | يبدأ حجز اسم المستخدم للمستخدمين والشركات | احجز اسم المستخدم الخاص بأعمالك؛ خطط للمستخدمين الذين لا يملكون أرقاماً |
| يوليو 2026 | دعم إرسال الرسائل إلى BSUID متاح في API | أضف وسيط recipient إلى مسار الإرسال الخاص بك |
| خلال عام 2026 (تدريجياً) | يتم طرح أسماء المستخدمين للمستخدمين | توقع وصول خطافات ويب (webhooks) واردة مع BSUID وبدون رقم هاتف |

## هل ستفقد رقم هاتف العميل؟

أحياناً. يظهر BSUID في جميع خطافات ويب الرسائل. يتم تضمين رقم الهاتف (wa_id، و from في الرسائل الواردة) فقط عندما يكون واحد على الأقل من هذه الأمور صحيحاً، وفقاً لـ Meta:

- لقد أرسلت رسالة أو أجريت مكالمة إلى رقم هاتف المستخدم خلال الـ 30 يوماً التي سبقت تشغيل خطاف الويب؛
- لقد تلقيت رسالة أو مكالمة من رقم هاتف المستخدم خلال تلك الـ 30 يومًا؛ أو
- المستخدم موجود في دفتر جهات الاتصال الخاص بك.

يتم تقييم فترة البحث لمدة 30 يومًا لكل رقم هاتف أعمال، لذا فإن العميل المعروف لخط المبيعات الخاص بك قد يكون غير معروف لخط الدعم الخاص بك. دفتر جهات الاتصال هو ميزة مستضافة بواسطة Meta تقوم بتخزين أرقام الهواتف و BSUID بعد التفاعل الأول، لذا يمكن لخطافات الويب (webhooks) اللاحقة الاستمرار في حمل الرقم حتى بعد اعتماد المستخدم لاسم مستخدم. هذه الميزة مفعلة افتراضيًا ويمكن إيقاف تشغيلها في Meta Business Suite ضمن إعدادات الأعمال، معلومات الأعمال. اتركها مفعلة ما لم يكن لديك سبب لعدم القيام بذلك.

## ما الذي لا يزال يتطلب رقم هاتف؟

Meta صريح: "يمكن استخدام BSUID لإرسال أي نوع من الرسائل باستثناء قوالب المصادقة (Authentication) التي تتطلب نقرة واحدة، أو صفر نقرة، أو نسخ الرمز، والتي تتطلب أرقام هواتف المستخدمين". خارج WhatsApp، فإن أي شيء يعمل على شبكة الهاتف المحمول يتطلب الرقم أيضًا.

| المهمة | يعمل مع BSUID فقط؟ | ما تحتاجه |
|---|---|---|
| الردود ذات الصيغة الحرة، والوسائط، والرسائل التفاعلية | نعم | BSUID في وسيط (parameter) recipient |
| القوالب التسويقية (Marketing) والقوالب الخدمية (Utility) | نعم | BSUID في المعلمة recipient |
| قوالب مصادقة (Authentication) بنقرة واحدة، وبدون نقرة، ونسخ الرمز (OTP) | لا | رقم هاتف المستخدم |
| الاحتياط بـ SMS أو RCS عند فشل WhatsApp | لا | رقم هاتف E.164 |
| البحث عن HLR، والتحقق من تبديل الشريحة (SIM swap)، والتحقق من الرقم | لا | رقم هاتف E.164 |
| مطابقة العميل مع نفس الشخص في محفظة أعمال (business portfolio) أخرى | لا | معرف العميل الخاص بك أو رقم الهاتف |

## كيف يبدو الـ webhook قبل وبعد؟

قبل BSUID، كانت كتلة جهات الاتصال في webhook الرسائل تحمل رقم الهاتف في wa_id، وكانت معظم عمليات التكامل تستخدمه كمفتاح للعميل. يضيف مثال Meta لكائن جهات الاتصال الجديد اسم المستخدم، وBSUID، وحيثما يكون مفعلاً، الـ BSUID الأصل (parent BSUID)؛ وتكون wa_id موجودة فقط عندما يمكن مشاركة الرقم:

```
"contacts": [
  {
    "profile": {
      "name": "<USER_DISPLAY_NAME>",
      "username": "<USERNAME>"
    },
    "wa_id": "<USER_PHONE_NUMBER>",
    "user_id": "<BSUID>",
    "parent_user_id": "<PARENT_BSUID>"
  }
]
```

تحمل الرسائل الواردة أيضاً from_user_id (و from_parent_user_id إذا كانت مفعلة)، وتحمل webhooks الحالة recipient_user_id، والتي تقول Meta إنها تُضبط دائماً على BSUID الخاص بالمستخدم. للإرسال، ضع BSUID في معامل recipient الجديد. يمكنك تعيين المعلمة to (رقم الهاتف) أو المعلمة recipient (BSUID) أو كلتيهما؛ وعند وجود الاثنتين تكون الأولوية لرقم الهاتف:

```
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "<BSUID>",
  "type": "text",
  "text": {
    "body": "<BODY_TEXT>"
  }
}
```

تتضمن استجابة الإرسال بعد ذلك user_id في مصفوفة جهات الاتصال الخاصة بها، وتصبح wa_id اختيارية. إذا افترض المحلل الخاص بك أن wa_id موجود دائماً، فسوف يفشل مع أول مستخدم لديه اسم مستخدم. يمكنك لصق حمولات حقيقية في [مفتش حمولة webhook الخاص بنا](https://www.broadnet.me/tools/webhook-payload-inspector) للتحقق من الحقول التي تستلمها عملية التكامل الخاصة بك فعلياً.

## ما الذي سيتعطل بالنسبة لـ OTP؟

قوالب المصادقة (Authentication templates) التي تحتوي على أزرار النقر لمرة واحدة، أو عدم النقر، أو نسخ الرمز، لا يمكن إرسالها إلى BSUID. إذا وصلك مستخدم باسم مستخدم عبر WhatsApp ولم يكن لديك رقم هاتف له، فلا يمكنك إرسال WhatsApp OTP من تلك الأنواع إليه. وهذا له نتيجتان لتدفقات التحقق:

- قم بجمع والتحقق من رقم الهاتف عند التسجيل، بتنسيق E.164، وتخزينه كعنوان التحقق الخاص بالحساب. لا تعتمد على webhook الـ WhatsApp لتسليمه لك لاحقاً. راجع [ما هو E.164](https://www.broadnet.me/answers/what-is-e164).
- حافظ على قناة تعمل على الرقم نفسه. SMS OTP، وOTP الصوتية، وفحوصات الشبكة الصامتة، كلها تعمل على رقم الهاتف، وهذا هو السبب في أن التصميم متعدد القنوات مع الرجوع التلقائي إلى قناة أخرى يظل صامداً أمام هذا التغيير دون تغيير. يغطي [دليل OTP متعدد القنوات الخاص بنا](https://www.broadnet.me/blog/multichannel-otp-verification-api-2026) و[منتج BroadNet OTP](https://www.broadnet.me/products/otp) هذا النمط.

## ما الذي سيتعطل بالنسبة لأنظمة إدارة علاقات العملاء (CRM) وإزالة تكرار العملاء؟

تعتمد معظم أنظمة إدارة علاقات العملاء (CRM) مفتاح جهة اتصال WhatsApp على رقم الهاتف لأن SMS، والصوت، وWhatsApp كانت جميعها تشاركه سابقاً. بعد ظهور أسماء المستخدمين، قد تصل جهة اتصال واردة جديدة تحتوي فقط على BSUID. إذا أنشأت سجلاً جديداً في نظام إدارة علاقات العملاء (CRM) لها، فستقوم بتكرار العملاء تدريجياً. أربع قواعد تحافظ على نظافة البيانات:

1. قم بنمذجة BSUID كهوية قناة، وليس كمعرف العميل. يمكن لعميل واحد امتلاك عدة BSUID (واحد لكل محفظة الأعمال (business portfolio)) وواحد جديد بعد تغيير الرقم.
2. احتفظ بجدول مطابقة لـ BSUID، والمحفظة، ورقم الهاتف عندما يكون معروفاً، وتاريخ أول ظهور وآخر ظهور، وقم بتحديثه عند كل webhook، بما في ذلك user_id_update.
3. ادمج بناءً على الأدلة، وليس على التخمين: رقم هاتف تم التحقق منه، أو عملية تسجيل دخول، أو مرجع طلب يقدمه العميل في الدردشة.
4. لا تعامل أبداً غياب wa_id كعميل جديد. هذا يعني فقط أنه لا يمكن مشاركة الرقم في ذلك الحدث.

## كيف تقوم بالهجرة؟ قائمة مرجعية خطوة بخطوة

1. قم بتحديث محللات webhook لقراءة user_id، وfrom_user_id، وrecipient_user_id واسم المستخدم، ولتعامل wa_id وfrom كخيارات اختيارية.
2. أضف عمود BSUID (و BSUID الأصل إذا كنت شركة مدارة) أينما قمت بتخزين جهات اتصال WhatsApp.
3. تعبئة البيانات السابقة: لكل حدث وارد منذ أوائل أبريل 2026، قم بربط BSUID برقم الهاتف الذي تمتلكه بالفعل.
4. تعامل مع رسالة النظام user_changed_user_id وwebhook الـ user_id_update عن طريق إعادة ربط BSUID الجديد بالعميل.
5. أضف المعلمة recipient إلى مسار الإرسال الخاص بك، والرجوع إليها عندما لا يكون لديك رقم هاتف.
6. قم بتوجيه OTP إلى رقم الهاتف، ولا توجهه أبداً إلى BSUID، واجعل SMS أو الصوت هي القناة البديلة.
7. احجز اسم المستخدم الخاص بأعمالك في WhatsApp Manager، أو Meta Business Suite أو من خلال Username API.
8. اختبر باستخدام حساب مفعل فيه خاصية اسم المستخدم قبل أن تصل أسماء المستخدمين إلى عملائك.

إذا كان BroadNet هو مزود WhatsApp الخاص بك، فاطلب إمكانية الوصول للاختبار وتأكد من كيفية ظهور حقول BSUID في الـ webhooks الخاصة بحسابك قبل تغيير كود الإنتاج. يتوفر التفاصيل في [مركز المطورين](https://www.broadnet.me/developers) و[صفحة WhatsApp Business API](https://www.broadnet.me/products/whatsapp-business-api)، ويتولى [التوجيه متعدد القنوات](https://www.broadnet.me/products/omnichannel) التعامل مع الرجوع إلى SMS الذي تعتمد عليه تدفقات المصادقة الآن.

## الأسئلة الشائعة

### ما هو WhatsApp BSUID؟

معرف مستخدم بنطاق الأعمال: هو معرف تخصصُه Meta لكل مستخدم WhatsApp لكل محفظة أعمال (business portfolio)، بحيث يمكن للشركة مراسلة المستخدم دون معرفة رقم هاتفه. يظهر كـ user_id في الـ webhooks.

### كيف يبدو شكل BSUID؟

رمز دولة ISO 3166 بنظام alpha-2، ثم نقطة، ثم ما يصل إلى 128 حرفاً ورقماً، على سبيل المثال US.13491208655302741918. تشمل الـ BSUID الأصلية للأعمال المُدارة ENT، على سبيل المثال US.ENT.11815799212886844830.

### هل سأفقد رقم هاتف العميل عندما يعتمد اسم مستخدم؟

فقط في بعض الـ webhooks. لا يزال الرقم مُدرجاً إذا كنت قد تبادلت رسالة أو مكالمة مع ذلك الرقم في آخر 30 يوماً، أو إذا كان المستخدم موجوداً في دفتر جهات الاتصال الخاص بك. خلاف ذلك، يتم حذف wa_id ولن تتلقى سوى BSUID.

### هل يمكنني إرسال رسائل إلى BSUID؟

نعم، منذ يوليو 2026، باستخدام وسيط recipient الخاص بإرسال API. تعمل جميع أنواع الرسائل باستثناء قوالب المصادقة (Authentication) بنقرة واحدة، وصفر نقرة، ونسخ الكود، والتي تتطلب رقم هاتف المستخدم.

### هل يمكنني إرسال قوالب مصادقة (OTP) إلى BSUID؟

لا. تتطلب قوالب المصادقة (Authentication) بنقرة واحدة، أو صفر نقرة، أو نسخ الرمز رقم الهاتف. احتفظ برقم هاتف موثق لكل حساب واستخدم SMS أو OTP الصوتي كخيار احتياطي.

### هل تعمل الـ BSUID عبر محافظ الأعمال (business portfolio)؟

لا. الـ BSUID فريدة لكل زوج من محفظة الأعمال والمستخدم. يمكن للشركات المُدارة أن تسأل Meta عن الـ BSUID الأصل (parent BSUID)، والتي تعمل عبر المحافظ المسجلة معاً.

### هل تتغير الـ BSUID أبداً؟

نعم. يتم إعادة إنشائها عندما يغير المستخدم رقم هاتفه، ويقوم Meta بالإشارة إلى ذلك عبر رسالة نظام user_changed_user_id وخطاف ويب (webhook) user_id_update.

### كيف يمكنني حجز اسم المستخدم الخاص بأعمالي؟

اعتباراً من 29 يونيو 2026، من خلال WhatsApp Manager، أو Meta Business Suite، أو Username API. يصبح اسم المستخدم المعتمد نشطاً عند إطلاق ميزة اسم المستخدم، وهي لا تخفي رقم هاتف أعمالك.

## المصادر

- Meta للمطورين، [معرفات المستخدم المحددة بنطاق الأعمال](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (التنسيق، الجدول الزمني، حقول خطاف الويب، دفتر الاتصال، وسيط الإرسال، استثناء قالب المصادقة (Authentication))، تم الوصول إليها في 26 سبتمبر 2026.
- حول Meta، [حان الوقت لحجز اسم المستخدم WhatsApp الخاص بك](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/)، 29 يونيو 2026، تم الوصول إليها في 26 سبتمبر 2026.