تخط وانتقل إلى المحتوى الرئيسي

كيفية ربط Wati MCP بـ Meta Muse أو Gemini CLI

الملخص

قم بتوصيل خادم Wati Model Context Protocol (MCP) بـ Meta Muse أو واجهة سطر أوامر Gemini (CLI) للعمل مع مساحة عمل Wati الخاصة بك باستخدام اللغة الطبيعية. بمجرد الاتصال، يمكنك استخدام عملاء الذكاء الاصطناعي المتوافقين لإدارة جهات الاتصال والمحادثات والرسائل والقوالب والحملات وغيرها من الميزات المدعومة.

يوضح لك هذا الدليل كيفية توصيل Wati MCP بـ Meta Muse وGemini CLI باستخدام مصادقة OAuth. يمكنك تسجيل الدخول باستخدام حساب Wati الحالي الخاص بك دون الحاجة إلى إنشاء حساب جديد أو إضافة مفتاح API إلى إعداداتك.

ملاحظة: خادم Wati MCP متاح للعملاء المشتركين في خطط Growth وPro وBusiness من Wati. إذا كنت تستخدم حاليًا حسابًا تجريبيًا، فيمكنك أيضًا تفعيل واستخدام خادم Wati MCP خلال فترة تجربتك.

التعليمات

اختر عميل الذكاء الاصطناعي الذي تريد توصيله بـ Wati واتبع الخطوات في القسم المقابل.

استخدم عنوان URL لخادم MCP الذي يتوافق مع منطقة مساحة عمل Wati الخاصة بك:

منطقة مساحة العمل

عنوان URL لخادم MCP

عالمي (Global)

https://mcp.wati.io/mcp

الاتحاد الأوروبي (EU)

https://eu-mcp.wati.io/mcp

الجزء 1: توصيل Wati MCP بـ Meta Muse

التوافر: Meta Muse متاح حاليًا فقط في الولايات المتحدة وكندا. إذا كنت خارج هذه المناطق، قم بتوصيل Wati عبر Gemini CLI بدلاً من ذلك (انظر الجزء 2).

قم بتوصيل Wati بـ Meta Muse مباشرة من تطبيق Muse. ستقوم بتسجيل الدخول إلى حساب Wati الحالي الخاص بك وتفويض الوصول عبر تدفق مصادقة OAuth الخاص بـ Wati.

خطوات الاتصال

1. افتح الموصلات (Connectors)

  • افتح تطبيق Muse، واذهب إلى Settings (الإعدادات)، ثم اختر Connectors (الموصلات).

2. افتح الموصلات المخصصة

  • انتقل للأسفل إلى قسم Custom (مخصص) واختر Custom connectors (موصلات مخصصة).

3. أدخل عنوان URL لخادم Wati MCP

  • في شاشة Add custom connector (إضافة موصل مخصص)، أدخل عنوان URL لخادم MCP الخاص بمنطقة مساحة العمل لديك من الجدول أعلاه.

4. اختر Wati

  • سيفتح متصفحك صفحة اتصال Wati. ستشير إلى أن agent.meta.ai يريد الاتصال بـ Wati وAstra. اختر Wati ثم اضغط على Continue (متابعة).

5. سجل الدخول وامنح إذن الوصول

  • في صفحة تسجيل دخول Wati، قم بتسجيل الدخول باستخدام حساب Wati الحالي الخاص بك. راجع طلب التفويض واقبل الوصول لإكمال عملية الاتصال.

لست بحاجة إلى إنشاء حساب جديد أو إنشاء مفتاح API.

6. ابدأ في استخدام Wati في Muse

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

الجزء 2: توصيل Wati MCP بـ Gemini CLI

يمكنك توصيل Wati MCP بـ Gemini CLI من Google عن طريق إضافة إعدادات خادم Wati إلى ملف إعدادات Gemini CLI الخاص بك. يستخدم Gemini CLI تقنية OAuth لمصادقة حساب Wati الخاص بك عبر متصفحك.

