WhatsApp Business Tools MCP: كيفية ربط WhatsApp Business بوكيل ذكاء اصطناعي

في 15 سبتمبر 2026، أطلقت Meta خادم WhatsApp Business Tools MCP الرسمي. يربط الخادم وكيل ذكاء اصطناعي—مثل Claude Code أو Codex أو ChatGPT أو Cursor—بمنصة WhatsApp Business Platform. بدلًا من التنقل بين Developer Console وBusiness Manager ووثائق API، تصف المهمة للوكيل، فيضيف رقمًا، وينشئ قالب رسالة، ويضبط خطافات الويب، ويرسل رسالة تجريبية.

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

تتوفر معلومات العمل مع Ailoot في الوثائق.

ما هو WhatsApp Business Tools MCP؟#

MCP (Model Context Protocol) معيار مفتوح لربط الأنظمة الخارجية بوكلاء الذكاء الاصطناعي. تعرّف عليه أكثر في مقالة خوادم MCP لـ Claude Code: 7 تكاملات جاهزة. تتوفر الاتصالات التي تم التحقق منها مع أوامر التثبيت في دليل MCP.

قبل إطلاق هذا الخادم، كان إعداد تكامل WhatsApp يتطلب فتح Developer Console، وإنشاء تطبيق، وربط نشاط تجاري، وإضافة رقم هاتف، والتحقق منه باستخدام رمز، وإنشاء رمز وصول، وضبط خطاف ويب، ومراجعة وثائق API، ثم كتابة السطر الأول من التعليمات البرمجية.

تصف Meta الفكرة وراء الخادم على النحو التالي (مترجم عن الإنجليزية):

لدى Meta الآن خادما MCP، ومن السهل الخلط بينهما. Meta Social Technologies MCP أداة عامة للمطورين: البحث في الوثائق، واكتشاف نقاط نهاية Graph API، وتشخيص أخطاء التطبيقات. أما WhatsApp Business Tools MCP فهو مخصص للعمل مع حسابات WhatsApp وأرقام الهواتف والقوالب وخطافات الويب والرسائل التجريبية. يكمل أحدهما الآخر، ويمكنك ربطهما معًا عند الحاجة.

ما الذي يستطيع الوكيل فعله تحديدًا بعد الاتصال؟#

تُجمع أدوات الخادم تحت السابقة whatsapp_biz_. ووفقًا للوثائق الرسمية:

• نظرة عامة: whatsapp_biz_businesses وwhatsapp_biz_accounts وwhatsapp_biz_phone_numbers—للتعرّف على الأنشطة التجارية والحسابات وأرقام الهواتف المتاحة لك.
• إعداد رقم الهاتف: whatsapp_biz_add_phone_number وwhatsapp_biz_send_verification_code وwhatsapp_biz_verify_phone_number وwhatsapp_biz_register_phone_number.
• القوالب: whatsapp_biz_list_templates وwhatsapp_biz_get_template وwhatsapp_biz_create_template وwhatsapp_biz_update_template وwhatsapp_biz_delete_template.
• الرسائل: whatsapp_biz_send_message—نص حر خلال نافذة المحادثة التي مدتها 24 ساعة، أو قالب معتمد خارجها؛ ويؤكد الوكيل المستلِم معك قبل الإرسال.
• خطافات الويب: whatsapp_biz_configure_webhooks وwhatsapp_biz_subscribe_webhook.
• إعداد الحساب: whatsapp_biz_configure_payments وwhatsapp_biz_verify_business وwhatsapp_biz_system_user_token—رابط لإنشاء رمز مستخدم نظام لإجراء طلبات Cloud API مباشرة.

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

يتضمن الخادم عناصر تحكم في الوصول. تسجّل الدخول باستخدام حساب Meta وتختار أنشطة تجارية محددة؛ ولا تُدرج الرموز في سجل المحادثة. تُجرى كل عملية قراءة ضمن سياقك، وتُسجّل الطلبات، وتتطلب الإجراءات التي تُحدث تغييرات وجود شخص مصادق عليه؛ فمفتاح تطبيق الخادم وحده لا يكفي.

ما الذي ينبغي التحقق منه قبل الاتصال؟#

يعمل الخادم نيابةً عنك ولا يتعامل إلا مع مواردك، لذا تحقّق مما يلي قبل إجراء أول طلب:

1. لديك نشاط تجاري على Meta وأنت مسؤول فيه (دور MANAGE).
2. لديك تطبيق Meta مفعّل فيه سيناريو WhatsApp Business Messaging (أو منتج WhatsApp في التطبيقات الأقدم)، وأنت مسؤول عن هذا التطبيق تحديدًا؛ فصلاحيات مستوى النشاط التجاري وحدها لا تكفي.
3. قُبلت شروط WhatsApp Business Cloud API للنشاط التجاري؛ فمن دون ذلك، يُحظر تسجيل أرقام الهواتف وإرسال الرسائل.

وفقًا لـ Meta، تظهر مشكلات شروط الاستخدام وطرق الدفع والتحقق من النشاط التجاري كثيرًا من دون توضيح كافٍ. يتحقق الوكيل منها مسبقًا ويوفر رابطًا مباشرًا لقبول الشروط أو تحديد طريقة دفع أو بدء التحقق من النشاط التجاري.

كيف تربط الخادم بـ Claude Code؟#

إذا لم تثبّت Claude Code بعد، فابدأ بالدليل كيفية تثبيت Claude Code من الموقع الرسمي.

1. أضف الخادم

   نفّذ الأمر التالي في الطرفية:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   الخادم عن بُعد، لذا لا تحتاج إلى تثبيته محليًا.

