مرجع أدوات MCP

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

القراءة: تعيد 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.

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

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

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

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

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

تتوقف الأدوات الأربع التي تتعامل مع العالم الخارجي: send_message وsend_template وcreate_template وset_webhook_destination. أما كل ما يقرأ فيظل متاحاً.

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

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

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

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

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

تابع القراءة