اربط تطبيق Meta الخاص بك #

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

هذا هو الخيار الأكثر تقنية من بين خيارات الاتصال بـ WhatsApp — ستقوم بإنشاء تطبيق داخل موقع مطوري Meta ونسخ أربع قيم إلى Your AI Connector. خصص حوالي 20 دقيقة لذلك. إذا كان هذا يبدو أكثر مما ترغب في التعامل معه، فإن اتصال WhatsApp Business المُدار يظل الطريقة الأبسط للبدء.

ما تحتاجه #

• الوصول إلى حساب مدير الأعمال (Meta Business Manager) الخاص بك.
• رقم هاتف غير مستخدم بالفعل في تطبيق WhatsApp.
• حوالي 20 دقيقة.

الجزء 1 — إعداد تطبيقك في Meta #

قم بتنفيذ هذه الخطوات من جانب Meta أولاً. ستجمع أربع قيم على طول الطريق: معرف التطبيق (App ID)، وسر التطبيق (App secret)، ورمز الوصول (Access token)، ومعرف حساب WhatsApp (WhatsApp account ID).

1. إنشاء تطبيق #

انتقل إلى developers.facebook.com، وافتح تطبيقاتي (My Apps) واضغط على إنشاء تطبيق (Create App). اختر نوع نشاط تجاري (Business) وامنحه أي اسم — الاسم مرئي لك فقط.

2. إضافة WhatsApp إلى التطبيق #

في لوحة تحكم التطبيق، ابحث عن WhatsApp في قائمة المنتجات واضغط على إعداد (Set up). تنشئ Meta حساب WhatsApp تجريبيًا برقم تجريبي مجاني حتى تتمكن من تجربة الأشياء قبل ربط رقم حقيقي.

3. تفعيل أذونات WhatsApp #

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

في تطبيقك، افتح مراجعة التطبيق (App Review)، ثم الأذونات والميزات (Permissions and Features). ابحث عن whatsapp_business_management. إذا كان مكتوبًا لا يوجد وصول (No access)، فاضغط على الحصول على وصول قياسي (Get standard access) — ستطلب منك Meta إعادة إدخال كلمة المرور الخاصة بك وتمنحك الوصول على الفور. لا توجد فترة انتظار ولا مراجعة للتطبيق؛ إنه مجرد زر واحد.

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

4. إنشاء مستخدم نظام #

في إعدادات أعمال Meta، افتح المستخدمون، ثم مستخدمو النظام. أضف مستخدماً وامنحه صلاحية الوصول كمسؤول لكل من تطبيقك وحسابك على WhatsApp.

5. إنشاء رمز وصول (Token) لهذا المستخدم #

حدد مستخدم النظام واضغط على إنشاء رمز وصول (Generate token). اختر تطبيقك، وحدد رمز وصول لا تنتهي صلاحيته أبداً، وقم بتفعيل خياري whatsapp_business_messaging و whatsapp_business_management. ستعرض Meta رمز الوصول مرة واحدة فقط — انسخه على الفور.

6. العثور على معرف حساب WhatsApp الخاص بك #

في إعدادات الأعمال، افتح الحسابات، ثم حسابات WhatsApp، وحدد حسابك. الرقم الطويل الموجود أسفل اسمه هو المعرف (ID).

يوجد معرف التطبيق (App ID) و سر التطبيق (App secret) في إعدادات التطبيق، ثم أساسي (Basic). اضغط على إظهار (Show) بجوار سر التطبيق للكشف عنه.

الجزء 2 — اتصل به في Your AI Connector #

افتح الإعدادات (Settings)، ثم القنوات (Channels)، وابحث عن بطاقة WhatsApp Business API واضغط على Connect WhatsApp. اختر Use a number you already have، ثم Your own Meta app. سيفتح المعالج على نظرة عامة قصيرة — اضغط على Start setup.

1. تفاصيلك. تكرر هذه الخطوة الخطوات الخمس الخاصة بـ Meta من الجزء 1 بجوار نموذج للقيم الأربع الخاصة بك. الصق معرف التطبيق (App ID)، وسر رمز التطبيق (App secret)، ورمز الوصول (Access token)، ومعرف حساب WhatsApp تماماً كما تظهرها Meta، بدون مسافات إضافية، واضغط على التحقق من تفاصيلي (Check my details). لا يتم حفظ أي شيء حتى تنجح العملية — حيث تقوم Your AI Connector بالتحقق منها مع Meta أولاً.

