خادم ManyMoney Messaging MCP

ملاحظة حول الميزة التجريبية

خادم ManyMoney Messaging MCP في مرحلة تجريبية. قد تتغير نقطة النهاية وخيارات المصادقة.

نظرة عامة

خادم ManyMoney Messaging MCP هو النظير المرسل لـ خادم ManyMoney AI MCP. حيث يساعدك خادم ManyMoney AI MCP على تخطيط وبناء الحملات، يمنح خادم Messaging MCP وكيل الذكاء الاصطناعي الخاص بك القدرة على تسليم الرسائل فعليًا — إشعارات الدفع، والبريد الإلكتروني، والرسائل القصيرة، وWhatsApp، وTelegram، وLINE، وKakao، والمزيد — عند الطلب، من خلال تعليمات باللغة الطبيعية.

قم بتوصيله بأي عميل بروتوكول سياق النموذج (MCP) ويمكن لوكيلك إرسال إشعار دفع إلى شريحة أو إرسال بريد إلكتروني مخصص لمستخدم معين، كل ذلك من طلب واحد باللغة الطبيعية.

القنوات المدعومة

القناة	أنواع الرسائل
إشعارات الدفع — iOS	الإشعارات القياسية والصامتة والحرجة، وإشعارات VoIP، والأنشطة المباشرة (Live Activities)
إشعارات الدفع — Android	الإشعارات القياسية، بالإضافة إلى Huawei، وBaidu، وAmazon Fire
إشعارات الدفع — الويب	إشعارات الدفع على الويب في Chrome، وFirefox، وSafari، وEdge (Windows)
البريد الإلكتروني	محتوى HTML، قوالب، مرفقات، From/Reply-To مخصص
الرسائل القصيرة (SMS)	رسائل نصية عبر منصة الرسائل القصيرة المكونة على حسابك
WhatsApp	قوالب معتمدة من Meta للإرسال الصادر؛ نص حر فقط خلال نافذة 24 ساعة بعد أن يراسلك المستخدم أولاً
Telegram	رسائل نصية مع متغيرات المحتوى
LINE	رسائل المحتوى والقوالب
Kakao	رسائل المحتوى والقوالب

كيف يعمل

1. قم بتوصيل خادم Messaging MCP بعميل الذكاء الاصطناعي الخاص بك مرة واحدة (انظر توصيل خادم MCP أدناه).
2. في عميل الذكاء الاصطناعي الخاص بك، افتح محادثة جديدة وصف عملية الإرسال بلغة بسيطة. قم بتضمين التطبيق، والجمهور (شريحة أو مستخدمين محددين)، ونص الرسالة، ومتى يتم الإرسال إذا لم يكن فوريًا. انظر ما يجب تضمينه في طلبك أدناه. لا تحتاج إلى بناء طلبات API أو JSON بنفسك.
3. عندما يكون الوكيل جاهزًا للإرسال، راجع التفاصيل ووافق على الإجراء في عميلك.
4. بعد موافقتك، يرسل Pushwoosh الرسالة ويعيد رمز الرسالة. استخدمه في سجل الرسائل للعثور على الإرسال وتتبع التسليم والإحصائيات.

ما يمكن لوكيلك القيام به

بعد الإعداد، يمكن للوكيل:

• الإرسال على أي قناة مدعومة: إشعارات الدفع (iOS، Android، الويب)، البريد الإلكتروني، الرسائل القصيرة، WhatsApp، Telegram، LINE، أو Kakao.
• الوصول إلى شريحة: البث للجميع في شريحة.
• الوصول إلى مستخدمين محددين: الإرسال إلى معرف مستخدم واحد أو أكثر بعد حدث (تحديث طلب، إعادة تعيين كلمة المرور، وما شابه).
• جدولة التسليم: الإرسال الآن، في وقت محدد، بعد تأخير، أو في المنطقة الزمنية المحلية لكل مستخدم.
• تخصيص المحتوى: ملء العناصر النائبة في القالب مثل {{first_name}} أو {{promo_code}} لكل مستلم.
• احتساب الإرسالات ضمن حملة: أخبر الوكيل بـ رمز الحملة الذي يجب استخدامه. يظهر التسليم والتفاعل لهذا الإرسال تحت تلك الحملة في لوحة التحكم (Control Panel).

انظر أمثلة طلبات المحادثة في إرسال الرسائل من عميل الذكاء الاصطناعي الخاص بك أدناه.

عملاء الذكاء الاصطناعي المتوافقون

يعمل خادم Messaging MCP مع أي عميل متوافق مع MCP، بما في ذلك:

• Claude Desktop من Anthropic
• Cursor و Windsurf
• Cline و Continue
• وكلاء مخصصون مبنيون على مواصفات MCP

توصيل خادم MCP

مطلوب مساعدة المطور

قد تحتاج إلى مساعدة من فريق التطوير الخاص بك لتوصيل خادم Messaging MCP بعميل الذكاء الاصطناعي الخاص بك. يرجى مشاركة هذا الدليل معهم.

