اربط عملاء الذكاء الاصطناعي المعتمدين بواتسلي

قبل البدء

يربط MCP عميلاً يدعم الذكاء الاصطناعي بوظائف حقيقية في واتسلي. تحقق من الخطة والجهاز والصلاحيات قبل إضافة الخادم.

• استخدم عميلاً متوافقاً مع MCP ويدعم خوادم stdio المحلية.
• اربط جهاز واتساب وتحقق من حالته في واتسلي.
• فعّل وصول MCP لخطة مساحة العمل عند الحاجة.
• أنشئ مفتاح API مخصصاً بصلاحيات الإرسال أو القراءة أو حالة الجهاز المطلوبة فقط.
• استخدم مستلماً تجريبياً وإجراء مراجعة قبل السماح برسائل موجهة للعملاء.

تثبيت الخادم

يمكن لعميل MCP تشغيل الحزمة عبر npx. احتفظ بتعريف الحزمة في إعدادات العميل وبالأسرار داخل متغيرات البيئة.

npx -y @whatsly/mcp-server

إعداد عميل MCP

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

{
  "mcpServers": {
    "whatsly": {
      "command": "npx",
      "args": ["-y", "@whatsly/mcp-server"],
      "env": {
        "WHATSLY_API_BASE_URL": "<copy-from-your-workspace>",
        "WHATSLY_API_KEY_ID": "<your-api-key-id>",
        "WHATSLY_API_KEY_SECRET": "<your-api-key-secret>",
        "WHATSLY_DEFAULT_DEVICE_ID": "<your-device-id>"
      }
    }
  }
}

فئات الأدوات المتاحة

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

whatsly_send_text_message

إرسال رسالة نصية مراجعة عبر الجهاز المحدد.

whatsly_send_template_message

إرسال قالب محفوظ في واتسلي مع المتغيرات.

whatsly_send_media_message

إرسال وسائط مدعومة من رابط يمكن الوصول إليه.

whatsly_get_device_status

التحقق من توفر الجهاز المحدد.

whatsly_list_conversations

عرض المحادثات المدعومة عندما تملك بيانات الاعتماد صلاحية القراءة.

whatsly_get_conversation_messages

قراءة الرسائل المدعومة من محادثة محددة.

استخدام أدوات الرسائل بأمان

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

• اطلب تأكيداً قبل الرسائل الحساسة أو عالية الأثر.
• لا تسمح للعميل باختراع الأسعار أو السياسات أو التوفر أو مواعيد التوصيل.
• لا تستخدم جهات اتصال مشتراة أو مجمعة آلياً أو تم الحصول عليها بصورة غير مشروعة.
• احترم إلغاء الاشتراك وسجلات الحظر في الإرسال اليدوي والآلي وعبر MCP.
• أبقِ بيانات اعتماد الجهاز وAPI خارج المطالبات والسجلات وأمثلة الإعداد المشتركة.
• ألغِ بيانات اعتماد MCP عند إزالة العميل.

استكشاف الأخطاء

افحص الاتصال على مراحل: عملية العميل، ومتغيرات البيئة، وصلاحيات بيانات الاعتماد، وحالة الجهاز.

1. 1

   الخادم لا يبدأ

   تأكد من توفر Node.js وnpx لعميل MCP وأن أمر الحزمة يعمل في بيئة العميل.

2. 2

   فشل المصادقة

   انسخ عنوان API وبيانات الاعتماد مرة أخرى، وأزل المسافات غير المقصودة، وتأكد من أن المفتاح لم يُلغَ.

3. 3

   الأداة غير ظاهرة

   راجع صلاحيات المفتاح وميزة خطة مساحة العمل. تحتاج أدوات القراءة إلى صلاحية القراءة المقابلة.

4. 4

   الرسائل لا تُرسل

   تحقق من حالة الجهاز وتنسيق المستلم ووسائط الأداة المطلوبة وحدود الاستخدام وسجل الرسائل في واتسلي.