2. اختر الرقم للربط. يسرد المعالج كل رقم في حساب WhatsApp الخاص بك، مع تصنيف الجودة الخاص بـ Meta لكل رقم. اختر الرقم الذي يجب أن تستخدمه مساحة العمل هذه للإرسال والاستقبال واضغط على ربط هذا الرقم (Connect this number).

3. التنشيط والتسليم. تقوم Your AI Connector بتنشيط الرقم لـ Cloud API وتسجيل الـ webhook الخاص به لدى Meta تلقائياً، بحيث تصل الرسائل الواردة إلى صندوق الوارد الخاص بك — في معظم الحالات، ستصل مباشرة إلى بطاقة الاتصال مع تأكيد “تم توصيل الرقم”. إذا تعذرت الخطوة التلقائية، يعرض المعالج رابط الـ callback ورمز التحقق (verify token) مع أزرار للنسخ، ويرشدك خلال إضافتها في Meta بنفسك؛ تظل نفس القيم مرئية على بطاقة الاتصال في حال طلبت منك Meta إعادة إدخالها في أي وقت.
4. يتحقق المعالج من الاتصال بنفسه. في الخطوة الأخيرة، يتم التحقق من الإعداد تلقائياً — دون الحاجة إلى انتظار من جانبك. بمجرد أن تظهر البطاقة متصلة، أرسل لنفسك رسالة WhatsApp من هاتف آخر وشاهدها وهي تصل إلى محادثاتك: تبدأ المحادثات على هذا الرقم بالتدفق مثل أي قناة أخرى، ويمكن لوكلاء الذكاء الاصطناعي لديك الرد عليها. إذا وجد الفحص شيئاً لا تزال Meta تحتاجه (على سبيل المثال، التحقق من الرقم)، تخبرك البطاقة بالضبط بما هو مطلوب، ويقوم زر Verify connection بإعادة إجراء الفحص بمجرد إصلاح المشكلة.

يمكنك العودة إلى نفس الصفحة في أي وقت للتحقق من حالة الاتصال، أو إعادة الاتصال (Reconnect) بتفاصيل جديدة، أو الضغط على قطع الاتصال (Disconnect) — سيظل رقمك وحسابك على Meta ومعلومات الفوترة الخاصة بك ملكاً لك.

التبديل من الاتصال المُدار #

يمكنك البدء باتصال WhatsApp Business المُدار والانتقال إلى تطبيق Meta الخاص بك لاحقاً. كلاهما يعملان على نفس الحساب، لذا لا داعي لإعادة بناء أي شيء.

• ستبقى جهات الاتصال وسجل الدردشة لديك. تنتمي جهات الاتصال والمحادثات والعلامات والوكلاء وقاعدة المعرفة إلى حسابك، وليس إلى الاتصال. إزالة رقم أو استبداله لا يحذف أياً منها، وعندما يراسل شخص ما راسلك من قبل الرقم مرة أخرى، فإنه يظهر في نفس المحادثة.
• يجب نقل الرقم من جانب Meta أولاً. يسمح WhatsApp للرقم بالعمل في مكان واحد في كل مرة. اطلب من الدعم تحرير الرقم من الإعداد المُدار، وأضفه إلى حساب WhatsApp Business الخاص بك في WhatsApp Manager، ثم اتبع الخطوات الموجودة في هذه الصفحة. توقع أن يكون الرقم غير متصل لفترة قصيرة أثناء عملية النقل.
• استخدم رقماً تمتلكه إذا كنت تخطط للتبديل. الرقم المستأجر داخل Your AI Connector هو خط افتراضي ينتمي إلى الإعداد المُدار ولا يمكن نقله ببساطة إلى تطبيق Meta الخاص بك، لذا فإن التبديل سيعني الحصول على رقم WhatsApp جديد.
• تحتاج القوالب إلى الموافقة عليها مرة أخرى. توافق Meta على القوالب لكل حساب WhatsApp Business، لذا قم بإعادة إنشاء القوالب التي تستخدمها تحت حسابك الخاص (انظر القوالب أدناه).
• الوكالات: يقوم كل حساب فرعي بتوصيل تطبيق Meta الخاص به، بحيث يمكن للعملاء التبديل واحداً تلو الآخر.

