التوثيق

البدء

العربية

في هذه الصفحة

إطلاق علامة بيضاء يعني إنشاء مستأجرك — علامتك ونطاقك ومستخدموك — وتوجيه bro إلى أدواتك. سير العمل ذاتي الخدمة في وحدة تحكم Busymate AI: افتح وحدة التحكم ← التكامل للمستأجر المحدد واتبع قائمة التحقق الحية الخاصة به. هذا القسم هو مصدر الحقيقة لعناوين URL والهوية ومقاطع الشفرة والفحص المسبق والنشر، ويحل محل ملفات التسليم الثابتة لكل مستأجر.

الخطوات الخمس

1. مستأجرك

المستأجر (tenant) هو مساحتك المعزولة على المنصة. يحمل اسمك ومعرّفًا قصيرًا (slug) وهويتك البصرية. كل ما يفعله مستخدموك — المحادثات والسجل والحسابات المتصلة — يبقى داخل مستأجرك ولا يظهر لأي مستأجر آخر أبدًا. يمكن لمالك المنصة إنشاء المستأجر من وحدة التحكم ← المنصة ← المستأجرون أو عبر MCP لإدارة Busymate AI؛ ثم يكمل مسؤول المستأجر قائمة التكامل دون تسليم إلى مشغّل.

2. نطاقك

يُقدَّم مساعدك على نطاق تختاره أنت، مربوط بمستأجرك:

للبداية، يحصل كل مستأجر على نطاق <tenant-slug>.busymate.ai الخاص به.
نطاقك الخاص (مثل assistant.yourdomain.com) بعد توجيهه إلى المنصة والتحقق منه. ومنذ ذلك الحين، لا يرى مستخدموك سوى نطاقك.

خلف الكواليس، يُحلّ كل نطاق إلى مستأجر واحد بالضبط. النطاق الذي لم نربطه بعد يبقى محايدًا بلا علامة — لا تظهر علامتك إلا بعد التحقق من نطاقك وتفعيله، فلا توجد أبدًا نافذة نصف مُعلَّمة أمام مستخدميك.

3. هوية مستخدميك

قرّر كيف يعرف المساعد مستخدميك:

مسجّلون بهويتهم — تربط نظام الدخول الخاص بك، فيصل كل مستخدم إلى bro بصفته هو نفسه، ليستطيع bro التصرف في بياناته (وبياناته فقط).
ضيوف مجهولون — إذا فضّلت أن يدردش أي شخص دون تسجيل دخول، يمكنك تفعيل وضع الضيف. يحصل الضيوف على إجابات وإرشاد، لكن دون إجراءات على البيانات الخاصة بمستخدم بعينه.

يمكنك تقديم الاثنين معًا: الضيوف عند الباب الأمامي، والجلسات المعرَّفة للمستخدمين المسجّلين.

4. أدواتك (اختياري)

إذا أردت أن يفعل bro أشياء — لا أن يجيب فحسب — اربط خادم MCP الخاص بك. هكذا يقرأ bro بيانات مستخدميك ويعدّلها عبر واجهة API الخاصة بك، ووفق قواعدك. هذا اختياري: مساعد المعرفة والإجابات لا يحتاج إلى أدوات إطلاقًا. راجع ربط أدواتك.

5. النشر

عندما تكتمل العلامة والنطاق والهوية و(اختياريًا) الأدوات، شغّل الفحص المسبق ثم النشر من وحدة التحكم. النشر مُدار بالإصدارات: يُحضَّر التغيير ويُتحقّق منه ثم يُفعَّل. أي عقد هوية ناقص أو موصل غير متاح أو سياسة أدوات غير آمنة يمنع النشر بنتيجة قابلة للتنفيذ.

تضمين bro في موقعك

إلى جانب الصفحة المستضافة، يمكنك تضمين bro مباشرة في منتجك — لوحة جانبية أو فقاعة دردشة في صفحاتك. يعمل التضمين على origin موقعك (نضيفه إلى قائمة السماح لمستأجرك)، فيعيش المساعد حيث يوجد مستخدموك أصلًا، وبعلامتك الكاملة دائمًا. وسم script واحد:

html

<script
  src="https://busymate.ai/embed/v1.js"
  data-assistant="your-tenant-slug"
  data-label="Ask us"
  async
></script>

صفحة مستضافة أو تضمين أو كلاهما — القرار قرارك، ويمكنك إضافة التضمين لاحقًا دون إعادة أي شيء.

ما الذي تُحضّره

اسم منتجك وعناصر علامتك (الشعار، الألوان، رسالة ترحيب قصيرة).
النطاق الذي تريده (نطاق فرعي للبداية، أو نطاقك الخاص للتحقق).
كيف يسجّل مستخدموك دخولهم — أو ما إذا كنت تريد وصول الضيوف.
اختياريًا، عنوان خادم MCP الخاص بك إذا أردت أن ينفّذ bro إجراءات.

تجربة المساعد — ما يراه مستخدموك بعد الإطلاق.
الحوكمة وسياسة النماذج — فعّل الميزات وحدّد سياسة النماذج.
ربط أدواتك — دَع bro يتصرف في بيانات مستخدميك.