خادم ManyMoney Messaging MCP

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

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

نظرة عامة

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

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

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

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

كيف يعمل

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

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

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

• الإرسال على أي قناة مدعومة: الدفع (iOS, Android, Web)، البريد الإلكتروني، الرسائل القصيرة، واتساب، تليجرام، لاين، أو كاكاو.
• الوصول إلى شريحة: البث للجميع في شريحة.
• الوصول إلى مستخدمين محددين: الإرسال إلى واحد أو أكثر من معرفات المستخدمين بعد حدث (تحديث طلب، إعادة تعيين كلمة المرور، وما شابه).
• جدولة التسليم: الإرسال الآن، في وقت محدد، بعد تأخير، أو في المنطقة الزمنية المحلية لكل مستخدم.
• تخصيص المحتوى: ملء العناصر النائبة في القوالب مثل {{first_name}} أو {{promo_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://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"
      }
    }
  }
}

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

Other clients

وجه عميلك إلى 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	رمز الشريحة، تعبير الشريحة، أو قائمة صريحة من المستخدمين، hwid، أو رموز الدفع (الاستهداف المعاملاتي)
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 بنص “عرضك الحصري ينتهي الليلة.” أرسل الآن.

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

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

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

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

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

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