ابدأ من هنا
فهملي يفصل بين فهم نية العميل، حقائق النشاط الموثقة، صلاحية تنفيذ الإجراء، وطريقة عرض الرد. صياغة الذكاء الاصطناعي ليست مصدرًا مستقلًا للأسعار أو الصلاحيات.
أضف معرفة النشاط
نصوص وملفات وروابط وبيانات منظمة حسب ما توفره لوحة التحكم.
فعّل ما تحتاجه
القنوات والحجوزات والطلبات والتحويل للموظف تعمل وفق الباقة وإعدادات النشاط.
اختبر قبل النشر
استخدم Playground ثم اختبر نفس السيناريو في الويدجت أو القناة المستهدفة.
تركيب الويدجت
استخدم Business ID الخاص بالنشاط. لا تضع API Key أو أي secret في كود الموقع العام.
الوضع العائم
<script src="https://www.faheemly.com/api/widget/loader.js?v=v1" data-business-id="YOUR_BUSINESS_ID" async defer></script>الوضع المضمّن داخل الصفحة
<div id="faheemly-inline-chat"></div>
<script src="https://www.faheemly.com/api/widget/loader.js?v=v1" data-business-id="YOUR_BUSINESS_ID" data-mode="inline" data-container="#faheemly-inline-chat" async defer></script>قاعدة المعرفة
الإجابات التجارية يجب أن تستند إلى معرفة النشاط أو بياناته المنظمة. إعادة المعالجة تعيد بناء الفهرسة المطلوبة للمصادر وليست زر إصلاح عشوائي لكل مشكلة محادثة.
متى تعدّل المعرفة؟
عند تغير خدمة أو سياسة أو سعر أو معلومة تشغيلية تخص النشاط. لا تستخدم التعليمات العامة لتعويض نقص البيانات المنظمة.
متى تعيد المعالجة؟
بعد تغيير المصدر عندما تحتاج النسخة المفهرسة أن تُبنى من جديد، أو عند ظهور حالة معالجة تستلزم إعادة تشغيل مؤكدة.
النص والكروت والوسائط والإجراءات
طريقة العرض تأتي بعد التحقق من المعنى والبيانات. العرض الغني لا يمنح البوت صلاحية أو معلومة إضافية.
نص مباشر
للإجابات المحددة والتوضيح القصير.
كروت
لعرض مجموعة خدمات أو منتجات أو عروض موثقة عندما تكون البنية مناسبة.
جدول/نص كثيف
للمقارنات بدل تحويل كل مقارنة إلى مجموعة كروت.
وسائط وإجراءات
للصور والمواقع والروابط والأزرار عندما يوفّر المسار بيانات أصلية آمنة.
القنوات
القنوات المتاحة تعتمد على الباقة وإعداد النشاط وحالة ربط المزود. المصدر التجاري الحالي للقنوات والحدود هو صفحة التسعير والـruntime، وليس قائمة ثابتة داخل هذه الوثائق.
ظهور اسم قناة هنا لا يعني أنها مفعلة لكل نشاط. راجع صفحة القنوات في Dashboard لمعرفة حالة الربط الفعلية للنشاط.
Leads وCRM والتحويل للموظف
جمع بيانات العميل والتحويل البشري منفصلان عن الإجابة على سؤال النشاط. وجود حقل مطلوب لا يعني أن المحادثة يجب أن تتوقف حتى يرسله الزائر.
- • بيانات التواصل لا تُعامل كاسم أو هاتف إلا بعد اجتياز التحقق المناسب.
- • طلب التحويل لموظف يُنفذ فقط عندما تكون الخاصية متاحة ومفعلة.
- • الموظف وCRM يتعاملان مع النتائج المسجلة بدل إعادة استنتاجها من نص المحادثة.
الحجوزات والطلبات
فهملي يفرق بين سؤال معلوماتي عن الحجز أو الطلب وبين نية تنفيذ عملية. التنفيذ يخضع للـentitlements وإعداد النشاط والبيانات المطلوبة.
Bookings
إنشاء ومتابعة الحجز عندما تكون الخاصية مفعلة. تكاملات API الخارجية لها scopes مستقلة موثقة في مرجع المطورين.
Orders
الطلبات تعتمد على بيانات عناصر وأسعار مرسلة أو موثقة، ولا يجب أن يحسب المساعد قيمة تجارية من معلومة غير متاحة له.
التكاملات وDeveloper API
Widget API الداخلي وDeveloper API منتجان تقنيان مختلفان. التطبيقات الخارجية تستخدم /api/v1 مع API Key وصلاحيات scopes محددة.
Authorization: Bearer sk_live_...أو x-api-key. المفتاح مرتبط بالنشاط وصلاحياته ولا يُستخدم في JavaScript عام داخل موقع العميل.
مرجع واحد للـAPI
endpoints وscopes والـpagination والحدود والأخطاء تُوثق في صفحة Developer API فقط لمنع تكرار contract داخل أكثر من صفحة.
افتح مرجع Developer API ←الأمان والخصوصية
كل نشاط يجب أن يظل tenant-scoped. الصلاحية التجارية لا تأتي من نص الرسالة، والـAPI Key لا يوسع صلاحيات الباقة نفسها.
• لا تشارك API keys في الويدجت أو المستودعات العامة أو لقطات الشاشة.
• أنشئ أقل scopes لازمة للتكامل ودوّر المفتاح إذا تعرض.
• راجع سياسة الخصوصية والشروط للعقد القانوني المنشور.
استكشاف الأخطاء
ابدأ من Business ID والبيئة وحالة القناة والمعرفة، ثم انتقل إلى الشبكة والـAPI. لا تستخدم secret في المتصفح لتجاوز خطأ إعداد.