# خادم ManyMoney Messaging MCP

<Aside type="tip" title="ملاحظة حول الميزة التجريبية">
خادم ManyMoney Messaging MCP في مرحلة تجريبية. قد تتغير نقطة النهاية وخيارات المصادقة.
</Aside>

## نظرة عامة

خادم ManyMoney Messaging MCP هو النظير المرسل لـ [خادم ManyMoney AI MCP](/ar/product/pushwoosh-ai/manymoney-mcp-server/). حيث يساعدك خادم ManyMoney AI MCP على تخطيط وبناء الحملات، يمنح خادم Messaging MCP وكيل الذكاء الاصطناعي الخاص بك القدرة على **تسليم الرسائل فعليًا** — إشعارات الدفع، والبريد الإلكتروني، والرسائل القصيرة، وWhatsApp، وTelegram، وLINE، وKakao، والمزيد — عند الطلب، من خلال تعليمات باللغة الطبيعية.

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

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

| القناة | أنواع الرسائل |
| --- | --- |
| **إشعارات الدفع — 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](#connect-the-mcp-server) أدناه).
2. في عميل الذكاء الاصطناعي الخاص بك، افتح محادثة جديدة وصف عملية الإرسال بلغة بسيطة. قم بتضمين التطبيق، والجمهور (شريحة أو مستخدمين محددين)، ونص الرسالة، ومتى يتم الإرسال إذا لم يكن فوريًا. انظر [ما يجب تضمينه في طلبك](#what-to-include-in-your-request) أدناه. لا تحتاج إلى بناء طلبات API أو JSON بنفسك.
3. عندما يكون الوكيل جاهزًا للإرسال، راجع التفاصيل ووافق على الإجراء في عميلك.
4. بعد موافقتك، يرسل Pushwoosh الرسالة ويعيد [رمز الرسالة](/ar/developer/api-reference/api-identifiers/#message-code). استخدمه في [سجل الرسائل](/ar/product/statistics-and-analytics/message-history/) للعثور على الإرسال وتتبع التسليم والإحصائيات.

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

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

- **الإرسال على أي قناة مدعومة:** إشعارات الدفع (iOS، Android، الويب)، البريد الإلكتروني، الرسائل القصيرة، WhatsApp، Telegram، LINE، أو Kakao.
- **الوصول إلى شريحة:** البث للجميع في [شريحة](/ar/product/audience-data-and-segmentation/segmentation/).
- **الوصول إلى مستخدمين محددين:** الإرسال إلى [معرف مستخدم](/ar/developer/api-reference/api-identifiers/#user-id) واحد أو أكثر بعد حدث (تحديث طلب، إعادة تعيين كلمة المرور، وما شابه).
- **جدولة التسليم:** الإرسال الآن، في وقت محدد، بعد تأخير، أو في المنطقة الزمنية المحلية لكل مستخدم.
- **تخصيص المحتوى:** ملء العناصر النائبة في القالب مثل `{{first_name}}` أو `{{promo_code}}` لكل مستلم.
- **احتساب الإرسالات ضمن حملة:** أخبر الوكيل بـ [رمز الحملة](/ar/developer/api-reference/api-identifiers/#campaign-code) الذي يجب استخدامه. يظهر التسليم والتفاعل لهذا الإرسال تحت تلك الحملة في لوحة التحكم (Control Panel).

انظر [أمثلة طلبات المحادثة](#example-prompts) في [إرسال الرسائل من عميل الذكاء الاصطناعي الخاص بك](#send-messages-from-your-ai-client) أدناه.

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

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

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

## توصيل خادم MCP

<Aside type="caution" icon="setting" title="مطلوب مساعدة المطور">
قد تحتاج إلى مساعدة من فريق التطوير الخاص بك لتوصيل خادم Messaging MCP بعميل الذكاء الاصطناعي الخاص بك. يرجى مشاركة هذا الدليل معهم.
</Aside>

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

يصادق خادم Messaging MCP باستخدام [رمز Pushwoosh Server API](/ar/developer/api-reference/api-access-token/#server-api-token).

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

يرث الرمز أذونات حسابك. [قم بتقييده على التطبيقات](/ar/developer/api-reference/api-access-token/#edit-token) التي تريد أن يرسل الوكيل من خلالها.

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

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

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

<Tabs>
  <TabItem label="Claude Desktop">
أضف الخادم إلى ملف تكوين Claude Desktop الخاص بك (`claude_desktop_config.json`):

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

أعد تشغيل Claude Desktop بعد الحفظ.
  </TabItem>
  <TabItem label="Cursor / Windsurf">
أضف الخادم إلى ملف `.cursor/mcp.json` الخاص بك (أو الملف المكافئ في Windsurf):

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

أعد تحميل المحرر بعد الحفظ.
  </TabItem>
  <TabItem label="عملاء آخرون">
وجه عميلك إلى `https://messaging-api.svc-nue.pushwoosh.com/mcp` وقم بتعيين رأس الطلب `Authorization: Token YOUR_API_TOKEN`. ارجع إلى وثائق عميلك لإضافة خادم MCP عن بعد مع رؤوس مخصصة.
  </TabItem>
</Tabs>

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

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

> *"في التطبيق `XXXXX-XXXXX`، أرسل إشعار دفع إلى أجهزة الاختبار الخاصة بي بعنوان 'مرحبًا من الوكيل' ونص 'هذه رسالة اختبار'."*


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

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


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

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

<Aside type="caution" title="راجع قبل الموافقة">
الرسائل المرسلة عبر خادم Messaging MCP هي عمليات تسليم حقيقية. يتم إرسالها بمجرد موافقتك على إجراء الإرسال الآن، أو في الجدول الزمني الذي تحدده. قبل الموافقة على إجراء في عميل الذكاء الاصطناعي الخاص بك، تحقق من التطبيق والجمهور والقناة ونص الرسالة والجدول الزمني. كن حذرًا بشكل خاص عندما يكون الهدف شريحة. لا يمكن للوكيل إلغاء الإرسال بمجرد موافقتك عليه. يمكن إلغاء الرسائل المجدولة من [سجل الرسائل](/ar/product/statistics-and-analytics/message-history/) في لوحة تحكم Pushwoosh، ولكن فقط قبل بدء الإرسال.
</Aside>

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

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

| ما يجب تضمينه | الوصف |
| --- | --- |
| `application` | [رمز التطبيق](/ar/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [معرفات القنوات](/ar/developer/api-reference/messaging-api-v2/notify/#platform-enum) للإرسال من خلالها (إشعارات الدفع، البريد الإلكتروني، الرسائل القصيرة، إلخ.) |
| `target` | [رمز الشريحة](/ar/developer/api-reference/api-identifiers/#segment--filter-code)، [تعبير الشريحة](/ar/developer/api-reference/segmentation-filters-api/segmentation-language/)، أو قائمة صريحة من [المستخدمين](/ar/developer/pushwoosh-knowledge-hub/users-userids/)، [hwids](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)، أو [رموز الدفع](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ([الاستهداف للمعاملات](/ar/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **إشعار الدفع:** العنوان والنص، أو [إعداد مسبق للدفع](/ar/product/content/push-presets/)، مع صوت وشارة وإجراء فتح اختياري<br /><br />**البريد الإلكتروني:** الموضوع، النص أو [قالب](/ar/product/content/email-content/)، المرفقات<br /><br />**الرسائل القصيرة والمراسلين:** نص أو قالب معتمد |
| `schedule` | الإرسال في وقت محدد، بعد تأخير، أو اتباع المناطق الزمنية للمستخدم |
| `dynamic_content_placeholders` | قيم للعناصر النائبة مثل `{{first_name}}` أو `{{promo_code}}` |
| `campaign` | [رمز الحملة](/ar/developer/api-reference/api-identifiers/#campaign-code) لإسناد الرسالة إليه |
| `frequency_capping` | [تحديد سقف التكرار](/ar/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) يحد من عدد المرات التي يتلقى فيها كل مستخدم رسالة خلال فترة زمنية |

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

يستخدم الوكيل أداة [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/) لإنشاء وإرسال رسالة واحدة. يدعم وضعين للاستهداف:

| الوضع | متى يستخدم |
| --- | --- |
| **الشريحة** | البث لجميع المستخدمين المطابقين لـ [شريحة](/ar/product/audience-data-and-segmentation/segmentation/) أو [تعبير شريحة](/ar/developer/api-reference/segmentation-filters-api/segmentation-language/). يدعم [الجدولة](/ar/product/how-to-guides/how-to-schedule-a-message/)، [تحديد سقف التكرار](/ar/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping)، [معدل الإرسال](/ar/product/messaging-channels/global-frequency-capping/#set-send-rate-limits)، و[مجموعات التحكم](/ar/product/audience-data-and-segmentation/global-control-group/). |
| **معاملاتي** | الإرسال إلى قائمة محددة من [المستخدمين](/ar/developer/pushwoosh-knowledge-hub/users-userids/)، [hwids](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)، أو [رموز الدفع](/ar/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token). مثالي للرسائل المشغلة أو المخصصة. |


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

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

> في التطبيق `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](/ar/developer/api-reference/api-access-token/#server-api-token) منفصل في **الإعدادات → الوصول إلى API** و[قم بتقييده على التطبيقات](/ar/developer/api-reference/api-access-token/#edit-token) التي يجب أن يرسل الوكيل منها. بهذه الطريقة يبقى وصول الوكيل مقتصرًا على تلك التطبيقات فقط.
- **استخدم الاستهداف للمعاملات للرسائل المشغلة.** عند الإرسال إلى معرف مستخدم معروف بعد حدث (شحن طلب، إعادة تعيين كلمة المرور)، استخدم وضع `transactional` مع `users: [userId]`. لا تقم بإنشاء شريحة من شخص واحد لنفس الإرسال. انظر [NotifyTransactional](/ar/developer/api-reference/messaging-api-v2/notify/#notifytransactional).
- **اختبر على أجهزة الاختبار قبل إرسال كبير.** قبل الإرسال إلى شريحة حقيقية، اطلب من الوكيل الإرسال إلى [أجهزة الاختبار المسجلة](/ar/product/first-steps/start-with-your-project/test-your-integration/test-devices/) أولاً. على سبيل المثال: *"في التطبيق `XXXXX-XXXXX`، أرسل إشعار دفع إلى أجهزة الاختبار الخاصة بي بعنوان 'اختبار' ونص 'تحقق من النص هنا'."* هذا يوجه الرسالة فقط إلى الأجهزة التي أضفتها في **الإعدادات → أجهزة الاختبار**. عندما تبدو المعاينة صحيحة، اطلب الشريحة أو الجمهور الحقيقي.
- **حدد اسم حملة في طلبك.** قم بتضمين [رمز حملة](/ar/developer/api-reference/api-identifiers/#campaign-code) في المحادثة (على سبيل المثال، `spring-promo`) حتى تظهر النتائج تحت الحملة الصحيحة في لوحة تحكم Pushwoosh.
- **تأكد قبل البث.** قم بتكوين عميل الذكاء الاصطناعي الخاص بك لطلب تأكيد صريح قبل الموافقة على أي استدعاء أداة يستهدف شريحة. البث لجمهور كبير لا يمكن التراجع عنه.
- **استخدم العناصر النائبة للتخصيص.** مرر قيمًا للعناصر النائبة مثل `{{first_name}}` أو `{{promo_code}}` في طلب محادثتك بدلاً من بناء رسائل منفصلة لكل مستخدم.


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

<LinkCard title="خادم ManyMoney AI MCP: تخطيط وبناء الحملات" href="/product/pushwoosh-ai/manymoney-mcp-server/" />
<LinkCard title="ManyMoney AI داخل لوحة التحكم" href="/product/pushwoosh-ai/ai-assistant/" />
<LinkCard title="نظرة عامة على أدوات الذكاء الاصطناعي" href="/product/pushwoosh-ai/" />