تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

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.

10 to 200

عدد العملاء الجدد من الأنشطة التجارية الذين يجوز لـ Tech Provider ضمهم خلال كل 7 أيام متحركة: 10 افتراضياً، و200 بعد التحقق والمراجعة.

2 videos

تسجيلات الشاشة التي يطلبها App Review من Tech Provider: رسالة مُرسلة ومُستقبلة، وإنشاء قالب.

About 24 hours

متوسط مدة App Review لتطبيق WhatsApp كما تذكره Meta.

2.24.17

أقدم إصدار من تطبيق WhatsApp Business يمكن للعميل ربطه عبر Coexistence.

30 seconds

المدة التي يبقى فيها الرمز الذي يعيده Embedded Signup صالحاً ليتمكن الخادم من استبداله برمز الوصول (token) الخاص بالنشاط التجاري للعميل.

ما الطريقتان لتهيئة أرقام عملائك؟

تعتمد الطريقتان على Embedded Signup من Meta مع Coexistence، وتنتهيان في المكان نفسه: رقم العميل على Cloud API، ويبقى يعمل في تطبيق WhatsApp Business، والخادم الخلفي لديك يحتفظ برمز الوصول (token) الخاص بالعميل. الفرق يكمن في من يتحمل متطلبات Meta، وفي الكود المحيط بالنافذة المنبثقة.

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn 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. ولا يُطلب منه أي حساب أو بريد إلكتروني أو بطاقة.

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

ماذا يحدث داخل نافذة 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، لذلك يكون الحاسوب أسهل.
إنجاز ذلك باستخدام EasyCoexistence

يستلم خادمك رمز الوصول (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 بتطبيقكروابط اتصال مستضافة لأرقام WhatsApp وحسابات التواصل لعملائك: طلب الجلسة، إعادة التوجيه، الحالة، الانتهاء وإعادة المحاولة.تسعير واجهة برمجة التطبيقات (API) الموحدة لمنصات SaaS: US$ 9 إلى US$ 0.75 لكل اتصالكيف تدفع المنصة ثمن قنوات عملائها: US$ 9 إلى US$ 0.75 لكل اتصال، محسوبة لـ 10 و100 و1,000 عميل، مع بقاء رسوم Meta منفصلة.حدود Partner API والقواعد: سياسات Meta و20 رسالة في الثانية وقاعدة الـ14 يومًاقواعد المنصة لقنوات عملائها: سياسات واتساب من Meta، و20 رسالة في الثانية لكل رقم Coexistence، وقاعدة 14 يومًا، وما يُنهي المفتاح.ماذا تعني صفة Tech Provider من Meta ولماذا تهم؟يربط Tech Provider أرقام WhatsApp لنشاطات تجارية أخرى عبر تطبيق Meta الخاص به. تعرف إلى المتطلبات وما الذي يتغير للعميل.ما الأرقام المؤهلة لـ Coexistenceإصدار التطبيق ونوع الحساب وصلاحية الوصول وما يجعل Meta ترفض الرقم أثناء إعداد Coexistence.ربط رقم خطوة بخطوةتعرّف إلى ما يحدث عند ربط رقم عبر Coexistence، وما يفعله صاحب النشاط التجاري، وما يُحسم نهائياً ولا يمكن تغييره.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في