معلومات مفيدة #

• تطبق نافذة الـ 24 ساعة، كما هو الحال في كل اتصالات WhatsApp Business. يمكنك دائمًا الرد بحرية على الأشخاص الذين راسلوك في آخر 24 ساعة. خارج هذه النافذة، يسمح WhatsApp للشركات فقط ببدء محادثات باستخدام قالب رسالة معتمد — سيتم قبول الرسالة النصية العادية من قبل Meta ولكن لن يتم تسليمها.
• تقوم Meta بفوترتك مباشرةً مقابل المحادثات بالأسعار المعلنة لكل دولة، وذلك باستخدام طريقة الدفع المرتبطة بحساب WhatsApp الخاص بك في Meta. لا تفرض Your AI Connector رسومًا لكل رسالة على هذا الاتصال؛ وتتم محاسبة استخدام الذكاء الاصطناعي بالرصيد كالمعتاد.
• احتفظ بطريقة دفع صالحة في حساب WhatsApp هذا. بدونها، ستقوم Meta بحظر كل محادثة تبدأها شركتك — سواء كانت رسائل جماعية أو أي رسالة قالب — وستظهر رسالة الخطأ في مدير WhatsApp (WhatsApp Manager). في هذا الاتصال، سيرفض البث البدء في هذه الحالة، وسيطلب منك إضافة طريقة دفع بدلاً من فشل الرسائل واحدة تلو الأخرى. لا تزال الردود على الأشخاص الذين راسلوك أولاً تُرسل في الوقت الحالي، ولكن اعتبارًا من 1 أكتوبر 2026 ستفرض Meta رسومًا على تلك الرسائل أيضًا، لذا سيصبح الحساب الذي لا يحتوي على طريقة دفع فعالة صامتًا تمامًا في ذلك التاريخ. الصورة الكاملة موجودة في تكاليف WhatsApp وتغيير أكتوبر 2026.
• يبدو تقدير التكلفة الخاص بك مختلفًا هنا. نظرًا لأن هذه الرسوم لا تخصم من رصيدك أبدًا، فإن التقدير في خطوة مراجعة البث يوضح عدد جهات الاتصال وتوزيع الدول مع ملاحظة أن Meta تقوم بفوترتها على حساب WhatsApp Business الخاص بك، بدلاً من إجمالي الرصيد.
• أرقام الاختبار مجانية. يمكن لرقم الاختبار الذي تمنحه Meta لكل تطبيق جديد مراسلة ما يصل إلى خمسة مستلمين تم التحقق منهم بدون تكلفة — وهي طريقة مفيدة لتجربة الإعداد الكامل قبل توجيه رقم حقيقي إليه.

القوالب #

تعمل قوالب الرسائل على هذا الاتصال، وهي موجودة في حساب WhatsApp Business الخاص بك. قم بإنشاء قالب في صفحة القوالب (Templates)، وسيتم إنشاؤه في ذلك الحساب ومراجعته من قبل Meta، مع عرض النتيجة (معتمد، معلق، أو مرفوض) لك هنا. تظهر القوالب الموجودة لديك بالفعل في مدير WhatsApp (WhatsApp Manager) في القائمة تلقائياً، ويقوم زر المزامنة من Meta (Sync from Meta) بجلب أي تغييرات أجريتها هناك للتو. يعمل الإرسال كما هو الحال في أي اتصال WhatsApp آخر — اختر قالباً معتمداً لبدء محادثة أو إعادة فتح محادثة خارج نافذة الـ 24 ساعة. التفاصيل موجودة في استخدام القوالب مع حساب Meta WhatsApp الخاص بك.

إذا كان هناك شيء لا يعمل #

