تسجيل الدخولابدأ الفترة التجريبية المجانية
Meta Tech Provider

رقم واحد.التطبيق وAPI في الوقت نفسه.

Coexistence هو الوضع الرسمي من Meta لتشغيل تطبيق WhatsApp Business وCloud API على رقم واحد في الوقت نفسه. يواصل الفريق الرد من الهاتف، مع المحادثات والسجل نفسيهما، بينما يرسل البرنامج الرسائل ويستقبلها على الخط نفسه.

تربط EasyCoexistence الرقم ثم تراقب الاتصال.

ابدأ الفترة التجريبية المجانية3 أيام مجانًا. لا يُخصم أي مبلغ حتى تنتهي الفترة التجريبية.
+1 415 555 0188
تطبيق WhatsApp Businessيرد الفريق من الهاتف كما كان من قبل
Cloud APIأنظمتك، أو مساعد ذكاء اصطناعي، على الخط نفسه
ترى الواجهتان المحادثة نفسها. ما ترسله API يظهر في التطبيق، وما يكتبه الفريق في التطبيق يصل كحدث smb_message_echoes، لذلك لا يرد البرنامج أبدًا فوق شخص أجاب بالفعل.
من دون تخزين للرسائل افتراضيًاتطبيق الأعمال + Cloud APIMCP لـ Claude وChatGPTجاهز خلال دقيقتين

الخيار الذي كان مفروضًا، ولم يعد كذلك

ليست Coexistence واجهة برمجة تطبيقات (API) جديدة. إنها إزالة مفترق طرق كان يمنع كل نشاط تجاري صغير تقريبًا من أتمتة أي شيء.

قبلرقم واحد، خيار واحد
الإبقاء على التطبيق

يرد الفريق من الهاتف. لا يمكن أتمتة أي شيء أو ربطه أو قياسه.

بلا API
الانتقال إلى API

يستطيع البرنامج الوصول إلى الرقم. يتوقف تطبيق Business عن العمل عليه وينتقل الفريق إلى أدوات أخرى.

بلا تطبيق
الآنرقم واحد، والاثنان معًا
رقم واحد
تطبيق WhatsApp BusinessCloud API

تربط Meta واجهة Cloud API برقم لا يزال تطبيق WhatsApp Business يستخدمه. تعمل الواجهتان على الخط نفسه، وترى كل منهما ما ترسله الأخرى.

من يدير رقمًا بهذه الطريقة

مجموعتان تريدان أمرين متعاكسين من الميزة نفسها، ولهذا يهم الاتصال نفسه أكثر من أي لوحة تحكم مبنية فوقه.

الهاتف باقٍنشاط تجاري برقم واحد

فريق صغير، ورقم مطبوع على شاحنة أو واجهة متجر، وأمسيات تمضي في الإجابة عن الأسئلة الأربعة نفسها. هم لا يستبدلون أحدًا. يريدون أن تتم التأكيدات والتذكيرات وأول رد بعد ساعات العمل دون تدخل بشري، بينما يبقى الهاتف صالحًا لكل ما عدا ذلك.

أرقام كثيرة، حساب واحدوكالة أو شركة استشارات أو مطوّر

عملاء كثيرون، لكل منهم رقم لا يُسمح لأحد بترحيله أو المساس به. يحتاجون إلى أن تصل الأنظمة التي يبنونها إلى هذه الأرقام، وإلى إضافة الرقم التالي دون مكالمة مبيعات. Coexistence هي الطريق الرسمي الوحيد إلى رقم لا يزال موظفو العميل يردون عليه يدويًا.

كيف يصل الرقم إلى الواجهتين معًا، وإلى أين تذهب أحداث الرسائل

