خادم ManyMoney Messaging MCP

إشعار بميزة تجريبية

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

نظرة عامة

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

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

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

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

كيف يعمل

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

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

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

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

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

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

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

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

توصيل خادم MCP

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

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

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

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

في لوحة تحكم Pushwoosh، انتقل إلى Settings → API Access، انقر فوق Generate New Token، حدد Server، واحفظ الرمز. ستضيفه إلى تكوين العميل في الخطوة التالية.

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

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

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

https://manymoney-messaging.pushwoosh.com/mcp

Claude Desktop

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

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

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

Cursor / Windsurf

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

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

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

Other clients

وجه عميلك إلى https://manymoney-messaging.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	معرفات القنوات للإرسال من خلالها (push, email, SMS, etc.)
target	رمز الشريحة، تعبير الشريحة، أو قائمة صريحة من المستخدمين، hwid، أو رموز الدفع (الاستهداف للمعاملات)
message_payload	Push: العنوان والنص، أو إعداد مسبق للدفع، مع صوت اختياري، شارة، وإجراء فتح Email: الموضوع، النص أو قالب، مرفقات SMS and messengers: نص أو قالب معتمد
schedule	الإرسال في وقت محدد، بعد تأخير، أو متابعة المناطق الزمنية للمستخدم
dynamic_content_placeholders	قيم للعناصر النائبة مثل {{first_name}} أو {{promo_code}}
campaign	رمز الحملة لنسب الرسالة إليه
frequency_capping	تحديد التكرار يحد من عدد المرات التي يتلقى فيها كل مستخدم رسالة خلال نافذة زمنية

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

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

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

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

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

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

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

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

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

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

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

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

رسالة تليجرام إلى شريحة:

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

المصادقة

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

الطريقة	كيفية الاستخدام
API token	أضف Authorization: Token YOUR_API_TOKEN إلى كل طلب. يوصى به للوكلاء وخطوط الأنابيب الآلية.
Session token (SSO)	أضف Authorization: Bearer YOUR_SSO_TOKEN. للتكاملات البرمجية التي تستخدم Pushwoosh OAuth2 SSO للعمل تحت جلسة مستخدم معينة. غير مطلوب لإعدادات الوكيل النموذجية — استخدم Server API token بدلاً من ذلك.
OAuth 2.0 (dynamic client registration)	لعملاء MCP الذين يطبقون مواصفات ترخيص MCP بدلاً من ترويسة ثابتة. يعكس النطاق جلسة Pushwoosh SSO للمستخدم الذي قام بتسجيل الدخول (غير مقيد بتطبيقات معينة)، وتكون رموز الوصول صالحة لمدة 7 أيام، ورموز التحديث لمدة 30 يومًا. انظر تدفق تسجيل الدخول OAuth 2.0 أدناه.

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

تدفق تسجيل الدخول OAuth 2.0

العملاء الذين يدعمون تدفق OAuth لمواصفات MCP (على سبيل المثال، تسجيل الدخول إلى الخادم عن بعد في Claude Desktop) لا يحتاجون إلى رمز تم لصقه يدويًا — يكتشف العميل خادم الترخيص، ويسجل نفسه، ويأخذ المستخدم من خلال خطوة تسجيل الدخول والموافقة في Pushwoosh SSO:

1. الاكتشاف. يجلب العميل /.well-known/oauth-protected-resource و /.well-known/oauth-authorization-server على مضيف نقطة نهاية MCP للعثور على نقاط النهاية authorize، token، و register.
2. تسجيل العميل الديناميكي (DCR). يقوم العميل بإرسال POST إلى /register للحصول على client_id دون أي إعداد يدوي في لوحة التحكم.
3. الترخيص مع PKCE. يرسل العميل المستخدم إلى /authorize مع code_challenge باستخدام code_challenge_method=S256. PKCE إلزامي — لا تصادق نقطة نهاية الرمز على العميل بأي وسيلة أخرى، لذلك يتم رفض الطلب بدون تحدي S256 صالح.
4. تسجيل الدخول والموافقة في Pushwoosh SSO. يقوم المستخدم بتسجيل الدخول من خلال Pushwoosh SSO، ثم يؤكد وصول العميل على شاشة /oauth/consent قبل إصدار رمز ترخيص.
5. تبادل الرمز. يتبادل العميل الرمز ومحقق PKCE في /token للحصول على رمز وصول، ثم يرسله كـ Authorization: Bearer في طلبات MCP.

لا تحتاج إلى تكوين أي من هذا بنفسك — يهم فقط إذا كنت تقوم باستكشاف أخطاء عميل يطبق التدفق بشكل مختلف عن المتوقع.

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

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

ذو صلة

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

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

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