2. سجّل الدخول عبر Meta

   في جلسة Claude Code، اكتب /mcp واختر whatsapp_business_tools. ستُفتح نافذة متصفح لتسجيل الدخول إلى حساب Meta. إذا لم يُفتح المتصفح، فانسخ الرابط من العميل وافتحه يدويًا.

3. امنح الأذونات

   في شاشة الموافقة، اختر الأنشطة التجارية والتطبيقات التي تستخدم WhatsApp وتسمح لها بالوصول. سيطلب الخادم ثلاثة أذونات: business_management (العثور على الأنشطة التجارية التي أنت مسؤول فيها)، وwhatsapp_business_management (الحسابات وأرقام الهواتف والقوالب وخطافات الويب)، وwhatsapp_business_messaging (إرسال الرسائل من أرقامك).

4. تحقّق من الاتصال

   أعد تشغيل Claude Code، وسجّل الدخول مجددًا عبر /mcp، واسأل الوكيل عن الأدوات التي يستطيع رؤيتها على خادم whatsapp_business_tools. بعد ذلك، نفّذ قراءة آمنة: «اعرض الأنشطة التجارية التي يمكنني إدارتها»—وسيستدعي الوكيل whatsapp_biz_businesses. إذا لم تظهر أي أدوات أو تلقيت خطأ في تسجيل الدخول، فتحقق من عنوان الخادم وسجّل الدخول مجددًا.

يرتبط تسجيل الدخول عبر OAuth ببدء تشغيل العميل: بعد إعادة تشغيل Claude Code، ستحتاج إلى تسجيل الدخول مجددًا. ويمكنك إلغاء الوصول في أي وقت من الإعدادات على facebook.com، ضمن «عمليات تكامل الأنشطة التجارية».

كيف تربط Codex وChatGPT وClaude Desktop؟#

Codex App. افتح الإعدادات (رمز الترس أسفل اليسار)، وانتقل إلى MCP Servers، ثم اختر Add servers. اختر Streamable HTTP وأدخل:

• الاسم: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• المصادقة: OAuth

انقر على Authenticate وسجّل الدخول في المتصفح.

ChatGPT. الإعدادات، ثم الإضافات، ثم Browse plugins، ثم رمز «+» في الزاوية العلوية اليمنى. أدخل اسمًا وعنوان URL نفسه، واختر OAuth نوعًا للمصادقة.

Claude Desktop. الإعدادات، ثم الموصلات، ثم إضافة موصل مخصص. الاسم: WhatsApp Business Tools؛ وعنوان URL: عنوان الخادم نفسه.

بعد إضافته إلى أي عميل، اتبع خطوات التحقق نفسها: أعد التشغيل، وسجّل الدخول مجددًا، واعرض قائمة الأدوات، ثم اعرض قائمة الأنشطة التجارية بعملية قراءة آمنة.

ماذا يحدث في الجلسة الأولى: من قائمة الأنشطة التجارية إلى رسالة تجريبية؟#

تبدو الجلسة الأولى المعتادة مع الخادم المتصل كما يلي:

1. «اعرض الأنشطة التجارية التي أديرها»—يستدعي الوكيل whatsapp_biz_businesses، ثم تختار النشاط الذي تحتاج إليه.
2. «أرني حسابات WhatsApp وأرقام الهواتف لهذا النشاط التجاري»—يستدعي whatsapp_biz_accounts وwhatsapp_biz_phone_numbers مع عرض حالاتها.
3. «أضف رقم هاتفي التجريبي إلى الحساب»—يستدعي whatsapp_biz_add_phone_number.
4. «أرسل رمز تحقق عبر SMS»—يستدعي whatsapp_biz_send_verification_code. يصل الرمز إلى هاتفك.
5. «تحقّق من الرقم باستخدام الرمز 123456»—يستدعي whatsapp_biz_verify_phone_number، ثم يسجّل الرقم باستخدام whatsapp_biz_register_phone_number.
6. «أنشئ قالب order_update باللغة التي يفضلها المستلمون لإشعارات الطلبات»—يستدعي whatsapp_biz_create_template؛ وسيقدم الوكيل رابطًا إلى حالة الموافقة عليه.
7. «أرسل رسالة تجريبية إلى رقمي»—يستدعي whatsapp_biz_send_message؛ وسيؤكد الوكيل المستلِم قبل الإرسال.
8. «اضبط خطاف ويب على https://example.com/webhook»—يستدعي whatsapp_biz_configure_webhooks ويشترك باستخدام whatsapp_biz_subscribe_webhook.

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

ما قيود الإصدار التجريبي؟#

هناك أربعة قيود على الخادم ينبغي أخذها في الاعتبار.

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

الغرض. الإصدار مخصص للتطوير والاختبار، وليس للإرسال الجماعي في بيئة الإنتاج. لإرسال الرسائل في بيئة الإنتاج، ستحتاج إلى تكامل كامل مع Cloud API—على سبيل المثال، باستخدام رمز مستخدم نظام، ويقدم لك رابط إنشائهَ أداة whatsapp_biz_system_user_token.

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

قاعدة نافذة 24 ساعة. خارج نافذة محادثة العميل، لا يمكنك إرسال سوى القوالب المعتمدة.

لماذا يهم ذلك النشاط التجاري؟#

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

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

يُعرض نهج مشابه—يتصل فيه وكيل بنظام خارجي ويعمل معه بناءً على وصفك—مع وثائق في دليل كيفية ربط NotebookLM بـ Claude Code عبر MCP.

ما الخطوة التالية؟#

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

تجد طرقًا أخرى لربط وكيل بأنظمة خارجية في مجموعة خوادم MCP لـ Claude Code—فهناك سبعة تكاملات عملية أخرى لمهام مختلفة.

تعرّف على Ailoot.