أربع خطوات. الخطوة الوحيدة التي تمس الهاتف هي مسح رمز، أما الخطوة التي تحدد بنيتك التقنية فهي الأولى.

  1. جهّز نقطة النهاية قبل بدء الإعداد

    تتحقق Meta من الوجهة قبل أن تسلّم إليها أي شيء. فهي تستدعي عنوان URL الخاص بك بطلب GET يحمل hub.mode=subscribe وقيمة hub.verify_token الخاصة بك وقيمة hub.challenge، وعلى نقطة النهاية (endpoint) أن تعيد قيمة challenge كما هي دون أي تعديل.

    يجب أن تعمل الوجهة عبر HTTPS، ورمز التحقق إلزامي. نتحقق من الأمرين قبل إجراء الاستدعاء، فيفشل عنوان URL غير الصحيح عندنا بدلًا من أن يبدو متصلًا وهو لا يسلّم شيئًا.

    المتطلبات
    نقطة نهاية تعمل عبر HTTPS وتعيد قيمة hub.challenge ردًا على طلب GET من Meta
    الوقت
    نحو دقيقة
    ما تحصل عليه
    وجهة تستطيع Meta التحقق منها لحظة ربط الرقم
    لم يُربط شيء بعد. هذه الخطوة تحدد أين ستصل الرسائل.
    مزوّد في المسارتُخزَّن على خوادمه
    Meta
    منصتهتستقبل الرسائل وتخزّنها
    أنتنسخة، وفق جدوله الزمني
    EasyCoexistenceإعدادات فقط
    Meta
    نقطة النهاية لديكلم يُتحقق منها بعد
    نحننضبط المسار، ولسنا جزءًا منه
  2. شغّل Embedded Signup من Meta وامسح الرمز في التطبيق

    تُفتح النافذة المنبثقة التابعة لـ Meta نفسها. تختار Business Portfolio وحساب WhatsApp Business والرقم المسجّل أصلًا في تطبيق WhatsApp Business، ثم توافق على الاتصال من الهاتف بمسح رمز.

    في هذه الخطوة أيضًا تختار ما إذا كنت ستشارك سجل المحادثات الحالي. إنه قرار يُتخذ مرة واحدة أثناء الإعداد ولا يمكن تغييره لاحقًا. ويواصل تطبيق Business العمل لحظة اكتمال المسح.

    المتطلبات
    صلاحية الوصول إلى Business Portfolio، والهاتف الذي عليه الرقم
    الوقت
    من دقيقتين إلى ثلاث دقائق
    ما تحصل عليه
    واجهة Cloud API مرتبطة برقم لا يزال التطبيق يستخدمه
    تظهر الواجهة الثانية، ولا تُزال الأولى.
    بعد الترحيلواجهة واحدة
    الرقم
    Cloud API فقطتطبيق Business متوقف على هذا الرقم
    بعد Coexistenceواجهتان
    الرقم
    تطبيق WhatsApp Businessالمحادثات والسجل نفسها
    Cloud APIعلى الخط نفسه
  3. وجّه أحداث الرسائل إلى نظامك

    تسمح Meta للتطبيق بتجاوز المكان الذي تُسلَّم إليه خطافات الويب (webhook) الخاصة بحساب WhatsApp Business معيّن. نضبط هذا التجاوز على عنوان URL الخاص بك، فينتقل حقلا مسار الرسائل، messages وsmb_message_echoes، من Meta إليك مباشرة.

    ونحتفظ بالحقول التشغيلية، لأن المراقبة تتكوّن منها: account_update وphone_number_quality_update وaccount_alerts وaccount_review_update وbusiness_capability_update وphone_number_name_update. بذلك تبقى لوحة التحكم مفيدة، بينما لا يمر محتوى المحادثات عبرنا أبدًا.

    المتطلبات
    نقطة النهاية من الخطوة الأولى، بعد أن تحققت منها Meta
    الوقت
    يُطبَّق فور اكتمال الإعداد
    ما تحصل عليه
    رسائل تُسلَّم من Meta إليك مباشرة، ونحن خارج مسار الرسائل
    أي الأحداث تذهب إلى أين بعد تفعيل التجاوز.
    الأحداث التشغيليةتُسلَّم إلينا
    account_updateتغييرات حالة الاتصال
    phone_number_quality_updateالجودة ومعدل الإرسال
    account_review_updateنتائج المراجعة
    مسار الرسائلتُسلَّم إليك
    messagesكل ما يرسله العميل
    smb_message_echoesما يرسله الفريق من التطبيق
    خادمكمباشرة، ولا يمر عبرنا أبدًا
  4. حافظ على نشاط الاتصال، واجتز إعادة الاتصال بسلام

    تقطع Meta اتصال رقم Coexistence بعد نحو أربعة عشر يومًا دون نشاط على الجهاز الأساسي. يمكن إعادة هذا الاتصال، ونسجّله كحالة مستقلة بدلًا من احتسابه عميلًا غادر.

    أما ما يفاجئ الناس فهو أثر قطع الاتصال على المسار. تخزّن Meta الوجهة كتجاوز في اشتراك تطبيقنا في الحساب، لذلك يؤدي حدث PARTNER_REMOVED إلى إزالة تثبيت التطبيق ويزول التجاوز معه. إعادة الاتصال تعيد الإرسال والمراقبة، لكنها لا تعيد وجهتك. نحن نعيدها تلقائيًا، لأن أول رقم وقع تحت هذه القاعدة أعاد الاتصال دون مشكلة ثم توقف بصمت عن التسليم إلى خادم العميل.

    المتطلبات
    فتح التطبيق على الجهاز الأساسي من حين لآخر
    الوقت
    مستمر
    ما تحصل عليه
    اتصال تحت المراقبة، ومسار يصمد بعد إعادة الاتصال
    ما تعيده إعادة الاتصال من تلقاء نفسها، وما يجب إعادة تطبيقه.
    تعيده Metaتلقائيًا
    الإرسالتعمل Cloud API مجددًا
    الأحداث التشغيليةتُستأنف المراقبة
    يزول مع التطبيقيجب إعادة تطبيقه
    تجاوز webhook الخاص بكأُزيل مع إزالة تثبيت التطبيق
    تسليم الرسائل إليكيتوقف بصمت
    نعيد تطبيقهعند كل إعادة اتصال

