التكاملات

لوحة التحكم ← التكاملات — اربط مصادر المحتوى وقنوات الوصول إلى المعرفة.

#مصادر المحتوى

#المتصلة (نشطة دائمًا)

#الموصّلات المتاحة

عدد المصادر المرتبطة محدود بالخطة. وعندما يُستنفد الحد، يصبح زر «ربط» لدى المصادر غير نشط — افصلوا أحدها أو انتقلوا إلى خطة أعلى. ولا تدخل بوتات Slack وTelegram ضمن هذا الحد.

#ربط GitHub

#الخطوة 1 — التفويض

1. في LiKE انتقل إلى التكاملات ← GitHub ← «ربط»
2. اختر طريقة تفويض:

#الخطوة 2 — اختيار المحتوى

1. بعد الربط، تُعرض شجرة المستودع بالمجلدات والملفات
2. حدّد الملفات أو المجلدات المعيّنة للاستيراد (Selective Sync)
3. الصيغ المدعومة: .md, .mdx, صفحات Wiki

#الخطوة 3 — تشغيل المزامنة

1. انقر «مزامنة»
2. يُعرض التقدّم في الوقت الفعلي
3. عند الانتهاء، تظهر المقالات في القائمة بوسم GitHub

#ربط GitLab

#الخطوة 1 — التفويض

1. في LiKE انتقل إلى التكاملات ← GitLab ← «ربط»
2. اختر طريقة تفويض:

#الخطوة 2 — اختيار المحتوى

1. تُعرض شجرة المشروع بصفحات Wiki وملفات Markdown
2. حدّد الصفحات المعيّنة للاستيراد (Selective Sync)

#الخطوة 3 — تشغيل المزامنة

كما في GitHub — انقر «مزامنة» وانتظر انتهاءها.

#ربط Gitea

Gitea منصة git مُستضافة ذاتيًا. تُربَط عبر Personal Access Token ورابط إلزامي لنسختك (لا توجد Gitea سحابية افتراضيًا).

#الخطوة 1 — أنشئ رمزًا في Gitea

1. في Gitea افتح Settings ← Applications ← Generate New Token
2. امنح النطاقين read:repository و**read:user**
3. انسخ الرمز

#الخطوة 2 — اربط في LiKE

