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

مرجع أدوات MCP

يتيح الموصل أكثر من 30 أداة عبر كل اتصال في الحساب. تأتي list_numbers أولاً لـ WhatsApp، لأن أدواته تتطلب connection_id الخاص بها، وlist_social_accounts للقنوات الأخرى، لأن أدواتها تتطلب account_id. تتوقف ست أدوات عند تعثر الفوترة: أدوات WhatsApp الأربع التي تتعامل مع العالم الخارجي، وget_api_credentials التي تعيد رمز الوصول، وcreate_connect_link. أما بقية الأدوات فتظل مفتوحة.

30+

الأدوات التي يتيحها الموصل.

6

الأدوات التي تتوقف عند تعثر الفوترة، ومنها get_api_credentials التي تعيد رمز الوصول.

1

تسجيل الدخول عبر OAuth، ويشمل كل أرقام الحساب.

ماذا تفعل كل أداة؟

القراءة: تعيد list_numbers الأرقام المتصلة مع الحالة وتقييم الجودة ومستوى المراسلة، ومنها يبدأ كل طلب آخر. تعيد get_number_health لقطة مباشرة من Meta، إلى جانب الخط الزمني الأخير للمراقبة وأحداث webhook وفحوصات أداة الاستطلاع. تعيد get_api_credentials عنوان Graph API الأساسي وWABA id وphone number id، ورمز الوصول (token) الخاص بالحساب عند توفره.

الإرسال: ترسل send_message نصاً حراً داخل نافذة 24 ساعة، وتكون الردود خلالها مجانية. ترسل send_template قالباً معتمداً، وهي الطريقة لبدء محادثة مع شخص لم يكتب إليك. تغطي list_templates وcreate_template وget_template_status دورة حياة القالب.

الربط: توجّه set_webhook_destination الرسائل الواردة ونسخ التطبيق إلى نظامك، وتمرير null يعيد الإعداد إلى حالته الأصلية. تعيد get_connect_link رابط لوحة التحكم وخطوات ربط رقم جديد. تعيد get_docs وثائق المنتج بصيغة markdown.

Partner API، للبرمجيات أو الوكالات التي يربط عملاؤها أرقامهم: تعرض get_partner_setup حالة الفوترة ومفتاح API وعنوان URL للأحداث والخطوة التالية. تُصدر create_api_key مفتاح Partner API وتعرضه مرة واحدة فقط، ولا تستبدل مفتاحاً قائماً دون تأكيد صريح. تُلغي revoke_api_key المفتاح، وذلك أيضاً بعد التأكيد. تحدد set_partner_events_url وجهة أحداث الحالة وتعيد سر التوقيع مرة واحدة. تنشئ create_connect_link رابط ربط مستضافاً لعميل واحد، صالحاً لمدة ساعة واحدة، تماماً مثل POST /api/v1/connect-sessions.

لماذا يُعد connection_id مهماً؟

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

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

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

ماذا يحدث عند تعثر الفوترة؟

تتوقف ست أدوات: send_message وsend_template وcreate_template وset_webhook_destination، التي تتعامل مع العالم الخارجي؛ وget_api_credentials، لأنها تعيد رمز الوصول الخاص بالحساب، وهو ما يتيح لحساب محظور الإرسال مباشرة عبر Graph API؛ وcreate_connect_link التي تربط رقماً جديداً. أما كل قراءة أخرى فتظل متاحة، وكذلك إعداد Partner API: get_partner_setup وcreate_api_key وrevoke_api_key وset_partner_events_url.

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

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

الأخطاء الشائعة

  • توقع أن يستقبل الموصل الرسائل. يعمل MCP بنظام الطلب والاستجابة، أما حركة الرسائل الواردة فتحتاج إلى webhook.
  • تثبيت connection_id يدوياً. فهو يأتي من list_numbers وليس قيمة ينبغي تدوينها.
  • افتراض أن الحساب المتعثر في الفوترة أصبح غير متصل بالكامل. تستمر القراءة والمراقبة عمداً، باستثناء بيانات الاعتماد، لأنها تحمل رمز الوصول الذي يُرسَل به.
إنجاز ذلك باستخدام EasyCoexistence

يغطي موصل واحد كل أرقام الحساب، مع تفويض عبر OAuth ومن دون لصق مفتاح. يبدأ السعر من US$ 9 لكل رقم شهرياً، وينخفض إلى US$ 0.75 عند زيادة العدد، مع أول 3 أيام مجاناً.

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

هل أختار الأداة التي يجب استدعاؤها؟

لا. اطرح طلبك بلغة طبيعية، وسيختار المساعد الأداة المناسبة، فهذا هو الغرض من كتابة أوصاف الأدوات.

هل يستطيع قراءة محادثاتي؟

لا. تُوجّه الرسائل الواردة إلى وجهة webhook التي تحددها. ويقرأ الموصل حالة الحساب والرقم.

هل تُعد get_docs مفيدة؟

أكثر مما يبدو. فهي تسلّم المساعد وثائقنا بصيغة markdown، لذلك تأتي الإجابات عن قواعد Coexistence من وثائقنا لا من الذاكرة.

هل يغطي موصل واحد عدة عملاء؟

نعم. يستوعب الحساب العدد الذي تحتاجه من الأرقام، وتعيد list_numbers جميعها.

تابع القراءة

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

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

ابدأ الفترة التجريبية المجانية

تم التحقق في