Embedded Signup لعملائك على WhatsApp: تطبيق Tech Provider خاص بك أو صفحة مستضافة
يمكن لمنصة SaaS أن تربط أرقام تطبيق WhatsApp Business لعملائها بـ Cloud API عبر Embedded Signup من Meta بطريقتين. الأولى أن تصبح هي نفسها Meta Tech Provider، وهذا يتطلب التحقق من النشاط التجاري، و App Review بفيديوين، وبناء Embedded Signup الخاص بها. والثانية أن ترسل عملاءها إلى صفحة Embedded Signup مستضافة تديرها جهة تملك هذه الصفة بالفعل، فتستلم الاتصال المكتمل.
تُشغّل easyCoexistence تهيئة Embedded Signup من Meta مع Coexistence في صفحة مستضافة تحمل اسمك، فيربط عملاؤك أرقامهم دون أن تصبح Tech Provider.
عدد العملاء الجدد من الأنشطة التجارية الذين يجوز لـ Tech Provider ضمهم خلال كل 7 أيام متحركة: 10 افتراضياً، و200 بعد التحقق والمراجعة.
تسجيلات الشاشة التي يطلبها App Review من Tech Provider: رسالة مُرسلة ومُستقبلة، وإنشاء قالب.
متوسط مدة App Review لتطبيق WhatsApp كما تذكره Meta.
أقدم إصدار من تطبيق WhatsApp Business يمكن للعميل ربطه عبر Coexistence.
المدة التي يبقى فيها الرمز الذي يعيده Embedded Signup صالحاً ليتمكن الخادم من استبداله برمز الوصول (token) الخاص بالنشاط التجاري للعميل.
ما الطريقتان لتهيئة أرقام عملائك؟
تعتمد الطريقتان على Embedded Signup من Meta مع Coexistence، وتنتهيان في المكان نفسه: رقم العميل على Cloud API، ويبقى يعمل في تطبيق WhatsApp Business، والخادم الخلفي لديك يحتفظ برمز الوصول (token) الخاص بالعميل. الفرق يكمن في من يتحمل متطلبات Meta، وفي الكود المحيط بالنافذة المنبثقة.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
ما الذي تشترطه Meta لتصبح Tech Provider؟
تسرد Meta الخطوات في دليل Become a Tech Provider، الذي يفتحه App Dashboard تحت تهيئة Tech Provider لحالة استخدام WhatsApp:
- تطبيق Meta يتضمن حالة استخدام WhatsApp، ومربوط بـ Business Portfolio الخاصة بك.
- التحقق من النشاط التجاري، وهو الخطوة الأولى: لا تبدأ Meta مراجعة App Review إلا لنشاط تجاري تم التحقق منه.
- إعدادات التطبيق مثل الأيقونة وسياسة الخصوصية والفئة.
- الوصول المتقدم إلى
whatsapp_business_messagingوwhatsapp_business_management، يُمنح عبر App Review مع شرح مكتوب وتسجيل شاشة لكل منهما. - تسجيلان في المجموع: رسالة مُرسلة من تطبيقك ومُستقبلة في WhatsApp، وتطبيقك وهو ينشئ قالب رسائل.
ماذا تبني بعد الموافقة؟
عملية التهيئة نفسها، التي تصفها أدلة Embedded Signup من Meta خطوة بخطوة:
- التدفق على موقعك، عبر Facebook Login for Business و JavaScript SDK من Meta، على نطاقات HTTPS التي تسمح بها في التطبيق.
- تفعيل Coexistence في إعدادات التدفق، مع تسجيل الجلسات، وهو ما تشترطه Meta لها.
- استدعاء من الخادم يستبدل الرمز المُعاد برمز الوصول (token) الخاص بالعميل خلال 30 ثانية.
- خطاف الويب (webhook): اشتراك تطبيقك في حساب كل عميل، بالحقول
account_updateو history وsmb_app_state_syncوsmb_message_echoesفي كل حساب. - مزامنة جهات الاتصال والسجل خلال 24 ساعة من التهيئة، وبعدها يحتاج العميل إلى إلغاء التهيئة وإعادة تشغيل التدفق.
ماذا تتولى الصفحة المستضافة؟
كامل الجانب المنبثق. تُشغّل easyCoexistence تهيئة Embedded Signup مع Coexistence عبر تطبيق Meta الخاص بها بصفتها Tech Provider، في صفحة على easycoexistence.com تعرض اسمك. يتم فيها استبدال الرمز وربط الـ webhook وطلب السجل، ويستلم خادمك معرّف الاتصال. وبوجود webhook_url في الجلسة، ترسل Meta رسائل الرقم مباشرةً إلى خادمك، مع استيراد لمرة واحدة لجهات الاتصال، وسجل محادثات يصل إلى 180 يوماً إذا شاركه العميل. ثم يستدعي كودك Graph API مباشرةً برمز الوصول (token) الخاص بالعميل، بينما تراقب easyCoexistence الرقم وترسل أحداثاً موقّعة عند كل تغيير.
ماذا يرى عميلك؟
صفحة تحمل اسمك وزر اتصال واحد. قبل أن تُفتح نافذة Meta المنبثقة، تطلب قائمة تحقق من العميل تأكيد خمسة أمور: تطبيق WhatsApp Business محدَّث، ورقم مستخدم فعلياً منذ 7 أيام على الأقل، وعدم وجود مزود واجهة برمجة التطبيقات (API) آخر أو أداة أتمتة عليه، وعدم وجود تطبيقات غير رسمية، وأن يكون الهاتف في متناول يده مع تسجيل دخول Facebook. ولا يُطلب منه أي حساب أو بريد إلكتروني أو بطاقة.
ماذا يحدث داخل نافذة Meta المنبثقة؟
يسجّل تدفق Meta دخول العميل عبر Facebook، ويطلب منه تفويض التطبيق وإدخال الرقم، ويعرض ملف تطبيق WhatsApp Business الخاص بالرقم ليؤكده. ثم يختار أو ينشئ Business Portfolio، ويمسح رمز QR من داخل تطبيق WhatsApp Business؛ كما ترسل Meta إلى الرقم رسالة WhatsApp تتضمن رابطاً إلى الرمز. في التطبيق يضغط العميل Connect ويختار إن كان يشارك سجل المحادثات. وأخيراً يأتي اسم الحساب والمنطقة الزمنية وشروط Meta. وقد يختلف الترتيب أثناء طرح Meta تدفقها الذي يبدأ برقم الهاتف.
باسم من تعرض نافذة Meta المنبثقة؟
باسم التطبيق الذي يطلب الوصول. في الصفحة المستضافة هو easyCoexistence، ولا يمكن تغيير اسمه، بينما تعرض الصفحة المحيطة بالنافذة اسمك من partner_name. أما تطبيق Tech Provider خاص بك فيعرض اسم تطبيقك، لكن مقابل التحقق والمراجعة والبناء الموصوفة أعلاه.
ما قاعدة 14 يوماً؟
تفصل Meta رقم Coexistence بعد نحو 14 يوماً من عدم نشاط الهاتف الذي يحمل تطبيق WhatsApp Business، وتذكر السبب بالقيمة PRIMARY_INACTIVITY. يعيد العميل الاتصال بتشغيل التدفق مرة أخرى بالرقم نفسه. عبر الصفحة المستضافة، تراقب easyCoexistence كل رقم وترسل إلى events URL لديك الحدث connection.disconnected مع هذا السبب، لذلك يمكن لرابط الاتصال الجديد للعميل أن يعيد الرقم إلى العمل.
الأخطاء الشائعة
- البناء على Embedded Signup الإصدار v2 أو v3. أوقفت Meta الإصدارين في 15 أكتوبر 2026، وتُعالج الطلبات الموجهة إليهما كالإصدار v4.
- طلب صلاحيات لا يستخدمها التطبيق. تسمّي Meta الصلاحيات غير الضرورية سبباً شائعاً لرفض الطلب في App Review.
- تسجيل فيديو واحد للصلاحيتين معاً. تطلب Meta تسجيل شاشة وشرحاً مكتوباً منفصلين لكل صلاحية، وقد ترفض فيديو يعرض عدة صلاحيات.
- أن تطلب من العملاء الاتصال من الهاتف الذي يحمل الرقم. تفتح نافذة Meta هناك في تبويب جديد، ويجب أن يمسح الهاتف نفسه رمز QR، لذلك يكون الحاسوب أسهل.
يستلم خادمك رمز الوصول (token) الخاص بكل عميل، وترسل Meta الرسائل مباشرةً إلى webhook الخاص بك، وتصلك حالات الانقطاع كأحداث موقّعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل أحتاج إلى أن أكون Meta Tech Provider لتهيئة أرقام WhatsApp لعملائي؟
لا، إلا إذا أردت تشغيل Embedded Signup من تطبيق Meta الخاص بك. إرسال العملاء إلى صفحة مستضافة تديرها Tech Provider يربط أرقامهم دون التحقق من النشاط التجاري أو App Review الخاص بك.
كم تستغرق App Review لتطبيق WhatsApp؟
تقدّر Meta المتوسط بنحو 24 ساعة. يجب إتمام التحقق من النشاط التجاري قبل أن تبدأ المراجعة، وكل طلب مرفوض يضيف جولة أخرى.
هل يستمر عميلي في استخدام تطبيق WhatsApp Business؟
نعم. يبقى التطبيق يعمل على هاتفه إلى جانب الـ API، وتُنسخ الرسائل بين الاثنين. وتتغير بعض الميزات: تصبح قوائم البث للقراءة فقط، وتُعطَّل الرسائل المختفية والرسائل ذات المشاهدة الواحدة.
من يدفع لـ Meta ثمن الرسائل؟
العميل. تحتسب Meta الرسائل المرسلة عبر API على حساب WhatsApp Business الخاص بالعميل، بطريقة دفع يضيفها هناك، بينما تبقى الرسائل المرسلة من تطبيق WhatsApp Business مجانية.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في