الخطوة 1. تأكد من أن لديك حساب Pushwoosh ورمز API

يصادق خادم Messaging MCP باستخدام رمز Pushwoosh Server API.

في لوحة تحكم Pushwoosh، انتقل إلى الإعدادات → الوصول إلى API، انقر فوق إنشاء رمز جديد، حدد خادم، واحفظ الرمز. ستضيفه إلى تكوين العميل في الخطوة التالية.

يرث الرمز أذونات حسابك. قم بتقييده على التطبيقات التي تريد أن يرسل الوكيل من خلالها.

الخطوة 2. أضف الخادم إلى عميل الذكاء الاصطناعي الخاص بك

استخدم نقطة النهاية التالية:

https://messaging-api.svc-nue.pushwoosh.com/mcp

Claude Desktop

أضف الخادم إلى ملف تكوين Claude Desktop الخاص بك (claude_desktop_config.json):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

أعد تشغيل Claude Desktop بعد الحفظ.

Cursor / Windsurf

أضف الخادم إلى ملف .cursor/mcp.json الخاص بك (أو الملف المكافئ في Windsurf):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

أعد تحميل المحرر بعد الحفظ.

عملاء آخرون

وجه عميلك إلى https://messaging-api.svc-nue.pushwoosh.com/mcp وقم بتعيين رأس الطلب Authorization: Token YOUR_API_TOKEN. ارجع إلى وثائق عميلك لإضافة خادم MCP عن بعد مع رؤوس مخصصة.

الخطوة 3. جربه

افتح محادثة جديدة في عميل الذكاء الاصطناعي الخاص بك واطلب شيئًا ملموسًا:

“في التطبيق XXXXX-XXXXX، أرسل إشعار دفع إلى أجهزة الاختبار الخاصة بي بعنوان ‘مرحبًا من الوكيل’ ونص ‘هذه رسالة اختبار’.”

قبل الموافقة على إجراء الوكيل، تأكد من الجمهور ومحتوى الرسالة.

إذا نجح الاتصال، يرسل الوكيل الرسالة ويعيد رمز رسالة Pushwoosh مثل PW-12345-67890.

إرسال الرسائل من عميل الذكاء الاصطناعي الخاص بك

يرسل الوكيل رسالة واحدة لكل طلب.

راجع قبل الموافقة

الرسائل المرسلة عبر خادم Messaging MCP هي عمليات تسليم حقيقية. يتم إرسالها بمجرد موافقتك على إجراء الإرسال الآن، أو في الجدول الزمني الذي تحدده. قبل الموافقة على إجراء في عميل الذكاء الاصطناعي الخاص بك، تحقق من التطبيق والجمهور والقناة ونص الرسالة والجدول الزمني. كن حذرًا بشكل خاص عندما يكون الهدف شريحة. لا يمكن للوكيل إلغاء الإرسال بمجرد موافقتك عليه. يمكن إلغاء الرسائل المجدولة من سجل الرسائل في لوحة تحكم Pushwoosh، ولكن فقط قبل بدء الإرسال.

ما يجب تضمينه في طلبك

صف التفاصيل أدناه في محادثتك حتى يعرف الوكيل ما يجب إرساله، ومن يجب أن يستلمه، ومتى. استخدم لغة بسيطة (على سبيل المثال، “تطبيق XXXXX-XXXXX”، “شريحة cart-abandonment”).

ما يجب تضمينه	الوصف
application	رمز التطبيق (XXXXX-XXXXX)
platforms	معرفات القنوات للإرسال من خلالها (إشعارات الدفع، البريد الإلكتروني، الرسائل القصيرة، إلخ.)
target	رمز الشريحة، تعبير الشريحة، أو قائمة صريحة من المستخدمين، hwids، أو رموز الدفع (الاستهداف للمعاملات)
message_payload	إشعار الدفع: العنوان والنص، أو إعداد مسبق للدفع، مع صوت وشارة وإجراء فتح اختياري البريد الإلكتروني: الموضوع، النص أو قالب، المرفقات الرسائل القصيرة والمراسلين: نص أو قالب معتمد
schedule	الإرسال في وقت محدد، بعد تأخير، أو اتباع المناطق الزمنية للمستخدم
dynamic_content_placeholders	قيم للعناصر النائبة مثل {{first_name}} أو {{promo_code}}
campaign	رمز الحملة لإسناد الرسالة إليه
frequency_capping	تحديد سقف التكرار يحد من عدد المرات التي يتلقى فيها كل مستخدم رسالة خلال فترة زمنية

كيف يرسل الوكيل رسالة

يستخدم الوكيل أداة Notify لإنشاء وإرسال رسالة واحدة. يدعم وضعين للاستهداف:

الوضع	متى يستخدم
الشريحة	البث لجميع المستخدمين المطابقين لـ شريحة أو تعبير شريحة. يدعم الجدولة، تحديد سقف التكرار، معدل الإرسال، ومجموعات التحكم.
معاملاتي	الإرسال إلى قائمة محددة من المستخدمين، hwids، أو رموز الدفع. مثالي للرسائل المشغلة أو المخصصة.