يتصل Gemini CLI بخوادم MCP المدرجة تحت mcpServers في ملف settings.json الخاص بك. يستخدم مدخل wati خيار httpUrl للوصول إلى خادم Wati MCP عبر Streamable HTTP، ويتيح لك oauth.enabled لـ Gemini CLI تسجيل دخولك عبر متصفحك، لذا لن تحتاج إلى إضافة مفتاح API إلى الملف. بمجرد التفويض، سيكتشف Gemini CLI أدوات Wati المتاحة لحسابك. لمزيد من خيارات الإعداد، راجع توثيق خادم Gemini CLI MCP.

المتطلبات الأساسية

قم بتثبيت Gemini CLI قبل البدء. اتبع دليل التثبيت والإعداد الرسمي لـ Gemini CLI.

خطوات الاتصال

نصيحة: إذا كنت تفضل عدم تحرير ملفات JSON، قم بتشغيل الأمر التالي في جهازك (Terminal) بدلاً من الخطوتين 1 و2، ثم تابع من الخطوة 3:

gemini mcp add --transport http wati <https://mcp.wati.io/mcp>

بالنسبة لمساحات عمل الاتحاد الأوروبي، استخدم عنوان URL الخاص بالاتحاد الأوروبي من الجدول أعلاه.

1. افتح ملف إعدادات Gemini CLI

  • افتح ~/.gemini/settings.json في محرر النصوص المفضل لديك.

    إذا لم يكن الملف موجودًا، قم بإنشائه.

2. أضف إعدادات خادم Wati MCP

تحت mcpServers، أضف الإعدادات التالية:

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

بالنسبة لمساحات عمل الاتحاد الأوروبي، استخدم عنوان URL الخاص بالاتحاد الأوروبي من الجدول أعلاه.

إذا كان ملف الإعدادات الخاص بك يحتوي بالفعل على خوادم MCP أخرى، أضف مدخل wati داخل كائن mcpServers الحالي. حافظ على الإعدادات الموجودة وتأكد من صحة صيغة JSON.

3. أعد تشغيل Gemini CLI

  • أغلق Gemini CLI وأعد تشغيله ليقوم بتحميل الإعدادات المحدثة.

4. سجل الدخول إلى Wati

  • عند استخدام الاتصال لأول مرة، سيفتح Gemini CLI متصفحك لبدء تدفق تسجيل دخول Wati OAuth. سجل الدخول باستخدام حساب Wati الحالي الخاص بك واقبل الوصول المطلوب.

5. عد إلى واجهة الأوامر (Terminal)

  • بمجرد اكتمال التفويض، عد إلى Gemini CLI وتابع استخدام خادم Wati المتصل.

6. قم بالمصادقة مرة أخرى إذا لزم الأمر

  • إذا كنت بحاجة إلى تسجيل الدخول مرة أخرى، قم بتشغيل الأمر التالي في Gemini CLI:

/mcp auth wati

7. تحقق من الاتصال

  • اطلب من Gemini CLI تنفيذ مهمة بسيطة، مثل:

List my Wati contacts.

إذا تم ضبط الاتصال والأذونات بشكل صحيح، يجب أن يتمكن Gemini CLI من استرداد معلومات جهات الاتصال المدعومة من مساحة عمل Wati الخاصة بك.

ما الذي يمكنك فعله باستخدام Wati MCP؟

اعتمادًا على أذونات مساحة العمل وخطة المنتج والقنوات المفعلة، يمكنك استخدام Muse أو Gemini CLI لتنفيذ مهام مثل:

  • جهات الاتصال: البحث عن جهات الاتصال، سردها، إضافتها، وتحديثها؛ إدارة سمات جهات الاتصال؛ عرض عدد جهات الاتصال؛ وتعيين جهات الاتصال للفرق.

  • المحادثات: استرداد الرسائل، إدارة العلامات وحالة المحادثة، تعيين المحادثات، وتحويل المحادثات إلى وكيل بشري.

  • المراسلة: إرسال رسائل نصية وملفات، استخدام الأزرار والقوائم التفاعلية، وإرسال قوالب الرسائل المعتمدة.

  • الحملات: العمل مع البث (Broadcasts)، عرض إحصائيات الحملات، تقدير تكاليف الإرسال، والتحقق من الأرصدة المتاحة.

  • إعداد مساحة العمل: إدارة الشرائح والقنوات والروابط التلقائية (Webhooks) وقوالب الرسائل المدعومة.

  • Instagram: استخدام سير عمل Instagram المدعوم حيثما تكون الميزة مفعلة لمساحة عملك.

