الأسئلة الشائعة حول دعم BSUID واسم المستخدم

دعم Chakra Chat لإطلاق Meta لمعرّفات BSUID وأسماء المستخدمين

مع بدء Meta بطرح أسماء المستخدمين ومعرّفات المستخدمين المقيّدة بنطاق الأعمال (BSUID)، حيث يصبح wa_id الخاص بالعميل (رقم الهاتف) مشروطًا، بينما يكون user_id (BSUID) موجودًا دائمًا، تجيب هذه الوثيقة عن الأسئلة الشائعة حول خطة ChakraHQ لدعم تمرير بيانات webhook وواجهة send API.

تمرير بيانات Webhook

1. هل تمرّر ChakraHQ user_id (BSUID) و username في بيانات Webhook للرسائل الواردة؟

نعم، تمرّر Chakra بالفعل BSUID (user_id) وusername عندما تكون هذه الحقول متاحة في الأحداث الأصلية من Meta لعميلك وحساب WABA

2. هل تمرّر ChakraHQ user_id (BSUID) و username في Webhook الحالة (تم الإرسال/تم التسليم/تمت القراءة)؟

نعم، تمرّر Chakra بالفعل BSUID (user_id) وusername عندما تكون هذه الحقول متاحة في الأحداث الأصلية من Meta لعميلك وحساب WABA

3. هل سيُضمَّن user_id (BSUID) و username في استجابة list-chat-messages-for-phone-number ؟

لا. تهدف واجهة API هذه إلى عرض رسائل المحادثة الخاصة برقم هاتف

الإرسال باستخدام BSUID

4. هل تقبل نقطة نهاية الإرسال/الرد BSUID بوصفه معرّف المستلم، بدلًا من اشتراط رقم هاتف؟

تدعم واجهة API لتمرير الرسائل مُعدِّلات المستلم لإرسال رسائل الجلسة والقوالب

إرسال رسالة قالب إلى رقم هاتف لا يدعم BSUID

5. هل يمكن للتاجر الرد على جهة اتصال لا يظهر منها سوى اسم المستخدم ورقم هاتفها مخفي؟

يدعم صندوق وارد Chakra Chat بالفعل الرسائل والمحادثات لجهات الاتصال التي يكون رقم هاتفها مخفيًا، لكن يتوفر لها BSUID

الجدول الزمني

6. متى سيتوفر دعم تمرير بيانات Webhook لـ BSUID/اسم المستخدم؟

يدعم Chakra Chat الحقول الجديدة بالفعل، لكن Meta تطرح الدعم تدريجيًا في أنحاء العالم. لذا، إذا كانت BSUID/أسماء المستخدمين متاحة في منطقتك أو لحساب WABA، فستكون متاحة لك عبر Chakra Chat.

7. متى سيتوفر دعم الإرسال باستخدام BSUID؟

يدعم Chakra Chat بالفعل إرسال رسائل الجلسة والقوالب باستخدام BSUID للمستلم. يُرجى الرجوع إلى قسم «الإرسال باستخدام BSUID»

8. مع بدء طرح Meta في LATAM في سبتمبر 2026، هل سيكون دعم ChakraHQ جاهزًا في الوقت المناسب لهذه المنطقة؟

نعم

`user_id_update` حدث

9. هل ستحوّل ChakraHQ خطاف الويب user_id_update الخاص بـ Meta (الذي يُفعّل عند تغيير رقم هاتف المستخدم، ما يؤدي إلى إعادة إنشاء BSUID)؟

حدث user_id_update غير متاح عبر خطافات الويب حتى الآن.

10. كيف سيكون شكل/بنية حمولة الحدث user_id_update الذي يتم تحويله؟

حدث user_id_update غير متاح عبر Chakra Webhooks حتى الآن.

تسمية الحقول

11. ما أسماء الحقول التي ستستخدمها ChakraHQ لكل من BSUID واسم المستخدم في الحمولات المُمررة؟

تطابق بنية حدث خطاف الويب المُمرر بنية حدث خطاف الويب الخام من Meta. وعلى وجه التحديد، الحقول التالية في حدث التغيير

contacts
- user_id — خاصية جديدة. ستُضبط على BSUID الخاص بالمستخدم.
messages
- from_user_id — خاصية جديدة. ستُضبط على BSUID الخاص بالمستخدم.

يمكنك العثور على مثال لبنية الحدث هنا - https://apidocs.chakrahq.com/doc-919167#sample-inbound-text-message-event

12. هل ستستخدم ChakraHQ أسماء الحقول الأصلية في Meta (contacts[].user_id, messages[].from_user_id) أم حقولًا مخصصة/معاد تسميتها (مثل contact.userId)?

نعم، سيستخدم حدث خطاف الويب المُمرر أسماء الحقول الأصلية في Meta.

13. أين يمكننا العثور على توثيق لأسماء الحقول/المخطط الدقيق، حتى نتمكن من إنشاء المحلّل دون تخمين؟