Amargi Widget Builder.

افتح widget.amargicreative.com وانقر "New publication". اختر المصدر: وكيل Agents، أو قناة Reach Webchat، أو نموذج Escalate أو KB.

اختر ثيمة الواجهة (Classic فقاعة كلام، Modern لوحة مستديرة، Minimal شريط رفيع). المعاينة المباشرة داخل المحرّر.

انسخ مقتطف script من علامة تبويب "Snippet" والصقه قبل وسم إغلاق body على موقعك. تظهر الفقاعة في أقل من خمس دقائق.

Publication

وحدة الإعداد الأساسية. تربط مصدراً واحداً وثيمة واحدة ومفتاحاً عاماً واحداً وقائمة نطاقات مسموحة وحالة تفعيل أو إيقاف. غيّر الثيمة أو قائمة النطاقات أو حالة النشاط دون لمس الكود في موقعك. لكل publication صفحة محرّر بعلامات تبويب: General، Snippet، Origins، Analytics.

Source

Agents يفعّل وضع AI (يتحدّث الويدجت إلى وكيل Agents مع كل قواعد سلامة AI المعتادة: RAG، استدعاءات الأدوات، التسليم البشري). Reach يفعّل الدردشة الحية (قناة Reach Webchat، فيدردش الزائر مع إنسان في صندوق Reach الوارد). Escalate يفعّل وضعَي النموذج وبحث KB (النموذج يُنشئ تذكرة عند الإرسال؛ بحث KB يعرض المقالات قبل أن يكتب الزائر).

UI Theme

Classic (v1) فقاعة كلام ودودة بحدود مستديرة معتدلة. Modern (v2) لوحة مستديرة بحدود ناعمة جداً، تُبرز هويتك، وهي الافتراضية للنشرات الجديدة. Minimal (v3) شريط رفيع بنص "Chat with us" بجانب الأيقونة، فاخر ولا يبدو أنه من Amargi.

Allowed origins

قائمة بأصول HTTPS مسموح لها بتحميل الـ publication. القائمة الفارغة تعني أي أصل (الافتراضي). أي إدخال غير فارغ يفرض قائمة سماح صارمة، ويدعم أصولاً كاملة (https://example.com)، أو أنماط بدائل (*.example.com)، أو أسماء مضيف فقط (example.com). الأصول خارج القائمة تحصل على 204 صامتة بدلاً من بيانات الإعداد.

Funnel analytics

كل publication يلتقط ثلاثة عدّادات تراكمية: loads_total، وopens_total، وmessages_total. الأول يزيد عند كل جلب لإعدادات الويدجت (تحميل صفحة فيها وسم script). الثاني عند نقر الفقاعة. الثالث عند إرسال أول رسالة. معدّلات التحويل بين كل مرحلة تظهر في علامة تبويب Analytics في المحرّر.

تغيير الثيمة بعد النشر

1. افتح المحرّر، علامة تبويب General.
2. بدّل قيمة "UI theme"، يحفظ المحرّر تلقائياً.
3. علامة تبويب Snippet ستُظهر مسار SDK الجديد (v1 / v2 / v3). انسخه إلى موقعك مرة واحدة.

تقييد publication بنطاقات معيّنة

1. علامة تبويب Origins، أضف كل نطاق على سطر منفصل.
2. استخدم *.example.com لتطابق كل النطاقات الفرعية.
3. التغييرات تسري فوراً، لا حاجة لإعادة نشر.

إيقاف publication مؤقتاً

1. علامة تبويب General، غيّر الحالة إلى "Paused".
2. الـ publication المتوقّف يعيد 404 على الـ resolver. الويدجت يفشل بصمت على موقعك (لا فقاعة)، لا يرى الزائر أي خطأ.
3. استأنف بـ "Active" متى شئت.

حذف publication

1. الحذف غير نهائي، يحدّد العمود deleted_at في القاعدة، فيتوقّف الـ resolver عن خدمة الإعداد، لكن الصف يبقى للتدقيق.
2. لاستعادة publication محذوف، اتصل بالدعم.

Agents

وضع AI يستدعي وكيل Agents مع كل قواعد سلامة AI المعتادة. إذا أصدر الوكيل إجراء human_handoff، ينتقل الويدجت إلى وضع Live (إذا كان ممكّناً) ويُسلّم نص المحادثة.

Reach

وضع Live يتصل بقناة Reach Webchat. المحادثة تصل إلى صندوق Reach الوارد كأي محادثة أخرى: التعيينات، الملاحظات الداخلية، الردود.

Escalate

وضع النموذج ينشئ تذكرة Escalate عند الإرسال. وضع بحث KB يعرض المقالات المنشورة. إجراء create_ticket من وكيل Agents يحوّل الويدجت إلى وضع Form (إذا كان ممكّناً) مع نص المحادثة معبّأً في أول textarea.