أمثلة على الطلبات

إشعار دفع إلى شريحة:

في التطبيق XXXXX-XXXXX، أرسل إشعار دفع إلى شريحة cart-abandonment على iOS و Android.

العنوان: “هل ما زلت تفكر في الأمر؟” النص: “عربة التسوق الخاصة بك في انتظارك، إليك خصم 10٪.”

جدول الإرسال الساعة 3 مساءً في المنطقة الزمنية المحلية لكل مستخدم. استخدم رمز الحملة spring-promo.

بريد إلكتروني إلى مستخدم واحد:

في التطبيق XXXXX-XXXXX، أرسل بريدًا إلكترونيًا إلى المستخدم uid-123 باستخدام قالب البريد الإلكتروني welcome-flow-v2 مع تعيين العنصر النائب {{first_name}} إلى Alex.

رسالة قصيرة إلى شريحة:

في التطبيق XXXXX-XXXXX، أرسل رسالة قصيرة إلى شريحة vip-users بنص “عرضك الحصري ينتهي الليلة.” أرسل الآن.

رسالة Telegram إلى شريحة:

في التطبيق XXXXX-XXXXX، أرسل رسالة Telegram إلى شريحة subscribers-monthly بنص “مرحبًا {{first_name}}، فاتورة شهر مايو جاهزة — قم بتنزيلها من حسابك.” جدولها ليوم غد الساعة 10:00 صباحًا بالتوقيت العالمي المنسق.

المصادقة

يدعم خادم Messaging MCP طريقتي مصادقة:

الطريقة	كيفية الاستخدام
رمز API	أضف Authorization: Token YOUR_API_TOKEN إلى كل طلب. موصى به للوكلاء وخطوط الأنابيب الآلية.
رمز الجلسة (SSO)	أضف Authorization: Bearer YOUR_SSO_TOKEN. للتكاملات البرمجية التي تستخدم Pushwoosh OAuth2 SSO للعمل تحت جلسة مستخدم معينة. غير مطلوب لإعدادات الوكيل النموذجية — استخدم رمز Server API بدلاً من ذلك.

يتم رفض الطلبات التي تحتوي على رمز مفقود أو غير صالح برمز HTTP 401.

نصائح وأفضل الممارسات

• راجع دائمًا كل عملية إرسال بعناية قبل الموافقة عليها. هذه عمليات تسليم حقيقية، ويتم إرسالها عند الموافقة أو في الوقت المحدد. تأكد من أن التطبيق والجمهور والقناة ونص الرسالة في العميل يطابق ما كنت تنوي.
• استخدم رمز Server API مخصص للوكيل. قم بإنشاء رمز Server API منفصل في الإعدادات → الوصول إلى API وقم بتقييده على التطبيقات التي يجب أن يرسل الوكيل منها. بهذه الطريقة يبقى وصول الوكيل مقتصرًا على تلك التطبيقات فقط.
• استخدم الاستهداف للمعاملات للرسائل المشغلة. عند الإرسال إلى معرف مستخدم معروف بعد حدث (شحن طلب، إعادة تعيين كلمة المرور)، استخدم وضع transactional مع users: [userId]. لا تقم بإنشاء شريحة من شخص واحد لنفس الإرسال. انظر NotifyTransactional.
• اختبر على أجهزة الاختبار قبل إرسال كبير. قبل الإرسال إلى شريحة حقيقية، اطلب من الوكيل الإرسال إلى أجهزة الاختبار المسجلة أولاً. على سبيل المثال: “في التطبيق XXXXX-XXXXX، أرسل إشعار دفع إلى أجهزة الاختبار الخاصة بي بعنوان ‘اختبار’ ونص ‘تحقق من النص هنا’.” هذا يوجه الرسالة فقط إلى الأجهزة التي أضفتها في الإعدادات → أجهزة الاختبار. عندما تبدو المعاينة صحيحة، اطلب الشريحة أو الجمهور الحقيقي.
• حدد اسم حملة في طلبك. قم بتضمين رمز حملة في المحادثة (على سبيل المثال، spring-promo) حتى تظهر النتائج تحت الحملة الصحيحة في لوحة تحكم Pushwoosh.
• تأكد قبل البث. قم بتكوين عميل الذكاء الاصطناعي الخاص بك لطلب تأكيد صريح قبل الموافقة على أي استدعاء أداة يستهدف شريحة. البث لجمهور كبير لا يمكن التراجع عنه.
• استخدم العناصر النائبة للتخصيص. مرر قيمًا للعناصر النائبة مثل {{first_name}} أو {{promo_code}} في طلب محادثتك بدلاً من بناء رسائل منفصلة لكل مستخدم.

مواضيع ذات صلة

خادم ManyMoney AI MCP: تخطيط وبناء الحملات

ManyMoney AI داخل لوحة التحكم

نظرة عامة على أدوات الذكاء الاصطناعي