Your AI Connector Docs

اربط تطبيق 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 أولاً.
  1. اختر الرقم للربط. يسرد المعالج كل رقم في حساب WhatsApp الخاص بك، مع تصنيف الجودة الخاص بـ Meta لكل رقم. اختر الرقم الذي يجب أن تستخدمه مساحة العمل هذه للإرسال والاستقبال واضغط على ربط هذا الرقم (Connect this number).
  1. التنشيط والتسليم. تقوم Your AI Connector بتنشيط الرقم لـ Cloud API وتسجيل الـ webhook الخاص به لدى Meta تلقائياً، بحيث تصل الرسائل الواردة إلى صندوق الوارد الخاص بك — في معظم الحالات، ستصل مباشرة إلى بطاقة الاتصال مع تأكيد “تم توصيل الرقم”. إذا تعذرت الخطوة التلقائية، يعرض المعالج رابط الـ callback ورمز التحقق (verify token) مع أزرار للنسخ، ويرشدك خلال إضافتها في Meta بنفسك؛ تظل نفس القيم مرئية على بطاقة الاتصال في حال طلبت منك Meta إعادة إدخالها في أي وقت.
  2. يتحقق المعالج من الاتصال بنفسه. في الخطوة الأخيرة، يتم التحقق من الإعداد تلقائياً — دون الحاجة إلى انتظار من جانبك. بمجرد أن تظهر البطاقة متصلة، أرسل لنفسك رسالة WhatsApp من هاتف آخر وشاهدها وهي تصل إلى محادثاتك: تبدأ المحادثات على هذا الرقم بالتدفق مثل أي قناة أخرى، ويمكن لوكلاء الذكاء الاصطناعي لديك الرد عليها. إذا وجد الفحص شيئاً لا تزال Meta تحتاجه (على سبيل المثال، التحقق من الرقم)، تخبرك البطاقة بالضبط بما هو مطلوب، ويقوم زر Verify connection بإعادة إجراء الفحص بمجرد إصلاح المشكلة.

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

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

  • نافذة الـ 24 ساعة سارية، كما هو الحال في كل اتصال بـ WhatsApp Business. يمكنك دائماً الرد بحرية على الأشخاص الذين راسلوك في آخر 24 ساعة. خارج تلك النافذة، تسمح WhatsApp للشركات فقط ببدء المحادثات باستخدام قالب رسالة معتمد — سيتم قبول رسالة نصية عادية من قبل Meta ولكن لن يتم تسليمها.
  • تُحاسبك Meta مباشرةً على المحادثات وفقاً لأسعارها المعلنة لكل دولة، وذلك على طريقة الدفع المرتبطة بحساب WhatsApp الخاص بك في Meta. لا تفرض Your AI Connector رسوماً لكل رسالة على هذا الاتصال؛ وتتم محاسبة استخدام الذكاء الاصطناعي بالرصيد كالمعتاد.
  • احتفظ بطريقة دفع صالحة في حساب WhatsApp ذلك. بدونها، ستقوم Meta بحظر كل محادثة تبدأها شركتك — البث، والحملات، وأي رسالة قالب — وستظهر الخطأ في 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 الرمز مرة واحدة فقط. أنشئ رمزاً جديداً من نفس مستخدم النظام؛ سيستمر الرمز القديم في العمل حتى تقوم بإلغائه، ولكن الرمز الجديد فقط هو الذي سيكون مرئياً.
  • الرسائل التي تبدأها لا تصل — تحقق من ملاحظة نافذة الـ 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 أولاً.