توثيق مسودات ردود الدعم بالذكاء الاصطناعي لووكومرس
دليل مسودات ردود الدعم بالذكاء الاصطناعي لووكومرس: وصل حساب الذكاء الاصطناعي، ونصوص متجرك، وكتابة مسودة رد، والخانات والفحص اللاحق، والإرسال إلى العميل، وأرقام التتبع، والقوالب والسجل، والخصوصية والحدود.
يشرح الإصدار 1.0.0حُدّث في 29 أكتوبر 2026
ابدأ من هنا
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| مسودة في شاشة الطلب | مع HPOS ومع التخزين القديم للطلبات. الموضوع واللغة (لغة العميل أو الإنجليزية أو العربية أو لغة لوحتك) والأسلوب وقالب اختياري كصياغة مفضلة. |
| الحقائق فقط | رقم الطلب والحالة والتواريخ وأسماء المنتجات وكمياتها وطريقة الشحن ورقم التتبع ورابطه، وهل سُجّل استرداد، ونصوص متجرك. لا يُعطى الذكاء الاصطناعي شيئًا غيرها. |
| خانات [CHECK: ...] | الحقيقة التي يحتاجها الرد وليست في الطلب (لا رقم تتبع، لا نص سياسة) تصبح خانة. ويرفض زر الإرسال نصًا ما زالت فيه خانة. |
| الفحص اللاحق | تُعرض بجانب المسودة المبالغ والنسب والتواريخ وأيام الأسبوع ومدد التوصيل وأرقام الطلبات الأخرى والوعود (استرداد، خصم، قسيمة، تعويض، استبدال، مجانًا...) غير الموجودة في الحقائق. وتُحذف الروابط التي يكتبها الذكاء الاصطناعي. |
| أرقام التتبع | مفاتيح مُتحقَّق منها: WooCommerce Shipment Tracking (من توثيقها الرسمي) وAdvanced Shipment Tracking من zorem وOrders Tracking for WooCommerce من VillaTheme (من شيفرتها على wordpress.org). وتُقرأ مفاتيح AfterShip وYITH أيضًا لكنها غير مُتحقَّق منها؛ ويمكن تزويد أي إضافة عبر المرشّح tqsd_tracking_items. |
| الخصوصية | لا يُرسل أبدًا العنوان والهاتف والبريد وبيانات الدفع. ويبقى الاسم الأول ورقم التتبع ورابطه على موقعك: يكتب الذكاء الاصطناعي خانات وتملؤها الإضافة. وتُخفى عناوين البريد والهواتف وأرقام IBAN والبطاقات في الرسالة الملصقة. |
| إرسال صريح | للأدوار التي تسمح بها فقط، وبنقرة فقط، مع تأكيد يعرض النص بالضبط وبريد العميل. وملاحظة العميل في ووكومرس هي التي ترسل البريد. والتأكيد يعمل مرة واحدة. |
| السجل | لكل طلب وللمتجر: من كتب ومتى والموضوع والتحققات، وهل نُسخت المسودة أو أُضيفت كملاحظة خاصة أو أُرسلت أو تُجوهلت. تُحفظ 90 يومًا افتراضيًا. |
| القوالب | مقاطع للمتجر كله مع خانات، تُقترح لكل موضوع وتُدرج في أي مسودة. |
| الحدود | مسودات لكل شخص في الساعة وطلبات للمتجر في اليوم، تُعد بشكل ذري (لا تتجاوزها الطلبات المتوازية). |
المتطلبات
| البند | التفاصيل |
|---|---|
| ووردبريس | 6.0 أو أحدث |
| PHP | 7.4 أو أحدث |
| ووكومرس | 8.0 أو أحدث (متوافق مع HPOS ومع الدفع بالكتل) |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI (OpenAI أو OpenRouter أو Azure أو خادم محلي مثل Ollama...) أو لدى أنثروبيك. تدفع لمزوّدك مقابل ما تستخدمه؛ ولا رسوم استخدام في الإضافة. |
| الرخصة | GPL-2.0-or-later |
التثبيت
- فُكّ ضغط الحزمة التي نزّلتها. بداخلها
ai-support-reply-drafts-for-woocommerce.zip(لا تفكّ هذا الملف). - في ووردبريس افتح الإضافات ← أضف جديدًا ← رفع إضافة واختر
ai-support-reply-drafts-for-woocommerce.zipواضغط التثبيت الآن. - اضغط تفعيل الإضافة. يجب أن يكون ووكومرس مفعّلًا.
- افتح الإعدادات ← ردود الدعم بالذكاء الاصطناعي ← الاتصال بالذكاء الاصطناعي واختر المزوّد والصق مفتاح الواجهة واضغط اختبر الاتصال.
صِل الذكاء الاصطناعي
| الحقل | المعنى |
|---|---|
| المزوّد | متوافق مع OpenAI (OpenAI وOpenRouter وAzure وGroq وOllama وLM Studio...) أو أنثروبيك. |
| عنوان الواجهة | اتركه فارغًا للعنوان الرسمي. ولخدمة أخرى اكتب عنوانها، مثلًا http://localhost:11434/v1. |
| مفتاح الواجهة | يُحفظ في قاعدة بياناتك (ولا يظهر ثانية). ويمكنك تعريفه في wp-config.php فيختفي الحقل. |
| النموذج | اسم النموذج لدى مزوّدك. يكفي نموذج صغير رخيص لأغلب المهام. |
| أقصى طول للإجابة | يحدّ رموز الإجابة الواحدة فلا يكلّف الطلب أكثر مما تتوقع. |
| الحد اليومي | عدد الطلبات التي تجريها الإضافة في اليوم (0 = بلا حد). وعند بلوغه تتوقف الإضافة عن الطلب حتى الغد. |
| الخصوصية | يخفي عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع قبل إرسال النص. |
نصوص متجرك
| الخيار | المعنى |
|---|---|
| من يكتب مسودات الردود | الأدوار التي ترى الصندوق (وتحتاج أيضًا صلاحية تعديل الطلبات في ووكومرس). المديرون ومديرو المتجر افتراضيًا. |
| الإرسال إلى العميل | يُظهر زر الإرسال. عطّله فلا يستطيع الفريق إلا النسخ أو الملاحظات الخاصة. |
| من يرسل إلى العميل | الأدوار التي يحق لها الإرسال؛ منفصلة عن الكتابة. |
| التوقيع | تضيفه الإضافة تحت كل مسودة؛ ولا يُرسل إلى الذكاء الاصطناعي. |
| الأسلوب واللغة الافتراضيان | ودود أو رسمي أو قصير أو هادئ؛ ولغة العميل افتراضيًا. |
| الاسم الأول | معطّل افتراضيًا: يُملأ الاسم الأول على موقعك. |
| أطول رسالة عميل | تُقصّ الرسائل الأطول قبل الإرسال (3000 حرف). |
| المسودات لكل شخص في الساعة | 20 افتراضيًا. |
| مدة حفظ سجل المسودات | 90 يومًا افتراضيًا. |
| رسالة العميل | معطّل افتراضيًا: لا تُحفظ الرسالة المخفية البيانات في السجل. |
كتابة مسودة رد
- افتح الطلب. في صندوق مسودة رد بالذكاء الاصطناعي الصق رسالة العميل، أو اضغط استخدم الملاحظة التي كتبها العميل عند الدفع.
- اختر الموضوع. يُختار قالب هذا الموضوع كصياغة مفضلة؛ ويمكنك تغييره.
- اضغط اكتب مسودة رد. تظهر المسودة في حقل قابل للتعديل وتحتها قائمة التحققات.
- املأ كل خانة [CHECK: ...] وانظر في التنبيهات وعدّل النص.
- انسخه إلى بريدك أو المحادثة، أو أضفه كملاحظة خاصة، أو أرسله كملاحظة طلب إلى العميل.
| التنبيه | المعنى |
|---|---|
| مبلغ غير موجود في الحقائق | مبلغ أو نسبة لا يحتويها الطلب ولا نصوصك. |
| تاريخ غير موجود في الحقائق | تاريخ أو يوم من الأسبوع أو «غدًا» ليس من تواريخ الطلب. |
| مدة غير موجودة في نصوص متجرك | مدة توصيل أو إرجاع لا تذكرها نصوصك. |
| وعد محتمل | استرداد أو خصم أو قسيمة أو تعويض أو استبدال أو مجانًا حين لا تذكره نصوصك؛ والاسترداد الموعود أو الموافق عليه دائمًا. |
| رابط كتبه الذكاء الاصطناعي | يُحذف وتوضع خانة مكانه. والرابط الوحيد الممكن في المسودة هو رابط تتبع الطلب. |
| رقم طلب آخر | رقم مع # ليس هذا الطلب. |
| للملء | خانة [CHECK: ...]. |
الإرسال إلى العميل
أرقام التتبع من الإضافات الأخرى
| الإضافة | من أين تقرؤها الإضافة |
|---|---|
| WooCommerce Shipment Tracking | بيانات الطلب _wc_shipment_tracking_items (المزوّد ورابط مخصص فيه %1$s للرقم). |
| Advanced Shipment Tracking (zorem) | بيانات الطلب نفسها _wc_shipment_tracking_items؛ وتبني الإضافة الرابط حين تكون مفعّلة. |
| AfterShip Tracking (غير مُتحقَّق منه) | بيانات الطلب _aftership_tracking_items (الرقم وشركة الشحن؛ ولا يُحفظ رابط). لم يُتحقَّق منه في شيفرة AfterShip. |
| Orders Tracking for WooCommerce (VillaTheme) | بيانات منتج الطلب _vi_wot_order_item_tracking_data، آخر إدخال. |
| YITH WooCommerce Order & Shipment Tracking (غير مُتحقَّق منه) | بيانات الطلب ywot_tracking_code وywot_carrier_name وywot_carrier_url. لم يُتحقَّق منه في شيفرة YITH. |
tqsd_tracking_items. وقد تخزّن النسخ المدفوعة والإصدارات القادمة البيانات بطريقة أخرى.القوالب والسجل
الخصوصية والأمان
| الخطر | ما تفعله الإضافة |
|---|---|
| رسالة العميل تعطي أوامر للذكاء الاصطناعي | تُرسل كبيانات بين علامات عشوائية؛ وتقول التعليمات إنها غير موثوقة وإن الحقائق وحدها تُعتمد. ويرى الفريق تحذيرًا. |
| الذكاء الاصطناعي يعد بشيء | تمنع التعليمات الوعود؛ وينبّه الفحص اللاحق إلى المبالغ والتواريخ والمدد وكلمات الوعود غير الموجودة في الحقائق؛ ويقرأ شخص المسودة. |
| الذكاء الاصطناعي يكتب رابطًا | تُحذف الروابط وعناوين المواقع ذات النهايات الشائعة وعناوين البريد ويُنبَّه إليها؛ ولا يوضع إلا رابط تتبع الطلب، وتضعه الإضافة. |
| الذكاء الاصطناعي يجيب بشيء آخر | يجب أن تكون الإجابة JSON فيها رد؛ وتُتجاهل الحقول الإضافية. والمسودة نص عادي يُعرض بأمان. |
| إرسال غير مرغوب | لا إرسال تلقائي ولا جماعي أبدًا؛ وصلاحية منفصلة للإرسال؛ وتأكيد بخطوتين يعمل مرة واحدة؛ وملاحظة العميل في ووكومرس. |
| التكلفة | حدود لكل شخص في الساعة وللمتجر في اليوم، تُعد تحت قفل في قاعدة البيانات. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| الدقة | قد يسيء الذكاء الاصطناعي فهم رسالة أو يكتب شيئًا خاطئًا. التنبيهات تساعد لكنها أنماط لا فهم: اقرأ كل مسودة. |
| الحقائق | تعرف الإضافة ما في الطلب. ولا تسأل شركة الشحن عن مكان الطرد ولا تقرأ بريدك. |
| ليست نظام تذاكر | لا صندوق وارد ولا ردود تلقائية ولا ردود جماعية. تكتب ردًا واحدًا لطلب واحد حين يطلب شخص. |
| اللغات | أي لغة يكتبها النموذج؛ والإنجليزية والعربية مختبرتان. |
| ليست استشارة قانونية | لا تفحص قوانين حماية المستهلك؛ ونصوصك هي التي تحدد ما يُوعد به. |
للمطورين
// Make a draft from PHP (the same checks as the button: limits, masking, post-check); nothing is sent
$r = TQSD_Drafter::draft( $order_id, array( 'message' => $text, 'intent' => 'where', 'lang' => 'auto' ) );
// $r['draft'], $r['flags'] (amount, date, duration, promise, link, order, placeholder), $r['placeholders']
// The facts of an order, exactly as they are given to the AI
$facts = TQSD_Facts::build( $order_id ); // rows, prompt, tokens (kept on the site), sources, missing
// Tracking numbers of another shipment plugin
add_filter( 'tqsd_tracking_items', function ( $items, $order ) {
$n = $order->get_meta( '_my_tracking_number' );
if ( $n ) {
$items[] = array( 'number' => $n, 'carrier' => 'My Courier', 'link' => 'https://track.example/' . rawurlencode( $n ) );
}
return $items;
}, 10, 2 );
// Who may draft and who may send (on top of the roles in the settings)
add_filter( 'tqsd_can_send', function ( $ok, $user, $order_id ) { return $ok && user_can( $user, 'manage_woocommerce' ); }, 10, 3 );
// Add a shop rule to the instructions (the customer message stays data)
add_filter( 'tqsd_system_prompt', function ( $p ) { return $p . "\nNever mention our second warehouse."; } );
// The key can live in wp-config.php
define( 'TQSD_AI_KEY', 'sk-...' );استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لا صندوق في شاشة الطلب | دورك ليس في «من يكتب مسودات الردود» أو لا تستطيع تعديل الطلبات. وتحقق من خيارات الشاشة أعلى شاشة الطلب. |
| لا زر إرسال | دورك ليس في «من يرسل إلى العميل» أو الإرسال معطّل. |
| «املأ أو احذف كل خانة [CHECK: …]» | عدّل المسودة؛ فخطوة الإرسال ترفض الخانات. |
| بُلغ الحد اليومي | ارفعه في تبويب الاتصال بالذكاء الاصطناعي أو انتظر الغد. |
| لا رقم تتبع | إضافة الشحن لديك تخزّنه في مكان آخر؛ استخدم المرشّح tqsd_tracking_items. |
| أخطاء الذكاء الاصطناعي | اختبر الاتصال؛ وتحقق من المفتاح والنموذج. |
التحديث والإزالة
ثبّت ملف الإصدار الجديد فوق القديم من الإضافات ← أضف جديدًا ← رفع إضافة (يعرض ووردبريس استبدال النسخة الحالية)، أو استبدل المجلد ai-support-reply-drafts-for-woocommerce عبر FTP. تبقى إعداداتك وقوالبك وسجلك. وحذف الإضافة يزيل إعداداتها وقوالبها وجدول السجل والعدادات. والملاحظات المضافة إلى الطلبات تبقى على الطلبات. ولإزالة الإضافة عطّلها ثم احذفها: تُحذف إعداداتها معها.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الإضافة أو راسل support@taqnix.com مع إصدار ووردبريس وإصدار الإضافة ولقطة شاشة.