• “تعذر علينا الاتصال باستخدام هذه التفاصيل” — أعد نسخ كل قيمة؛ فوجود مسافة إضافية هو السبب المعتاد. تتضمن الرسالة رد Meta الخاص، والذي عادةً ما يحدد القيمة الخاطئة.
• يقول الخطأ أن الرمز المميز مفقود whatsapp_business_management — لم يتم منح تطبيقك هذا الإذن بعد. ارجع إلى الجزء 1، الخطوة 3، واضغط على الحصول على وصول قياسي (Get standard access)، ثم أنشئ رمزاً مميزاً جديداً مع تحديد كلا الإذنين وتحقق من تفاصيلك مرة أخرى. إعادة إنشاء الرمز المميز دون القيام بهذه الخطوة سيؤدي إلى استمرار ظهور نفس الخطأ.
• اختفى الرمز المميز الخاص بك — تعرض Meta الرمز المميز مرة واحدة فقط. أنشئ رمزاً جديداً من نفس مستخدم النظام؛ سيستمر الرمز القديم في العمل حتى تقوم بإلغائه، ولكن الرمز الجديد فقط هو الذي سيكون مرئياً.
• تفشل الردود مع رسالة “جاءت هذه المحادثة على رقم WhatsApp Business …، وهو ليس الرقم المتصل” — يحتوي تطبيق Meta الخاص بك على أكثر من رقم، ويقوم الأشخاص بمراسلة رقم ليس هو الرقم المتصل هنا. لا تزال رسائلهم تظهر، لأن Meta ترسل رسائل التطبيق لكل رقم، ولكن لا يمكن إرسال الردود إلا من الرقم المتصل، لذا لا يقوم الذكاء الاصطناعي بالرد عليها. تعرض بطاقة WhatsApp في صفحة القنوات (Channels) تحذيراً يذكر ذلك الرقم بينما تستمر رسائله في الوصول. لا يحتوي صف الرقم الموجود في تلك البطاقة على زر إعادة الاتصال (فقط تعيين كرئيسي (Set as primary) وحذف): افتح صفحة اتصال تطبيق Meta الخاص بك مرة أخرى (اتصل بـ WhatsApp في بطاقة WhatsApp Business API، ثم استخدم رقماً لديك بالفعل، ثم تطبيق Meta الخاص بك)، واضغط على إعادة الاتصال (Reconnect) في بطاقة الاتصال هناك واختر الرقم الذي يراسل عملاؤك عليه بالفعل. يحتاج رمز مستخدم النظام إلى الوصول إلى حساب WhatsApp هذا. إذا كان لا ينبغي لهذا الرقم الوصول إلى Your AI Connector على الإطلاق، فقم بإزالته (أو إزالة حساب WhatsApp الخاص به) من تطبيق Meta الخاص بك بدلاً من ذلك.
• الرسائل التي تبدأها لا تصل — تحقق من ملاحظة نافذة الـ 24 ساعة أعلاه: خارج هذه النافذة، يتم تسليم رسائل القوالب فقط.
• لا يصل أي شيء على الإطلاق — من المحتمل أن الرقم لم يتم تفعيله لـ Cloud API بعد. لا يمكن للرقم أن يعمل إلا في مكان واحد في كل مرة، لذا إذا كان لا يزال مسجلاً للدخول في تطبيق WhatsApp Business على هاتف، فقم بإزالته من هناك أولاً، ثم اضغط على التحقق من الاتصال (Verify connection) في بطاقة الاتصال. يقوم Your AI Connector بتفعيله لك ويخبرك على الفور إذا كان لا يزال هناك شيء مفقود من جانب Meta.
• “هذا الرقم لديه بالفعل رمز PIN للتحقق بخطوتين” — تم إعداد الرقم في مكان ما من قبل واحتفظ برمز الـ PIN الخاص به. قم بإيقاف التحقق بخطوتين له في WhatsApp Manager، ثم اضغط على إعادة الاتصال (Reconnect).
• “لم تقم Meta بالتحقق من هذا الرقم بعد” — أكمل التحقق من الرقم في WhatsApp Manager (ترسل Meta رمزاً إليه)، ثم اضغط على إعادة الاتصال (Reconnect).
• “هذا الرقم مستضاف على On-Premises API” — إنه يعمل على منتج WhatsApp الأقدم المستضاف ذاتياً، والذي لا يمكنه مشاركة رقم مع Cloud API. قم بترحيله إلى Cloud API في WhatsApp Manager أولاً.