تنبيه: لا تتوفر وثائق قديمة لهذا العنصر، لذا فإنك ترى الوثائق الحالية.
تسجل PushEngage مجموعة من قدرات ووردبريس حتى يتمكن مساعدو الذكاء الاصطناعي وعملاء MCP من تشغيل إشعارات الدفع الخاصة بك مباشرة من موقع ووردبريس الخاص بك. كل قدرة هي إجراء واحد موصوف جيدًا، مثل إرسال إشعار، أو سرد الشرائح، أو سحب تقرير تحليلات، يمكن للمساعد اكتشافه واستدعاؤه بإذن منك. يشرح هذا الدليل ما هي القدرات، وما هو مطلوب لاستخدامها، وكل ما يمكن للوكيل القيام به.
قبل البدء
- تحتاج إلى إصدار المكون الإضافي PushEngage 4.2.3 أو أحدث. يسجل هذا الإصدار قدرات PushEngage مقابل واجهة برمجة تطبيقات قدرات ووردبريس.
- يحتاج موقعك إلى ووردبريس 7.0 أو أحدث. واجهة برمجة تطبيقات القدرات هي جزء من نواة ووردبريس بدءًا من الإصدار 7.0.
- يجب أن تكون مسؤولاً. تتطلب كل قدرة من قدرات PushEngage صلاحية
manage_options، ويصادق المساعد كمسؤول ووردبريس من خلال كلمة مرور تطبيق. - لتعريض القدرات لعميل ذكاء اصطناعي خارجي عبر MCP، أضف المكون الإضافي المجاني WP MCP Adapter. يمكنك رؤية حالته وبقية مجموعة أدوات الذكاء الاصطناعي الخاصة بك على صفحة أدوات PushEngage على PushEngage » Tools.
- بعض القدرات متاحة فقط عندما يكون WooCommerce نشطًا.
كيف تعمل قدرات PushEngage
عندما يتم تحميل موقعك، يسجل المكون الإضافي PushEngage فئة قدرة pushengage وقدراته عبر واجهة برمجة تطبيقات قدرات ووردبريس. تعلن كل قدرة عن صلاحية واحدة يمكن لمساعد الذكاء الاصطناعي اكتشافها واستدعاؤها، بتنسيق قابل للقراءة آليًا ومتوافق مع MCP.
يتم وراثة الوصول من ووردبريس، وليس نظامًا منفصلاً بنته PushEngage:
- الإذن. تتطلب كل قدرة صلاحية
manage_options، معلنة عبرpermission_callbackلواجهة برمجة تطبيقات القدرات. يتم مصادقة المساعد مقابل مستخدم ووردبريس باستخدام كلمة مرور تطبيق، وهي آلية ووردبريس القياسية منذ الإصدار 5.6. يمكن للمساعد المتصل كمسؤول تشغيل القدرات. لا يمكن للمساعد المتصل كمساهم. - التأكيد. تم تمييز قدرة واحدة فقط على أنها مدمرة، وهي إرسال إشعار، لذلك يؤكد المساعد المدرك لـ MCP معك قبل إطلاق الإرسال. تحديثات الإعدادات وإنشاء الشرائح غير مدمرة.
- أقل الامتيازات. يعرض سجل التصحيح محتوى بدرجة المسؤول مثل عناوين URL وحمولات الطلبات، ويتم تقييده بنفس إذن المسؤول مثل كل شيء آخر. يمتلك المساعد نفس الوصول الذي يمتلكه المسؤول البشري الذي يقوم بتشغيله، ولا أكثر.
للوصول إلى القدرات من مساعد خارجي، قم بتثبيت محول WP MCP المجاني، والذي يربط القدرات المسجلة ببروتوكول MCP الذي يتحدث به مساعدك. حتى يتم توصيل محول أو عميل MCP، يتم تسجيل القدرات ولكن لا يمكن لأي وكيل الوصول إليها بعد.
ما يمكن للوكيل فعله
يسجل PushEngage 22 قدرة، مجمعة أدناه حسب العمل الذي تقوم به. قد يختلف العدد الدقيق المعروض في صفحة الأدوات الخاصة بك بناءً على ما هو نشط على موقعك، حيث تسجل بعض القدرات فقط عند وجود WooCommerce. يوضح "النوع" ما إذا كانت القدرة تقرأ البيانات فقط أم تكتب التغييرات أيضًا.
إرسال إشعارات الدفع
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| إرسال إشعار | يرسل إشعار دفع للمشتركين. | كتابة |
| الحصول على إشعار | يعيد تفاصيل إشعار واحد. | قراءة فقط |
| قائمة الإشعارات | يسرد الإشعارات، مع فلتر حالة اختياري وترقيم الصفحات. | قراءة فقط |
| الحصول على حالة الاتصال | يعيد ما إذا كان الموقع متصلاً بحساب PushEngage. | قراءة فقط |
بناء واستهداف الشرائح
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| قائمة الشرائح | يسرد شرائح المشتركين. | قراءة فقط |
| قائمة مجموعات الجمهور | يسرد مجموعات الجمهور المتاحة للاستهداف. | قراءة فقط |
| إنشاء شريحة | ينشئ شريحة مشتركين جديدة. | كتابة |
| إضافة مشتركين إلى شريحة | يضيف مشتركين إلى شريحة موجودة. | كتابة |
قراءة تحليلاتك
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| الحصول على ملخص الإشعارات | يعيد إجمالي عدد عمليات الإرسال والمشاهدات والنقرات عبر جميع الإشعارات. | قراءة فقط |
| الحصول على نظرة عامة على التحليلات | يعيد المشتركين والانطباعات والنقرات عبر نطاق تاريخي، مجمعة حسب اليوم أو الأسبوع أو الشهر. | قراءة فقط |
| الحصول على تحليلات المشتركين | يُرجع المشتركين النشطين أسبوعيًا وإجمالي المشتركين النشطين. | قراءة فقط |
تكوين الدفع التلقائي
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| الحصول على إعدادات الدفع التلقائي | يُرجع تكوين الدفع التلقائي، بما في ذلك أنواع المنشورات الممكّنة وأعلام الميزات. | قراءة فقط |
| تحديث إعدادات الدفع التلقائي | يقوم بتحديث الدفع التلقائي، بما في ذلك التبديل وأنواع المنشورات والأيقونة وأعلام الميزات. | كتابة |
| قائمة الفئات | يسرد فئات منشورات WordPress، بالإضافة إلى فئات منتجات WooCommerce عندما يكون WooCommerce نشطًا. | قراءة فقط |
| قائمة تعيينات شرائح الفئات | يسرد تعيين فئات WordPress إلى شرائح PushEngage. | قراءة فقط |
| الحصول على تعيينات السمات | يُرجع تعيين سمات المشتركين في PushEngage إلى مفاتيح بيانات المستخدم في WordPress. | قراءة فقط |
تشغيل أتمتة WooCommerce و WhatsApp
هذه القدرات متاحة فقط عندما يكون WooCommerce نشطًا. يتطلب الحصول على حالة WhatsApp أيضًا بيانات اعتماد WhatsApp صالحة.
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| قائمة حملات أتمتة الدفع | يسرد حملات أتمتة دفع WooCommerce مع تكوينات المسؤول والعميل. | قراءة فقط |
| تحديث حملة أتمتة الدفع | يقوم بتمكين أو تعطيل أو تكوين حملة أتمتة دفع WooCommerce. | كتابة |
| قائمة حملات أتمتة WhatsApp | يسرد حملات أتمتة WhatsApp التي تم تكوينها لأحداث WooCommerce. | قراءة فقط |
| الحصول على حالة WhatsApp | يُرجع ما إذا كانت بيانات اعتماد تكامل WhatsApp صالحة. | قراءة فقط |
تشخيص والتحقق
| قدرة | ماذا يفعل | النوع |
|---|---|---|
| الحصول على معلومات المكون الإضافي | يُرجع إصدار المكون الإضافي وحالة الاتصال والتكوين الرئيسي. | قراءة فقط |
| الحصول على بيئة الموقع | يُرجع تفاصيل WordPress و PHP والخادم للتشخيص. | قراءة فقط |
| الحصول على سجل التصحيح | يسرد ملفات سجل التصحيح، ويقرأ ملفًا معينًا عند إعطاء اسم ملف. للمسؤول فقط، حيث قد تحتوي محتويات السجل على عناوين URL وحمولات الطلبات. | قراءة فقط |
ما يمكنك أن تسأله لمساعدك
بمجرد اتصال عميل MCP، تصف العمل بلغة واضحة ويقوم المساعد باستدعاء القدرات الصحيحة. على سبيل المثال:
- "ابحث عن شريحة المتسوقين المهتمين لدي، ثم أرسل للجميع فيها إشعارًا بعنوان 'ينتهي البيع السريع منتصف الليل' مع رابط لصفحة البيع الخاصة بي." يقوم المساعد بإدراج الشرائح للعثور على المعرف، ثم يرسل الإشعار، مؤكدًا قبل إرساله.
- "أظهر لي تقرير تحليلات أسبوعي للأيام الـ 30 الماضية، وأي الحملات أدت إلى أكبر عدد من النقرات." يقوم المساعد بسحب نظرة عامة على التحليلات ورسم خرائط عمليات الإرسال للعناوين.
- "عطّل حملة التخلي عن عربة التسوق في WooCommerce الخاصة بي حتى يوم الثلاثاء." يقوم المساعد بإدراج حملات الأتمتة وتحديث الحملة الصحيحة.
- "أنشئ شريحة تسمى زوار صفحة الأسعار التي تلتقط أي شخص زار /pricing في الأيام السبعة الماضية." يقوم المساعد بإنشاء الشريحة من وصفك.
أسئلة متكررة
من يمكنه استخدام هذه القدرات؟
المسؤولون فقط. تتطلب كل قدرة من قدرات PushEngage صلاحية manage_options، ويقوم المساعد بالمصادقة كمستخدم ووردبريس من خلال كلمة مرور التطبيق. يمكن للمساعد المتصل كمسؤول تشغيل القدرات، بينما لا يمكن للمساعد المتصل كمساهم.
هل أحتاج إلى محول MCP؟
تحتاجه للوصول إلى القدرات من عميل ذكاء اصطناعي خارجي عبر MCP. تسجل القدرات نفسها في واجهة برمجة تطبيقات قدرات ووردبريس، ولكن محول WP MCP المجاني هو ما يربطها ببروتوكول MCP الذي يتحدث به مساعدك. يمكنك التحقق من حالته على صفحة أدوات PushEngage.
لماذا تعرض صفحة الأدوات الخاصة بي عددًا مختلفًا من القدرات؟
تسجل PushEngage 22 قدرة في المجموع، ولكن أتمتة دفع WooCommerce وقدرات WhatsApp تسجل فقط عندما يكون WooCommerce نشطًا، لذا فإن العدد المعروض على موقعك يعتمد على ما هو نشط.
هل سيغير الوكيل حسابي دون أن يسأل؟
القدرات للقراءة فقط تعيد البيانات فقط. فقط إرسال الإشعارات هو الذي تم تحديده على أنه مدمر، لذا يؤكد المساعد المدرك لـ MCP معك قبل إطلاق عملية إرسال. تحديثات الإعدادات وإنشاء الشرائح غير مدمرة وتعمل بدون مطالبة.
ما هي إصدارات الإضافات وووردبريس التي أحتاجها؟
PushEngage 4.2.3 أو أحدث للقدرات، وووردبريس 7.0 أو أحدث لواجهة برمجة تطبيقات القدرات. يوصى بتحديث الإضافة، حيث تقوم الإصدارات اللاحقة بتحسين القدرات واستجابات الذكاء الاصطناعي و MCP الخاصة بها.
إذا واجهت أي مشاكل، فلا تتردد في الاتصال بنا بالنقر هنا. سيكون فريق الدعم لدينا قادرًا على مساعدتك.
