كل أسبوع حد يسألني عن «الـBusiness AI» بتاع ميتا اللي بيرد على العملاء، وكل مرة السؤال بيكون مبني على كلام متداول مش على توثيق. فقعدت أقرا صفحات المطورين بنفسي، والنتيجة أوضح وأضيق من اللي بيتقال.
المنتج الموثق اسمه Meta Business Agent، وهو على واتساب بس، وفي قطاعات كاملة مستثناة منه بالنص. لو انت في واحد منها، مفيش حاجة تحضرها.
هو ايه بالظبط في كلام التوثيق
صفحة نظرة عامة على Meta Business Agent بتوصفه بانه وكيل بيتعامل مع محادثات العملاء على مدار الساعة بنبرة علامتك على واتساب. والصفحة بالانجليزي.
واللي بيقدر يعمله، زي ما الصفحة بتعدده: تضيف معرفة من معلومات النشاط والأسئلة المتكررة ومواقع وملفات، وتظبط النبرة والأولويات بتعليمات، وتوصل الـAPIs بتاعتك مع اشتراكات ويب هوك عشان يعمل حاجات فعلية زي حجز موعد او تأكيد دفعة، وتسلّم المحادثة بينه وبين تطبيقك في احداث او مسارات معينة، وتختبره برسائل تجريبية وتقيس الاداء قبل وبعد التشغيل.
خد بالك من الترتيب ده. الحاجة اللي بتفرقه عن اي شات بوت هي البند التالت: الاكشنز. الباقي موجود في عشرين أداة تانية.
على واتساب بس، ودي مش تفصيلة
الصفحة مش بتذكر غير واتساب. مفيش ماسنجر، مفيش انستجرام دايركت، مفيش تعليقات. اللي بيتداول عن «وكيل واحد على التلات منصات» مش موجود في الصفحة اللي قريتها. وده مش بيقلل منه، لان واتساب هو القناة اللي ميتا بتبني فيها اكتر حاجة دلوقتي، وشوفنا ده في اعلانات WhatsApp Status وفي ترويج قنوات واتساب.
والشرط التاني في نفس الفقرة أهم: الرقم لازم يكون تابع لحساب واتساب بيزنس على منصة المؤسسات WhatsApp Business Platform، سواء مباشر او من خلال Solution Partner او Embedded Signup. والصفحة بتقول بالنص انه مش تطبيق واتساب بيزنس العادي.
يعني لو نشاطك شغال على تطبيق واتساب بيزنس من الموبايل، انت مش داخل في المعادلة دي من الاساس. الفرق بين المسارين كتبته وكالة KF في واتساب API مقابل واتساب بيزنس العادي وأيهما تحتاج، وهي نفس النقطة اللي بتحدد هنا هل انت مؤهل ولا لأ.
القطاعات المستثناة بالنص
دي الفقرة اللي بتوفر على ناس كتير وقت. الصفحة بتقول ان حساب واتساب بيزنس بتاع الرقم لازم يكون في قطاع مدعوم، وبتستثني: التمويل، والجهات الحكومية، والصحة. وكمان الكحوليات، والمقامرة، والادوية اللي بتتصرف من غير روشتة، وخدمات الزواج.
وفوق ده لازم يكون في تصنيف نشاط صحيح متظبط على الحساب. يعني الحساب اللي تصنيفه «Other» مش بس مش مؤهل، هو كمان مش واضح للنظام.
استثناء التمويل والصحة منطقي ومتوقع، وهو نفس المنطق اللي بيخلي المنصات تحط قيود على استهداف الفئات الحساسة. اللي مش متوقع هو استثناء الجهات الحكومية، وده بيقفل باب كان كتير بيخططوا له في السعودية والامارات.
الشروط التقنية قبل ما تبدأ
| الشرط | الموثق | اللي يوقع الناس |
|---|---|---|
| الاذونات | whatsapp_business_messaging و whatsapp_business_management | صفحة النظرة العامة بتذكر الاول بس. صفحة البدء بتطلب الاتنين |
| نوع الحساب | منصة المؤسسات، مباشر او عن طريق شريك | تطبيق واتساب بيزنس العادي مش مقبول |
| حالة الحساب | الحساب والنشاط المالك مش مقيدين ولا محظورين على واتساب | قيد قديم على الحساب بيمنع التشغيل وانت مش فاكره |
| البلد | النشاط لازم يكون في بلد مصرّح له | التوثيق مش بيسمي ولا بلد واحدة |
| وكيل تاني | الرقم ميكونش شغال عليه وكيل ذكاء اصطناعي تاني | تكامل وكيل مصرّح له شغال بيقفل الباب تماماً |
| التوثيق والثقة | لازم يحقق متطلبات الثقة والتوثيق | التحقق من النشاط مش خطوة اختيارية هنا |
والصفحة بتقول حاجة تريح: نقطة الفحص الرسمية هي endpoint الاهلية، وهي المرجع الحاسم لرقم معين. يعني متحاولش تستنتج من اللستة دي، اسأل الـAPI.
الاعداد: الترتيب الموثق
صفحة البدء بتحدد ترتيب مش ممكن تقفزه. والصفحة بالانجليزي.
- تجمّع معرّف حساب واتساب بيزنس ومعرّف محفظة النشاط ومعرّف التطبيق، والتطبيق لازم يكون عليه الاذنين.
- تفعّل الخدمة من WhatsApp Manager وتقبل شروط الاستخدام. والصفحة بتقول ان التاب ده مش بيظهر الا لو في رقم واحد على الاقل في حسابك مؤهل.
- تضيف وسيلة دفع من Billing Hub. ومن غيرها، ضبط الجمهور على EVERYONE بيفشل بخطأ 400، بينما ALLOWLISTED_ONLY بيشتغل من غير وسيلة دفع.
- تعمل مستخدم نظام بصلاحية Admin، وتسند له التطبيق وحساب واتساب بيزنس مع صلاحية ادارة الارقام.
- تولّد توكن وصول، وتشترك التطبيق على الحساب بطلب POST على subscribed_apps، وتتأكد بطلب GET.
- تشترك في حقول الويب هوك التلاتة: messages و standby و messaging_handovers.
- تنادي الـOnboarding، وبعدها Settings عشان تشغّل الوكيل. ولو رجعلك «Conversation routing setup required»، ده مش عطل، ده دليل التوجيه ناقص.
الخطوة اللي محتاجة مطور مش ميديا باير هي الاكشنز والويب هوك. والباقي ممكن يخلص من الواجهات.
الفاتورة والجمهور: الحاجة اللي بتفشل بصمت
البند التالت فوق هو اخطر بند في الصفحة كلها، ومكتوب في سطر. في ضبط اسمه ai_audience، وليه قيمتين تهمك: EVERYONE و ALLOWLISTED_ONLY.
لو مفيش وسيلة دفع، EVERYONE بيرجع 400 و ALLOWLISTED_ONLY بيشتغل عادي. ومعنى ده عملياً ان ممكن تكون مشغّل الوكيل وشايفه بيرد عليك في الاختبار، وهو مش بيرد على حد تاني خالص، لان الصفحة بتقول ان القائمة البيضاء بتتطبق بس لما الضبط يكون ALLOWLISTED_ONLY.
فلو شغّلت وحسيت ان مفيش محادثات بتوصله، بص على الضبط ده الاول قبل ما تلف على المعرفة والتعليمات. ودي نفس عقلية التشخيص بالترتيب اللي كتبتها قبل كده في هل الذكاء الاصطناعي هياخد شغل الميديا باير: المشكلة في الاعداد قبل ما تكون في الموديل.
تسليم المحادثة لموظف
دي الحاجة اللي كل حد بيسأل عنها، ومحظوظين ان التوثيق فيها صريح. التحكم بينتقل بين الادوار، وطلب التمرير بيترفض لو نقطة الدخول مفيهاش طرف اساسي او فيها اكتر من واحد.
والجملة اللي محتاجة تتعلق على الحيطة: وقف ارسال الرسائل مش بيحرر التحكم. لازم تنادي الـendpoint. يعني لو بنيت منطق «الموظف بدأ يكتب، اسكت الوكيل»، فالوكيل من ناحية النظام لسه ماسك المحادثة، وده بيعمل سلوك غريب مش هتعرف سببه.
وفي تفصيلة مفيدة: حقل metadata سقفه 2000 حرف، وبيتمرر بالنص لتطبيقك في ويب هوك messaging_handovers. دي مساحة كافية انك تبعت معاه حالة المحادثة وقت التسليم، وهي أنضف من انك تدوّر على الحالة دي تاني في نظامك.
وتحديد المستهلك بيتم بواحد بالظبط من to او recipient، مش الاتنين. غلطة بسيطة بتكلف ساعة في التشخيص. والترتيب العام للمراجعة لما حاجة بتتصرف غلط في حساب جديد كتبته في ازاي تراجع حساب اعلانات جديد.
الحدود بصراحة
التوثيق مش بيسمي بلد واحدة. الشرط ان النشاط يكون في بلد مصرّح له موجود، واللستة مش موجودة في الصفحتين اللي قريتهم. فمش هقولك ان مصر او السعودية داخلة ولا برا. الاجابة الوحيدة الموثوقة هي endpoint الاهلية على رقمك انت.
مفيش حدود استخدام منشورة. الصفحتين مش بيحددوا سقف رسائل ولا حصص ولا معدل. فمتخططش على اساس حجم، وجرّب على عينة.
مفيش سعر رسمي قريته. في كلام متداول في الصحافة عن انه هيبدأ مجاني وبعدها باشتراك، وما لقيتش صفحة رسمية من ميتا بتقول كده، فمش هاكتبه كمعلومة. اللي موثق هو ان وسيلة الدفع مطلوبة لضبط EVERYONE، وده شرط تقني مش سعر.
الاسم نفسه فيه لبس. اللي اتكلمت عنه فوق هو Meta Business Agent بالاسم اللي في صفحات المطورين. «Business AI» بتتداول كاسم لنفس الفكرة وفي نفس الوقت بتتداول لحاجات تانية من ميتا، فلو حد عرض عليك «Business AI» اسأله على اي صفحة توثيق بيتكلم.
وما جربتهوش. مفيش عندي رقم مؤهل اشغله عليه دلوقتي، فكل اللي فوق قراءة توثيق لا تجربة تشغيل. ولما اجربه، اللي هيتغير غالباً هو جودة الردود مش الشروط، لان الشروط دي مكتوبة.
والفرق بين ده وبين محادثات Meta AI كاشارة استهداف مهم: الحاجة التانية بتخص اللي بيوصل للمزايدة من محادثات المستخدمين، وكتبتها في محادثات Meta AI كإشارة استهداف للاعلانات. اللي فوق منتج بتشغله انت وبتظبطه، مش اشارة بتتجمع عنك.
أسئلة شائعة
Business AI من ميتا بيشتغل على انستجرام وماسنجر؟
صفحات المطورين اللي قريتها بتتكلم عن واتساب بس. مفيش ذكر لماسنجر ولا انستجرام دايركت في صفحة النظرة العامة. اللي بيتداول عن وكيل واحد على التلات منصات مش موجود في التوثيق ده.
نشاطي في التمويل او العيادات، اقدر استخدمه؟
لأ حسب التوثيق. الصفحة بتستثني التمويل والجهات الحكومية والصحة بالنص، وكمان الكحوليات والمقامرة والادوية اللي بتتصرف من غير روشتة وخدمات الزواج. ولازم يكون في تصنيف نشاط صحيح متظبط على الحساب.
شغّلته وما حدش بيوصله رسايل، ايه السبب الاكثر احتمالاً؟
ابدأ من ضبط ai_audience ووسيلة الدفع. من غير وسيلة دفع في Billing Hub، القيمة EVERYONE بترجع خطأ 400 والقيمة ALLOWLISTED_ONLY بتشتغل، والقائمة البيضاء بتتطبق بس في الحالة التانية. فالوكيل بيرد على اللي في القائمة وبس.
ينفع اشغله على رقم عليه شات بوت دلوقتي؟
التوثيق بيقول ان الرقم مينفعش يكون عليه وكيل ذكاء اصطناعي تاني، وان تكامل وكيل مصرّح له شغال بيمنع تشغيل Meta Business Agent. والفحص الحاسم لرقم معين هو endpoint الاهلية.
المصادر
- صفحة نظرة عامة على Meta Business Agent في توثيق مطوري ميتا. المقتبس منها: وصفه بانه بيتعامل مع محادثات العملاء على مدار الساعة بنبرة العلامة على واتساب، وقائمة القدرات الخمس (المعرفة من معلومات النشاط والاسئلة المتكررة والمواقع والملفات، والتعليمات للنبرة، والاكشنز عن طريق APIs واشتراكات ويب هوك، وتسليم التحكم، والاختبار قبل وبعد التشغيل)، والمتطلبات (حساب واتساب بيزنس برقم، وتطبيق ميتا عليه اذن whatsapp_business_messaging، ورقم مؤهل)، وشروط الاهلية بالكامل: القطاعات المدعومة مع استثناء التمويل والجهات الحكومية والصحة والكحوليات والمقامرة والادوية بدون روشتة وخدمات الزواج، وضرورة تصنيف نشاط صحيح، وان الرقم على منصة المؤسسات وليس تطبيق واتساب بيزنس العادي، وعدم وجود قيد او حظر، وان النشاط في بلد مصرّح له، ومتطلبات الثقة والتوثيق، وان الرقم مينفعش يكون عليه وكيل اخر، وان endpoint الاهلية هو الفحص الحاسم.
- صفحة البدء في نفس التوثيق. المقتبس منها: المتطلبات الاولية (معرّف حساب واتساب بيزنس ومحفظة النشاط والتطبيق، واذنا whatsapp_business_messaging و whatsapp_business_management، ورقم مؤهل)، والتفعيل من WhatsApp Manager وظهور التاب فقط لو في رقم مؤهل، ووسيلة الدفع من Billing Hub مع ان EVERYONE بيفشل بخطأ 400 بدونها بينما ALLOWLISTED_ONLY يعمل، ومستخدم النظام بصلاحية Admin واسناد التطبيق والحساب مع صلاحية ادارة الارقام، والاشتراك بطلب POST على subscribed_apps، وحقول الويب هوك messages و standby و messaging_handovers، وترتيب Onboarding ثم Settings وخطأ Conversation routing setup required، وسقف حقل metadata عند 2000 حرف وتمريره بالنص في ويب هوك messaging_handovers، وتحديد المستهلك بواحد بالظبط من to او recipient، ورفض طلب التمرير لو نقطة الدخول بلا طرف اساسي او بأكثر من واحد، وان وقف الارسال لا يحرر التحكم، وان القائمة البيضاء تُطبق فقط عند ALLOWLISTED_ONLY.