دليل دمج واتساب للأعمال في تطبيقك عبر MCP

الاتصال والمفتاح

اربط رقم واتساب للأعمال في حساب Enlazá، ثم أنشئ مفتاحاً شخصياً للتكامل. اختر أقل الصلاحيات اللازمة، وانسخ السر عند عرضه واحفظه في مدير أسرار الخادم. لا تطبعه في السجلات أو الروابط أو المحادثات. العنوان https://enlaza.chat/mcp يستخدم MCP عبر HTTPS، وليس REST عاماً.

تهيئة العميل وأول قراءة

أرسل طلب initialize ثم notifications/initialized، وبعدها tools/list. استدعِ whatsapp_accounts لاختيار معرّف الاتصال المصرّح به، ثم whatsapp_messages. أرسل كل كائن JSON-RPC في POST منفصل واحتفظ بترويسة إصدار البروتوكول المتفاوض عليه. القيم بين الأقواس في المثال مواضع استبدال وليست أسراراً حقيقية.

POST /mcp HTTP/1.1
Host: enlaza.chat
Authorization: Bearer <ENLAZA_PERSONAL_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-business-app","version":"1.0.0"}}}

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "whatsapp_accounts",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "whatsapp_messages",
    "arguments": {
      "connection_id": "<ID_FROM_WHATSAPP_ACCOUNTS>"
    }
  }
}

الصلاحيات والأدوات

اكتشف الأدوات عبر tools/list ولا تفترض دعماً غير معروض. السجل والوسائط المتاحة ليست بالضرورة كاملة. قدرات العرض والأحداث تعتمد أيضاً على عميل MCP.

تحدّد الصلاحيات وبيانات الرقم المتاحة وقدرات العميل ما يمكن تنفيذه. لا يُضمن استرجاع كل المحادثات أو الوسائط القديمة. يحتاج إرسال النص الحر إلى رسالة واردة من جهة الاتصال خلال آخر 24 ساعة. خارج هذه النافذة، استخدم قالباً معتمداً مناسباً مع موافقة المستلم وتفويض الإرسال. لا يعني ربط الحساب إرسال رسائل تلقائياً إلى الجميع.

إشعارات الرسائل وWebhooks

أنشئ اشتراكاً في whatsapp.message.received للاتصال المصرّح به. أعدّ مستقبِل HTTPS حقيقياً وتحقق من توقيع الطلبات. يبدأ سر التوقيع بـ whsec_ وتتبعه قيمة عشوائية من 24–64 بايت بترميز Base64. بعد التحقق من طلب type=verification، أعد JSON يحتوي challenge بالقيمة المستلمة نفسها. عنوان المثال موضع استبدال؛ لا ترسل إليه بيانات.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "events/subscribe",
  "params": {
    "name": "whatsapp.message.received",
    "arguments": {
      "connection_id": "<ID_FROM_WHATSAPP_ACCOUNTS>"
    },
    "delivery": {
      "mode": "webhook",
      "url": "https://your-app.example/mcp-events",
      "secret": "<WEBHOOK_SIGNING_SECRET>"
    },
    "ttlMs": 86400000
  }
}

تحقق من قبول الاشتراك وتسليم الإشعارات ومن expiresAt. أعد الاشتراك أو جدده قبل انتهائه وفق العقد المتاح. تجديد المفتاح لا يجدد اشتراكاً منتهياً تلقائياً؛ نفّذ تحقق التوقيع والتعامل الآمن مع التكرار في تطبيقك.

انتهاء المفتاح وتجديده

الفترات المحدودة المتاحة 30 أو 90 أو 365 يوماً. لا تمتد المفاتيح الموجودة تلقائياً. عند التجديد احفظ السر الجديد في خادم التكامل وتحقق من اشتراكات الأحداث. يمكنك إلغاء المفتاح؛ لا تشاركه بين تكاملات غير مرتبطة.

إذا لم يعمل التكامل

تعليمات لمساعد البرمجة

اقرأ دليل Enlazá لدمج تطبيقي مع واتساب للأعمال. ابدأ بعرض الحسابات والرسائل المتاحة، واستخدم أقل الصلاحيات اللازمة. لا ترسل شيئاً قبل تحديد المستلم والمحتوى والتفويض. احفظ المفتاح في أسرار الخادم ولا تعرضه في الكود العام أو السجلات.

العقد الكامل للأدوات والوكلاء بالإنجليزية · الدليل العام بالعربية