أمثلة على الأوامر

بعد توصيل Wati بأي من العميلين، جرب طرح هذه الأسئلة:

  • "Find every conversation tagged billing from last week."

  • "Send the order_update template to contacts in the VIP Customers segment."

  • "How many contacts do we have?"

  • "Show me the latest messages in conversations assigned to my team."

هذه أمثلة على سير العمل المدعوم. تعتمد الإجراءات المتاحة لك على حسابك وإعدادات مساحة العمل الخاصة بك.

استكشاف الأخطاء وإصلاحها وملاحظات هامة

ضع النقاط التالية في الاعتبار عند استخدام Wati MCP مع أي من العميلين:

  • قد تختلف الأدوات المتاحة: يتم تحديد الأدوات المتاحة لحسابك بواسطة قائمة أدوات خادم MCP لجلسة العمل الموثقة الخاصة بك.

  • لا تزال الأذونات سارية: تحدد أذونات دورك في مساحة عمل Wati وخطة المنتج وأذونات القنوات الإجراءات التي يمكنك تنفيذها. قد تكون الأداة متاحة ولكنها تُرجع خطأ يتعلق بالأذونات أو الخطة عند استخدامها.

  • استخدم عنوان URL الصحيح للخادم: تأكد من استخدام نقطة النهاية العالمية (Global) أو الاتحاد الأوروبي (EU) التي تطابق مساحة عمل Wati الخاصة بك.

  • تحقق من إعداداتك: بالنسبة لـ Gemini CLI، تأكد من أن مدخل الخادم تحت mcpServers، وأن عنوان URL صحيح، وأن صيغة JSON صالحة.

  • استخدم جهازًا يحتوي على متصفح محلي (Gemini CLI): يفتح Gemini CLI متصفحًا على نفس الجهاز لإكمال تسجيل دخول Wati OAuth. لا يعمل هذا عبر SSH أو في البيئات الخالية من الواجهات الرسومية (Headless)، مثل الخوادم البعيدة أو الحاويات (Containers). قم بتشغيل Gemini CLI على جهاز يحتوي على متصفح لتسجيل الدخول.

  • أعد المصادقة إذا لزم الأمر: إذا كانت جلستك تتطلب تفويضًا متجددًا، قم بتشغيل /mcp auth wati في Gemini CLI.

  • لا يلزم وجود مفتاح API: تستخدم كلتا عمليتي التكامل مصادقة OAuth، لذا لن تحتاج إلى إضافة مفتاح Wati API إلى إعدادات الاتصال.

موارد ذات صلة

الأسئلة الشائعة (FAQs)

الأسئلة الشائعة حول تكامل Wati MCP

1. ما هو خادم Wati MCP، وما الذي يمكنني استخدامه لأجله؟

يقوم خادم Wati Model Context Protocol (MCP) بتوصيل عملاء الذكاء الاصطناعي المتوافقين، مثل Meta Muse وواجهة سطر أوامر Gemini (CLI) من Google، بمساحة عمل Wati الخاصة بك. يمكنك استخدام اللغة الطبيعية لتنفيذ مهام مدعومة، بما في ذلك البحث عن جهات الاتصال، وإدارة المحادثات، وإرسال قوالب الرسائل المعتمدة، وعرض إحصائيات الحملات، وإدارة الشرائح والروابط التلقائية المدعومة. تعتمد الإجراءات المتاحة على أذونات مساحة العمل وخطة المنتج والقنوات المفعلة.

2. ما هي خطط Wati التي تدعم MCP، وأي عملاء ذكاء اصطناعي يمكنني استخدامهم؟

خادم Wati MCP متاح في خطط Growth وPro وBusiness. يمكن للحسابات التجريبية أيضًا تفعيل الخادم واستخدامه خلال فترة التجربة. يمكنك توصيل Wati بـ Meta Muse أو Gemini CLI. Meta Muse متاح حاليًا فقط في الولايات المتحدة وكندا؛ ويمكن للعملاء خارج هذه المناطق استخدام Gemini CLI.

3. ما هو عنوان URL لخادم Wati MCP الذي يجب أن أستخدمه؟