لماذا تدير الفرق رقمًا بهذه الطريقة

  • الإبقاء على الرقم المطبوع أصلًا على الشاحنات والإيصالات والموقع الإلكتروني، وعلى طريقة العمل من الهاتف المحيطة به.
  • إضافة الإرسال عبر API ومعالجة خطافات الويب (webhook) والقوالب دون نقل أي أحد إلى أداة جديدة.
  • إبقاء حركة الرسائل خارج صندوق الوارد المشترك لدى مزوّد، حتى لا تبقى المحادثات على منصة طرف آخر.
  • منح الوكالة طريقة لإدارة أرقام عملاء كثيرين في حساب واحد، كل منها متصل في Business Portfolio الخاص بالعميل نفسه.

الأهلية والحدود العملية

  • يجب أن يكون الرقم نشطًا بالفعل في تطبيق WhatsApp Business. الرقم الموجود على تطبيق WhatsApp العادي يجب نقله إليه أولًا.
  • مشاركة سجل المحادثات الحالي قرار يُتخذ مرة واحدة أثناء الإعداد ولا يمكن تغييره لاحقًا.
  • المحادثات الجماعية مستبعدة من API على أرقام Coexistence، لدى أي مزوّد.
  • يحتاج الجهاز الأساسي إلى نشاط دوري. تقطع Meta الاتصال بعد نحو أربعة عشر يومًا من دونه.
  • تختلف مسارات التحقق والشارة من Meta لأرقام Coexistence، ويتغير التوفر حسب المنطقة مع سياسة Meta.
نص حرمن 0 إلى 24 ساعة بعد آخر رسالة من العميلقوالب فقطبعد ذلك، حتى يكتب العميل مجددًا
يُعاد ضبط العدّاد في كل مرة يرسل فيها العميل شيئًا. هذه هي القاعدة التي تعطّل عمليات الربط في بيئة الإنتاج، لأن الاختبار يحدث دائمًا بعد ثوانٍ من رسالة، حين يكون النص الحر لا يزال يعمل.

ما نوجّهه إليك، وما نحتفظ به

تسمح Meta للتطبيق بتجاوز المكان الذي يسلّم إليه حساب WhatsApp Business خطافات الويب الخاصة به. نضبط هذا التجاوز على عنوان URL الخاص بك، فتنقسم الأحداث إلى قسمين.

تُسلَّم مباشرة إلى نقطة النهاية لديكمسار الرسائل. بشكل افتراضي لا يمر عبرنا أبدًا.
  • messagesكل ما يرسله العميل إلى الرقم
  • smb_message_echoesما يرسله فريقك من تطبيق WhatsApp Business
تُسلَّم إليناالمسار التشغيلي. ومنه تتكوّن المراقبة.
  • account_updateحالة الاتصال: أُزيل، أُخرج، أُعيد ربطه، مقيّد
  • phone_number_quality_updateتغييرات تقييم الجودة ومعدل الإرسال
  • account_alertsالتنبيهات التي تصدرها Meta بحق الحساب
  • account_review_updateنتائج مراجعة من Meta
  • business_capability_updateتغييرات حد الرسائل والقدرات
  • phone_number_name_updateالموافقة على اسم العرض ورفضه

إذا لم يكن للرقم تجاوز مضبوط، تذهب أحداث رسائله إلى عنوان الاستدعاء الافتراضي لدينا، حيث يتخلص منها المعالج دون حفظ. هذا مفروض في الكود وليس وعدًا في سياسة: لا يوجد مسار تخزين يمكن أن يسلكه محتوى المحادثات.

قاعدة الأربعة عشر يومًا، وما تكسره ولا يذكره أحد

تقطع Meta اتصال Coexistence بعد نحو أربعة عشر يومًا دون نشاط على الجهاز الأساسي. يمكن إعادة الاتصال، لذلك نحفظ ذلك كحالة مستقلة بدلًا من احتسابه عميلًا غادر.

أما العاقبة المكلفة فتأتي لاحقًا. وجهة رسائلك ليست إعدادًا في الرقم، بل هي تجاوز (override) في اشتراك تطبيقنا في حساب WhatsApp Business. قطع الاتصال يزيل تثبيت التطبيق، ويزول التجاوز معه. تعيد الاتصال، فيعمل الإرسال، وتعمل المراقبة، وتتوقف الرسائل عن الوصول إلى خادمك دون أن يُبلغ أي شيء عن خطأ.