1. في LiKE انتقل إلى التكاملات ← Gitea ← «ربط»
2. حدّد Base URL لنسختك (على سبيل المثال https://gitea.company.com) — هذا الحقل إلزامي، وبدونه لن يتم الاتصال
3. الصق الرمز
4. اختر مكان حفظ المقالات (المساحة ومجلدًا داخلها — أو أنشئ جديدًا) ووضعًا (مزامنة — مرآة مستمرة / استيراد — نسخة لمرة واحدة)

يُدعم أيضًا OAuth 2.0 إذا كان مسؤول Gitea قد أعدّ تطبيق OAuth مسبقًا. المسار الأساسي هو الرمز.

#الخطوة 3 — اختيار المحتوى والمزامنة

1. تُعرض شجرة المستودع بصفحات Wiki وملفات Markdown (.md, .mdx)
2. حدّد العُقد التي تحتاجها (Selective Sync) وانقر «مزامنة»
3. للتحديثات التلقائية عند الدفع، أعدّ webhook — يُولَّد السرّ في بطاقة الموصّل. ومقالات Gitea للقراءة فقط (كما هو الحال مع GitHub/GitLab)

#اختيار الملفات ومرشّحات المزامنة (GitHub, GitLab, Gitea)

بالنسبة لمصادر git (GitHub وGitLab وGitea)، فإن منطق اختيار ما يُزامَن أدقّ من مجرّد «تشغيل/إيقاف المستودع»:

#ما الذي يُزامَن

#مرشّحات المسارات (المزامنة الانتقائية)

يمكنك تضييق ما تأخذه بالضبط من المستودع:

#كشف التغييرات (التغييرات الأخيرة)

لا «يُنزّل» LiKE كل شيء في كل تشغيل. يُستخدم كشف التغييرات:

• GitHub — عبر webhook (موصى به) أو الاستطلاع باستخدام ترويسات If-Modified-Since. يتفاعل الـ webhook مع الدفع فورًا، أما الاستطلاع فكل 6/12/24/48 ساعة (حسب المزامنة التلقائية).
• GitLab — كذلك: webhook أو استطلاع حسب last_activity_at عبر Projects API.
• Gitea — webhook (توقيع X-Gitea-Signature) أو استطلاع. لا يُطلَق مُشغّل الدفع إلا عند تغيّر *.md/*.mdx.

بمجرّد اكتشاف تغيير، تُزامَن الملفات المتأثّرة فقط؛ ولا يُعاد احتساب بقية المجموعة. وهذا يوفّر قدرًا كبيرًا من حصّة GitHub/GitLab API ومن وقت التنفيذ.

#الفرع والوسوم

#السجلّ والتعارضات

• سجلّ المزامنة — تبويب «السجلّ» في بطاقة الموصّل: التاريخ، والحالة ( سليم / تحذيرات / خطأ)، وعدد المقالات المُضافة / المُحدَّثة / المحذوفة، ومدة التشغيل. مفيد لتصحيح «لماذا لم تظهر مقالة من المستودع».
• تعارضات التحرير — إذا حُرِّرت مقالة من المصدر في LiKE (بالنسبة لـ GitHub/GitLab هذا غير مسموح افتراضيًا — المقالات للقراءة فقط). وإذا كان الوضع استيراد (نسخة لمرة واحدة)، تصبح المقالات قابلة للتحرير ويُقطَع الرابط بالمصدر.

#المزامنة الانتقائية للموصّلات الأخرى

Notion وConfluence وWiki.js — لها منطق اختيار خاص بها (شجرة صفحات)، لكن المبدأ نفسه:

1. عند الربط، تُعرض شجرة محتوى المصدر
2. مربّعات الاختيار — علّم على العُقد التي تحتاجها
3. لا يُستورَد الباقي
4. عند إعادة المزامنة، تُحدَّث العناصر المختارة فقط

#ربط Wiki.js

#الخطوة 1 — احصل على رمز Wiki.js API

1. افتح Wiki.js الخاص بك ← Administration ← API Access
2. فعّل الـ API (إذا كان معطّلًا)
3. انقر New API Key
4. سمِّ المفتاح (على سبيل المثال LiKE Integration)
5. المجموعة: Administrators (الوصول إلى جميع الصفحات مطلوب)
6. انتهاء الصلاحية: بلا انتهاء أو سنة واحدة
7. انسخ الرمز المُولَّد

#الخطوة 2 — اربط في LiKE

1. في LiKE انتقل إلى التكاملات ← Wiki.js ← «ربط»
2. أدخل URL الخاص بـ Wiki.js لديك (على سبيل المثال https://wiki.company.com)
3. الصق رمز API
4. اختر وضعًا:

5. انقر حفظ

#الخطوة 3 — اضبط المزامنة

#ربط Confluence

يُربَط Confluence عبر OAuth 2.0 — تفويض آمن دون إدخال كلمات مرور.

#الخطوة 1 — اربط موقع Confluence

1. يلزم Confluence Cloud — عنوان بصيغة your-company.atlassian.net. لا يتم دعم Confluence Server و Data Center
2. انقر على «ربط» وسجّل الدخول إلى حسابك في Atlassian
3. في نافذة الوصول، اختر موقع Confluence الخاص بك وانقر على «Accept». سيرى LiKE فقط ما هو متاح لك
4. هل تظهر لك «Access denied»؟ تحقّق على start.atlassian.com من أن حسابك لديه موقع Confluence. إذا كان الموقع موجوداً، فاطلب من مسؤول Atlassian السماح بربط التطبيقات: admin.atlassian.com → Apps → موقعك → Connected apps → Settings → إيقاف «Block user apps»

راجِع الأذونات — يطلب LiKE القراءة فقط: محتوى الصفحات وقائمة المساحات

#الخطوة 2 — مكان حفظ المقالات وما يُجلب

افتح «الإعداد» على بطاقة Confluence:

انقر «مزامنة».

#كيف يعمل الاختيار

ما دام لم يُحدَّد شيء، فلا شيء للمزامنة — وستوضح البطاقة ذلك. تُزال المساحة التي أُلغي تحديدها من LiKE مع مجلدها.

#ما لا ننقله

• المساحات الشخصية — لا تظهر في الشجرة: فهي ملاحظات شخصية للموظفين، واسمها اسم شخص.
• الإشارات إلى الأشخاص — الإشارة ذات التسمية يبقى منها نص التسمية، والإشارة بلا تسمية تُحذف؛ ولا يُنقل المكلَّفون بالمهام. لا يخزّن LiKE معرّفات مستخدمي Atlassian ولا ملفاتهم الشخصية.

مقالات Confluence للقراءة فقط. للتحرير، غيّر الأصل في Confluence، وسيحدّثه LiKE عند المزامنة التالية.

عند فصل Confluence، يمكنك الاحتفاظ بنسخة من المقالات في LiKE (تصبح قابلة للتحرير) أو حذفها.

#ربط Notion

#الخطوة 1 — أنشئ تكاملًا في Notion

1. افتح Notion ← انقر صورتك الرمزية (الزاوية العلوية اليسرى) ← Settings
2. في القائمة اليسرى اختر My connections (أو Integrations)
3. انقر Develop or manage integrations ← New integration
4. أدخل اسمًا (على سبيل المثال LiKE Import)، واختر مساحة عمل
5. انقر Submit ← انسخ Internal Integration Secret (يبدأ بـ ntn_؛ للتكاملات الأقدم — بـ secret_)

#الخطوة 2 — امنح التكامل وصولًا إلى الصفحات

افتراضيًا، لا يملك التكامل وصولًا إلى أي صفحات. عليك السماح بذلك صراحةً:

1. في Notion، افتح كل صفحة (أو الصفحة/قاعدة البيانات الأصل) تريد استيرادها
2. انقر ⋯ (ثلاث نقاط، الزاوية العلوية اليمنى) ← Connect to ← اختر تكامل LiKE Import الخاص بك
3. أكّد الوصول

#الخطوة 3 — اربط في LiKE

1. في LiKE ← لوحة التحكم ← التكاملات ← Notion ← «ربط»
2. الصق Integration Secret (المنسوخ في الخطوة 1)
3. اختر مكان حفظ المقالات: المساحة ومجلدًا داخلها — أو أنشئ هنا مباشرة مجلدًا جديدًا أو مساحة جديدة
4. اختر وضعًا:

5. في خطوة «اختيار المحتوى» حدِّد ما تريد جلبه: كتالوجات كاملة أو صفحات منفردة. الكتالوج هو صفحة جذر أو قاعدة بيانات منحتَ التكامل وصولًا إليها في الخطوة 2. ما دام لم يُحدَّد شيء، فلن يسمح لك المعالج بالمتابعة
6. انقر «ربط ومزامنة» — توضع مقالات كل كتالوج في مجلد خاص بها داخل المجلد المحدد في الخطوة 3

#كيف يعمل الاختيار

الصفحات الخالية من النص — مثل سجلات قاعدة البيانات التي لا تحتوي إلا على خصائص — لا تتحول إلى مقالات. تعرض بطاقة Notion عدد الصفحات التي تم تخطيها: «الصفحات الفارغة المتخطاة: N».

#الخطوة 4 — الإعدادات

افتح «الإعداد» على بطاقة Notion:

عند فصل Notion، يمكنك الاحتفاظ بنسخة من المقالات في LiKE (تصبح قابلة للتحرير) أو حذفها.

#موصل الويب

يربط موصل الويب صفحات موقعكم بـLiKE خلال دقائق معدودة. ألصِقوا العنوان — فيعثر LiKE على الصفحات عبر خريطة الموقع (sitemap) أو بالزحف على الروابط، ويجلب نصوصها ويحافظ على نسخة محدَّثة منها. يعمل بحث LiKE بالذكاء الاصطناعي على هذه الصفحات فورًا، ويمكنكم عند الحاجة وضع أداة بحث على الموقع — للعملاء أو للموظفين.

وهو مفيد عندما تكون الوثائق أو مركز المساعدة منشورة بالفعل — على نطاقكم الخاص أو في Docusaurus أو GitBook أو Docsify وما شابهها. يجب أن يكون الموقع عامًا. وتربط كل مؤسسة موقعًا واحدًا.

#الخطوة 1 — العنوان وطريقة العثور على الصفحات

التكاملات ← موصل الويب ← ربط. ألصِقوا العنوان؛ يكفي عنوان أي صفحة، فنحن نأخذ الموقع بأكمله.

كيفية العثور على الصفحات:

• عبر خريطة الموقع — افتراضيًا. نبحث عن الخريطة بأنفسنا: أولًا عبر robots.txt ثم عبر /sitemap.xml؛
• لا توجد خريطة موقع — تتبّع الروابط — نتتبّع الروابط من الصفحة الرئيسية داخل هذا الموقع؛ حدّدوا عمق الزحف. الصفحات التي يرسمها الموقع بالسكربت لا يراها الزحف.

اضغطوا تحقّق من الموقع. إذا لم يُعثر على الخريطة، يقترح المعالج تفعيل تتبّع الروابط والتحقق مرة أخرى.

#الخطوة 2 — ما الذي سنجلبه

الفحص لا يحفظ شيئًا: يعرض عدد الصفحات المكتشفة وعدد ما سيُضاف. وإذا لم يتّسع الحجم في الخطة، يقول المعالج ذلك فورًا، لا بعد الزحف.

• نسخة اللغة — تظهر إذا كان الموقع يقدّم صفحات بعدة لغات. اختاروا أيّها تُجلب؛ وتُعاد حساب الأرقام والمجلدات وفقها.
• ما سنجلبه من الموقع — قائمة المجلدات التي ستنشأ في القاعدة، مع عدد الصفحات في كل منها. المُعلَّم يُجلب؛ ويمكن إعادة المجلد الذي أُزيلت علامته. عدّاد المحدد لا يحتسب إلا المُعلَّم.
• أرشيفات التصنيفات والوسوم — قوائم روابط إلى مقالات ستصل إلى القاعدة على أي حال — لا تُجلب افتراضيًا؛ ضعوا علامة عليها إن احتجتم إليها.
• إذا كان الموقع مرتّبًا حسب السنوات، تصبح كل سنة مجلدًا مستقلًا. وعندما تكون هناك ثلاث سنوات أو أكثر، تُعلَّم أحدث سنتين في الموقع؛ ويمكن تعليم البقية يدويًا.
• الصفحة الرئيسية للموقع تصبح مقالة مستقلة في مجلد «الرئيسية».
• عدد الصفحات في كل زحف — إعداد لدينا، وليس حجم الموقع: ويأخذ الباقي في الجولات التالية.

لا يُعرف انتماء الصفحة إلى مجلد إلا من الصفحة نفسها، ولذلك يُفحص عدد من الصفحات أكبر مما سيُضاف؛ ويعرض المعالج الرقمين كليهما.

اقتراح: ما الذي نأخذه (عند الزحف على الروابط فقط). يقترح زر اسأل النموذج أي مجموعات العناوين تُؤخذ وأيها لا — مع الأسباب. هذا اقتراح وليس قرارًا: ضعوا علامة على ما توافقون عليه. يُحتسب الاستهلاك كما في عمليات الذكاء الاصطناعي في المحرّر؛ ويُحفظ الجواب ولا يُعاد حسابه إلا بزر إعادة الحساب.

#الخطوة 3 — كيف تُحفظ الصفحات وأين توضع

كيف تُحفظ الصفحات:

• داخلية — يراها الفريق فقط — افتراضيًا؛
• عامة — يراها الجميع.

إذا كان المجلد المختار مفتوحًا للجميع بالفعل، فسينبّهك المعالج ويقترح عامة: الصفحات في مثل هذا المجلد متاحة للجميع. لكي يراها فريقك فقط، اختر داخلية — وعندئذ تبقى مخفية حتى في مجلد مفتوح. في المجلد المغلق تتبع الصفحات الداخلية صلاحية الوصول إليه: إذا جعلت المجلد عامًا لاحقًا، فستُفتح معه — بعد فحص البيانات الشخصية.

الوصول العام يتطلب الإقرارين معًا: أن لديكم الحقوق على الموقع وعلى محتواه، وأن البيانات الشخصية على الموقع منشورة بصورة مشروعة ويحق لكم إتاحتها في البحث وفي إجابات المساعد. ودونهما يبقى زر ربط غير نشط. تُسجَّل الموافقة — من أكّدها ومتى وأي نص — وتسري على كل مقالات هذا الموقع: فعند نشرها لا حاجة إلى تأكيد البيانات الشخصية لكل مقالة على حدة. ولا يسري ذلك على المقالات المكتوبة في المحرّر. ولسحب الموافقة، افصلوا الموقع ثم أعيدوا ربطه مع اختيار «داخلية».

مكان الحفظ: اختر المساحة ومجلدًا داخلها. إن لم يوجد مجلد مناسب — إنشاء مجموعة بالداخل؛ وإن لم توجد مساحة مناسبة — إنشاء مساحة جديدة: يُنشآن عند الربط. المساحة نفسها لا تصلح هدفًا، ويجب أن يكون المجلد فارغًا: فلا يضع المحتوى في مجلد المصدر إلا الموصل نفسه.

بعد ربط يبدأ الزحف فورًا: ويظهر التقدّم على بطاقة الموصل («نُزامن 22 من 92 المحددة») وفي مؤشر المهام في الخلفية.

#ما يُؤخذ وما لا يُؤخذ

• يُؤخذ محتوى الصفحة دون قائمة الموقع ورأسه وتذييله؛
• تُعلَّم المجلدات في المعالج، ولاحقًا في إعدادات الموصل (الإعداد ← مجلدات الموقع)؛
• الأقسام الخدمية مثل البحث والوسوم تُتجاوز افتراضيًا؛
• عدد الصفحات في كل زحف يحدّ من الجولة الواحدة — حماية من المواقع الضخمة؛
• الصفحات الممنوعة في robots.txt لا تُجلب، ويظهر عددها في ملخّص الجولة؛
• في إجابة المساعد وفي ترويسة المقالة رابط فتح على الموقع — إلى الصفحة الأصلية.

#التحديثات اللاحقة

مع تفعيل التحديث تلقائيًا نعيد قراءة الموقع وفق الجدولة. تُعاد فهرسة الصفحات المتغيّرة فقط — وهكذا يقول الملخّص: «أُضيفت»، «حُدِّثت»، «دون تغيير». والصفحات غير المتغيّرة لا تستهلك حصة الفهرسة.

حذف المقالات التي اختفت من المصدر معطَّل افتراضيًا: فإذا اختفت صفحة من الموقع تبقى المقالة في قاعدتكم بعلامة «اختفت من المصدر». فعِّلوه إن كان لا بد أن تطابق النسخةُ الموقعَ بدقّة.

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

#أي المواقع تصلح وأيها لا

يصلح الموقع العام — الذي له خريطة (sitemap)، كما في معظم مولّدات التوثيق، أو الذي لا خريطة له مع الزحف على الروابط. أما ما عدا ذلك فنرفضه في خطوة الفحص، لا بعد الربط:

وحتى بعد نجاح الربط قد تبقى بعض الصفحات خارجًا: الممنوعة في robots.txt، والتي تردّ بخطأ، والتي يتجاوز حجمها 10 ميغابايت، أو التي لا تعيد HTML. وكلّها تظهر في ملخّص الجولة مع السبب: «متجاوَزة» و«ممنوعة بـ robots.txt».

الملفات (PDF وZIP والصور) لا تُجلب من الموقع. ولها مسار مستقل — استيراد الملفات، بمعالجته الخاصة.

#القيود

• موقع واحد لكل مؤسسة؛
• يجب أن يكون الموقع عامًا — فالصفحات المحمية بكلمة مرور لا تُقرأ؛
• خريطة الموقع ليست إلزامية: فبدونها يعمل الزحف على الروابط، غير أنه لا يرى إلا ما يحيل إليه الموقع بروابطه؛
• نلتزم بـrobots.txt، بما في ذلك مهلة الانتظار بين الطلبات المذكورة فيه.

فصل الموصل. تتوقف المزامنة، ويمكنكم حذف المقالات المستوردة أو الإبقاء عليها كمقالات عادية — يسأل LiKE عن ذلك عند الفصل.

#بعد الربط: البحث بالذكاء الاصطناعي وأداة على موقعكم

1. عند انتهاء الزحف، تشارك صفحات الموقع في بحث LiKE بالذكاء الاصطناعي على قدم المساواة مع المقالات المكتوبة في المحرّر، وتحيل الإجابة إلى الصفحة الأصلية — فتح على الموقع.
2. للبحث مباشرةً على موقعكم، أنشئوا أداة: التكاملات ← القنوات ← JS Widget ← إدارة الأدوات ← إنشاء أداة. وفي حقل عنوان الموقع الذي ستوضع فيه الأداة أدخلوا عنوان هذا الموقع.
3. اختاروا نوع الأداة:
   • عام — تبحث في المقالات العامة فقط، ومتاحة لكل الزوار. مناسبة للعملاء؛ ولهذا احفظوا صفحات الموقع بوضع عامة (الخطوة 3).
   • شركة — تبحث في المساحات المحددة، بما فيها المقالات الداخلية، وتتطلب تسجيل الدخول. مناسبة للموظفين.
4. أضيفوا نطاق بحث وفعّلوا الأداة. للنوع عام: كل المقالات العامة أو المجلد (المجموعة) الذي وضع فيه الموصل الصفحات، إذ لا يمكن للأداة العامة أن تشمل مساحة كاملة. للنوع شركة: المساحة أو المجلد الذي يضم صفحات الموقع.
5. انسخوا كود التضمين وألصِقوه في موقعكم. أين يتم ذلك في WordPress وTilda وWix وWebflow وSquarespace وShopify وFramer وGoogle Tag Manager وDocusaurus — انظروا API والأداة، قسم أين يُلصق الكود في منشئي المواقع.

#استيراد الملفات

#رفع الملفات

1. لوحة التحكم ← استيراد
2. اسحب الملفات إلى الداخل أو انقر منطقة الرفع
3. الصيغ المدعومة: PDF, DOCX, TXT, MD, RTF, ZIP
4. يولّد الذكاء الاصطناعي عنوانًا وslug تلقائيًا لكل ملف
5. قبل النشر يمكنك تحرير العنوان أو فتحه في المحرّر

#أرشيفات ZIP

ارفع أرشيف ZIP يحوي مستندات كثيرة — يفكّه LiKE تلقائيًا ويعالج كل ملف. مفيد لترحيل قاعدة معرفة بأكملها.

الملفات المدعومة داخل ZIP: PDF, DOCX, TXT, MD, RTF. أما الملفات الأخرى (الصور، الملفات التنفيذية) فتُتخطّى.

#الاستيراد عبر رابط

الصق رابطًا إلى مستند — يحمّله LiKE ويستورده:

1. لوحة التحكم ← استيراد ← قسم «الاستيراد عبر رابط»
2. الصق URL ← انقر «إضافة»
3. يمكنك إضافة حتى 10 روابط في المرة الواحدة
4. انقر «استيراد»

المصادر المدعومة:

• Google Docs — يُصدَّر تلقائيًا كـ DOCX
• Google Sheets — يُصدَّر كـ CSV
• Dropbox — رابط ملف مباشر
• أي URL مباشر إلى ملف PDF أو DOCX أو TXT أو MD أو RTF

#الظهور الافتراضي

لكل مصدر يمكنك ضبط ظهور افتراضي:

• مسودة — تُنشأ المقالات مخفية
• الفريق — مرئية للمستخدمين المصرَّح لهم
• عام — مرئية للجميع، بما في ذلك المستخدمون المجهولون

يُضبط في التكاملات ← بطاقة المصدر ← الظهور.

#قنوات الوصول

تتيح القنوات لموظفيك البحث عن المعلومات عبر أدوات مألوفة.

#روبوت Slack

الميزات:

• /like how do I set up SSO? ← إجابة ذكاء اصطناعي مباشرة في Slack
• ذكر @LiKE في أي قناة ← إجابة في المناقشة
• روابط إلى المقالات المصدر (قابلة للنقر)

#روبوت Telegram

يجيب الروبوت عن أسئلة فريقكم مباشرةً في تيليجرام اعتماداً على قاعدة معارفكم.

#الخطوة 1. إنشاء الروبوت في تيليجرام

لا تُنشأ الروبوتات على موقع إلكتروني، بل داخل تيليجرام نفسه عبر روبوت الخدمة @BotFather. ابحث في تيليجرام عن BotFather واختر الحساب الذي يحمل علامة زرقاء: الأسماء المشابهة كثيرة، والعلامة وحدها تدل على الحساب الرسمي. افتح المحادثة، اضغط بدء، ثم أرسل كرسالة عادية:

/newbot

سيطرح BotFather سؤالين:

1. الاسم الظاهر — يراه المشاركون في المحادثة، ويقبل أي لغة ومسافات، مثل مساعد Lynkora.
2. العنوان — به يُعثر على الروبوت في البحث. حروف لاتينية وأرقام وشرطات سفلية فقط، ويجب أن ينتهي بـ bot، مثل lynkora_help_bot.

ستصلك بعدها رمز الوصول (التوكن) — سلسلة على هيئة 8123456789:AAEhBOwe… تحتاجها في الخطوة التالية. وإذا كان الروبوت موجوداً وضاع التوكن، استخدم الأمر /mytoken.

#الخطوة 2. ربط الروبوت بـ LiKE

افتح التكاملات ← Telegram، والصق التوكن في حقل Bot Token، ثم اضغط ربط. تلزم صلاحيات المالك أو المسؤول.

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

بعد الربط تعرض البطاقة عنوان الروبوت وعلامة نشط.

#الخطوة 3. اختيار مصدر الإجابات

اضغط إعداد وحدّد المساحة التي يستقي منها الروبوت إجاباته، ويمكنك تضييقها إلى مجموعات بعينها. بدون هذا الإعداد سيجيب الروبوت بأنه لا يعرف مهما كان السؤال.

وفي الشاشة نفسها تُحدَّد التغطية: مقالات عامة فقط أم داخلية أيضاً. المقالات الداخلية تقتضي معرفة هوية السائل — انظر الخطوة التالية.

#الخطوة 4. تحديد مكان عمل الروبوت

في المحادثة الفردية — حوار ثنائي مع الروبوت. ولكي يعرف من يكتب إليه، تُربط المحادثة بالحساب: من الصفحة الرئيسية للبوابة اضغط «اسأل في المحادثة»، ثم «احصل على رمز الربط»، وأرسل الرمز إلى الروبوت في رسالة واحدة. الرمز يُستخدم مرة واحدة وصلاحيته عشر دقائق. بعد الربط يجيب الروبوت وفق صلاحيات هذا الشخص، بما في ذلك المقالات الداخلية. وكل موظف يربط محادثته بنفسه.

في المجموعة — يجيب الروبوت الجميع، لكن بالمقالات العامة فقط: ففي محادثة مشتركة يتعذّر تحديد صاحب السؤال.

ولكي يعمل داخل المجموعة:

1. عطّل إخفاء الرسائل: أرسل /setprivacy إلى BotFather، واختر الروبوت، ثم اضغط Disable. يخفي تيليجرام افتراضياً رسائل المجموعات عن الروبوتات، فلا يرى الروبوت الأسئلة أصلاً.
2. أزل الروبوت من المجموعة ثم أضفه من جديد، وإلا لن يسري الإعداد: يطبّقه تيليجرام لحظة انضمام الروبوت.
3. أضف محادثة المجموعة إلى قائمة المحادثات المسموح بها في إعدادات التكامل.

#الخطوة 5. التحقق

اطرح سؤالاً في موضوع موجود فعلاً في قاعدة المعارف. تصل الإجابة في المحادثة نفسها مع روابط المقالات المصدر.

لغة الإجابة تتبع لغة السؤال: إذا سألت بالألمانية جاءك الرد بالألمانية. أما إعداد «لغة الرسائل الخدمية» فيخص رسائل الرفض وتأكيد الربط فقط.

#فصل الروبوت وحذفه

الفصل عن LiKE: التكاملات ← Telegram ← «فصل». يتوقف الروبوت عن الإجابة ويُزال الارتباط، ويبقى الروبوت نفسه في تيليجرام ويمكن ربطه مجدداً.

تبديل الروبوت: افصل الحالي أولاً ثم اربط الجديد. وبالترتيب المعكوس يبقى القديم موجَّهاً إلى LiKE ويرسل رسائل لن يعالجها أحد.

حذف الروبوت نهائياً: الأمر /deletebot في BotFather. الإجراء لا رجعة فيه — يتحرر العنوان ولا يمكن استرجاع الروبوت.

#إذا لم يردّ الروبوت

#أداة JS (لموقعك)

زرّ بحث ذكاء اصطناعي عائم للتضمين في أي موقع. أكثر تكامل شيوعًا — يرى المستخدم زرًا في زاوية الصفحة، وينقره، فتُفتح محادثة مع الذكاء الاصطناعي وبحث في قاعدة معرفتك.

#تثبيت بسيط

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

#المعلمات الأساسية

#Dual-auth: وضعا مصادقة (ADR 0032)

في LiKE يمكن أن تعمل الأداة بأحد وضعين — يُختار عند الإنشاء:

للاطّلاع على تفاصيل ضبط كل وضع والتكامل مع خادومك الخلفي، راجع API والأداة.

#النطاق: ما الذي يمكن للأداة أن تجده

عند إنشاء أداة، تضبط نطاقًا — ما الذي تبحث فيه بالضبط:

يمكنك ضمن أداة واحدة دمج عدة مدخلات نطاق (على سبيل المثال، مجموعتان من المساحة نفسها).

#أدوات متعددة لكل مستأجر (ADR 0029 Stage 4)

يمكنك ضمن المؤسسة إنشاء عدة أدوات مستقلة بنطاقات وأوضاع مختلفة:

لكلٍّ منها api-key وتحليلات استخدام خاصة، ويمكن إبطال المفتاح على نحو مستقل. الإدارة في التكاملات ← القنوات ← JS Widget ← «إدارة الأدوات».

#إدارة الجلسات (وضع Session JWT)

في وضع Session JWT، لكل جلسة مستخدم sessionId فريد. يمكن للمسؤول عرض الجلسات النشطة لأداة معيّنة وإبطال رمز قسريًا (على سبيل المثال، عند الاشتباه في تسريب). القائمة في التكاملات ← الأدوات ← [الأداة] ← الجلسات.

#iframe / رابط مباشر

ضمّن واجهة بحث LiKE الكاملة في أي صفحة:

1. التكاملات ← iframe ← انسخ الشيفرة
2. الصق <iframe src="..."> في صفحتك
3. أو استخدم الرابط المباشر للتنقّل (صفحة كاملة، وليس تضمينًا)

يدعم iframe والرابط المباشر أيضًا dual-auth — يُختار عند الإنشاء.

#REST API

واجهة برمجية كاملة للتكامل البرمجي (على سبيل المثال، واجهتك الخاصة أو التكامل مع أنظمة أخرى):

1. التكاملات ← Public API ← «إنشاء مفتاح»
2. حدّد اسمًا والنطاقات المسموح بها
3. انسخ المفتاح — يُعرض مرة واحدة فقط، وبعد إعادة الفتح سيُخفى

استخدم المفتاح في ترويسة X-API-Key. لا يُقدَّم عبر المفتاح إلا المقالات العامة.

نقاط النهاية الرئيسية:

الحدود: الطلبات مقيّدة لكل مفتاح؛ وتجاوزها يُرجِع HTTP 429 مع ترويسة Retry-After.

وثائق API الكاملة: API والأداة.

#اللغات

يدعم LiKE 25+ لغة لبحث الذكاء الاصطناعي والبحث متعدّد اللغات (الواجهة نفسها متاحة بـ 12 لغة واجهة):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

البحث متعدّد اللغات: سؤال بلغة ما ← إجابة من مقالات بلغة أخرى.