استخدم عنوان URL الذي يطابق منطقة مساحة عمل Wati الخاصة بك:

  • عالمي (Global): https://mcp.wati.io/mcp

  • الاتحاد الأوروبي (EU): https://eu-mcp.wati.io/mcp

استخدم عنوان URL الإقليمي المناسب عند إعداد عميل الذكاء الاصطناعي الخاص بك.

الإعداد والمصادقة

4. كيف أقوم بتوصيل Wati MCP بـ Meta Muse؟

في تطبيق Muse، اذهب إلى الإعدادات (Settings) > الموصلات (Connectors) > الموصلات المخصصة (Custom connectors). أدخل عنوان URL لخادم Wati MCP الخاص بمنطقة مساحة عملك. عندما يفتح متصفحك صفحة اتصال Wati، اختر Wati، اضغط على متابعة (Continue)، سجل الدخول بحساب Wati الحالي، وامنح إذن الوصول. بمجرد الاتصال، يمكنك استخدام اللغة الطبيعية للتفاعل مع مساحة عمل Wati الخاصة بك.

5. كيف أقوم بتوصيل Wati MCP بـ Gemini CLI؟

أولاً، قم بتثبيت Gemini CLI. ثم أضف خادم Wati MCP إلى ~/.gemini/settings.json تحت mcpServers باستخدام الإعدادات التالية:

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

بالنسبة لمساحات عمل الاتحاد الأوروبي، استبدل عنوان URL بـ https://eu-mcp.wati.io/mcp. احفظ الإعدادات وأعد تشغيل Gemini CLI. عند الاستخدام لأول مرة، سجل الدخول إلى Wati عبر المتصفح وامنح إذن الوصول.

بدلاً من ذلك، يمكنك إضافة الخادم من واجهة الأوامر باستخدام:

gemini mcp add --transport http wati https://mcp.wati.io/mcp

بالنسبة لمساحات عمل الاتحاد الأوروبي، استخدم عنوان URL الخاص بالاتحاد الأوروبي بدلاً من ذلك.

6. هل أحتاج إلى مفتاح Wati API لتوصيل عميل ذكاء اصطناعي؟

لا. يستخدم كل من Meta Muse وGemini CLI مصادقة OAuth. قم بتسجيل الدخول بحساب Wati الحالي الخاص بك عبر المتصفح وامنح إذن الوصول. لا تحتاج إلى إنشاء حساب Wati جديد أو إضافة مفتاح API إلى إعداداتك.

استكشاف الأخطاء والأذونات

7. كيف أتحقق من اتصال Wati MCP أو أعيد مصادقته في Gemini CLI؟

للتحقق من الاتصال، اطلب من Gemini CLI: "List my Wati contacts." إذا كنت بحاجة إلى إعادة المصادقة، قم بتشغيل:

/mcp auth wati

أكمل عملية تسجيل الدخول عبر المتصفح وامنح الوصول عند المطالبة.

8. لماذا لا يستطيع Gemini CLI إكمال مصادقة Wati OAuth عبر SSH أو في بيئة خالية من الواجهات؟

يفتح Gemini CLI متصفحًا على نفس الجهاز الذي يعمل عليه لإكمال تسجيل دخول Wati OAuth. لا تعمل هذه العملية عبر SSH أو في البيئات الخالية من الواجهات الرسومية، مثل الخوادم البعيدة أو الحاويات. قم بتشغيل Gemini CLI على جهاز يحتوي على متصفح محلي لإكمال المصادقة.

9. لماذا يُرجع إجراء Wati MCP خطأً أو يبدو غير متاح؟

تعتمد الأدوات والإجراءات المتاحة على قائمة أدوات Wati MCP لجلسة العمل الموثقة، ودورك في مساحة العمل، وخطة المنتج، وأذونات القنوات المفعلة لديك. قد تكون الأداة متاحة ولكنها تُرجع خطأ يتعلق بالأذونات أو الخطة عند استخدامها. بالنسبة لمشكلات الاتصال بـ Gemini CLI، تحقق أيضًا من أن عنوان URL للخادم يطابق منطقة مساحة عملك، وأن الإعدادات موجودة تحت mcpServers، وأن صيغة JSON صالحة، وأن ميزة OAuth مفعلة.

المقالات ذات الصلة
هل أجاب هذا عن سؤالك؟