نعيد تطبيق التجاوز عند كل إعادة اتصال. هذا السلوك موجود لأن الأمر حدث فعلًا: رقم وقع تحت هذه القاعدة، وأعاد الاتصال دون مشكلة، ثم توقف بصمت عن تسليم الرسائل.

إذا فشلت المصافحة في تلك اللحظة، لأن خادمك كان متوقفًا أو تغيّر رمز الوصول، يُسجَّل ذلك في السجل الزمني للاتصال وتُحفظ الوجهة بدلًا من حذفها، لذا يكفي حفظها مرة أخرى لإصلاح الأمر.

ما يتعطل بصمت، وكيف نكتشفه

يستمر تطبيق WhatsApp Business في العمل خلال كل الأعطال أدناه تقريبًا، ولهذا لا يلاحظها أحد. هذه هي الأعطال التي نتحقق منها، وطريقة التحقق.

انقطع اتصال الرقمwebhook، مصدر موثوق

يُكتشف من خطاف الويب account_update الصادر من Meta، وتحديدًا PARTNER_REMOVED، بدلًا من استنتاجه من حقل تصبح قيمته false. نحن لا نقرأ is_on_biz_app لهذا الغرض عن قصد، لأن قيمته false بشكل مشروع على الأرقام التي ليست Coexistence، وكان يسبب انقطاعات وهمية.

ظل الاتصال خاملًا أربعة عشر يومًاحالة مستقلة

قاعدة Meta لعدم نشاط الجهاز الأساسي. يمكن إعادة الاتصال، لذلك يُسجَّل كحالة مستقلة وليس كعميل غادر، وإعادة الاتصال تعيد الإرسال والمراقبة.

اختفى مسار webhook الخاص بك عند إعادة الاتصاليُعاد تطبيقه تلقائيًا

الوجهة محفوظة كتجاوز في اشتراك تطبيقنا في الحساب، لذا يزيلها قطع الاتصال. يعود الإرسال عند إعادة الاتصال، أما التسليم إلى خادمك فلا يعود. نعيد تطبيق التجاوز في كل مرة، لأن رقمًا حدث له ذلك أعاد الاتصال دون مشكلة ثم توقف بصمت عن تسليم الرسائل.

توقف رمز الوصول عن العملرمزان، إجابة واحدة

نحتفظ برمز العميل وبرمز System User token الخاص بنا للحساب نفسه. عندما يُرفض أحدهما، يقرأ الآخر الحساب ويحدد أيهما تعطل فعلًا، فلا يعود الرمز الملغى يبدو كأنه رقم مفقود.

انخفضت الجودةاستعلام دوري

نستعلم عنها من Meta وفق جدول زمني. تقييم RED يضع على الاتصال علامة التدهور، وتُحفظ الجودة ومستوى المراسلة ومستوى معدل الإرسال في كل فحص، فيظهر التراجع قبل أن يكلّف عملية إرسال.

ربط الرقم ومراقبة الرقم منتجان مختلفان. والثاني هو سبب وجود هذا المنتج.

2 minutes

الوقت المعتاد لربط الرقم، عبر مسح رمز من تطبيق WhatsApp Business.

24 hours

المدة التي يُبقي فيها رد العميل الجلسة مفتوحة للرد بنص حر.

20 msg/s

معدل الإرسال لرقم Coexistence، تحدده Meta ولا يمكن رفعه.

6 months

حجم سجل المحادثات الذي تزامنه Meta مع API عند ربط الرقم أول مرة.

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

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

لا. هذه هي الفكرة الأساسية من Coexistence. يستمر تطبيق WhatsApp Business في العمل على الرقم نفسه، مع المحادثات نفسها، وتعمل API إلى جانبه.

هل سأفقد محادثاتي الحالية؟

لا. تبقى في التطبيق، وتزامن Meta نحو ستة أشهر من السجل مع API عند ربط الرقم، لذلك يملك البرنامج سياقاً بدلاً من أن يبدأ فارغاً.

هل يمكنني التراجع عنه؟

نعم. يمكن فصل الرقم، ويستمر التطبيق كما كان دائماً. لا يغير ربط الرقم أي شيء فيه بشكل دائم.

هل هذا هو نفسه WhatsApp API غير الرسمي؟

لا، والفرق يحدد ما إذا كان الرقم سيبقى فعالاً. Coexistence ميزة رسمية من Meta على Cloud API. أما البوابات غير الرسمية فتشغّل WhatsApp Web كجهاز مرتبط، ما يخالف الشروط ويؤدي إلى حظر الأرقام.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

ابدأ الفترة التجريبية المجانية3 أيام مجانًا. لا يُخصم أي مبلغ حتى تنتهي الفترة التجريبية.

تابع القراءة