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

كل شركة SaaS تكتب وثائق. وكل شركة SaaS تقريبًا ترى المستخدمين يتعثّرون رغم ذلك. تتجاور الحقيقتان في كل مراجعة ربع سنوية، والاستنتاج يكاد يكون دائمًا واحدًا: نحتاج إلى وثائق أفضل. وهذا استنتاج خاطئ. فالوثائق جيدة في العادة. المشكلة أن التوثيق يطلب من المستخدم أن يغادر المنتج، ويترجم وضعه إلى عبارة بحث، ويقرأ إجابة عامة، ثم يترجمها من جديد إلى نقرات محددة، في اللحظة نفسها التي يكون فيها أقل استعدادًا لفعل أي شيء من ذلك.
هذه مقالة عن تلك الفجوة: أين تنفتح، وكم تكلّف، ولماذا لم تسدّها نوافذ الدردشة، وما الذي يسدّها فعلًا.
مفارقة التوثيق
للتوثيق مشكلة بنيوية لا تُصلحها أي جودة في الكتابة. فهو يُكتب بأيدي أشخاص يفهمون المنتج فهمًا كاملًا، لأشخاص لا يفهمونه إطلاقًا، ويُقرأ في تبويب متصفح ليس هو المنتج.
وكل واحدة من هذه الحقائق الثلاث تسبّب إخفاقًا محددًا.
يكتبه الخبراء. كاتب الدليل يعرف أن «اربط مساحة عملك» تعني النقر على الصورة الرمزية، ثم «الإعدادات»، ثم «التكاملات»، ثم البطاقة الثالثة. فيكتب «اربط مساحة عملك» لأن هذه العبارة، في نظره، هي التعليمات. يقرؤها المستخدم، وينظر إلى شاشة فيها أربعون عنصرًا تفاعليًا، فلا يرى شيئًا عنوانه «اربط مساحة عملك».
يُكتب لقارئ عام. الوثائق تصف المنتج، لا حساب المستخدم. لا يمكنها أن تقول: «لقد أضفت مقعدين بالفعل، لذا فالزر الذي تريده رمادي معطّل حتى تُرقّي باقتك». إنها تصف المسار المثالي لمستخدم غير موجود: لا بيانات بعد، ولا إعدادات نصف مكتملة، ولا قيود خاصة بالباقة.
يُقرأ في مكان آخر. في اللحظة التي يفتح فيها المستخدم تبويب الوثائق، يكون قد غادر سير العمل الذي كان يحاول إكماله. وعليه أن يحتفظ بنيّته في ذاكرته العاملة وهو يقرأ نصًا. ومعظم الناس لا يستطيعون، فيقرؤون على عجل، ويخمّنون، ثم يعودون إلى المنتج بتعليمات لا يتذكرون إلا نصفها.
خذ سير عمل يرى فريقك أنه موثّق جيدًا. راقب مستخدمًا جديدًا يحاول تنفيذه والمستند مفتوح على شاشة ثانية. عُدّ المرات التي ينتقل فيها بين النوافذ. هذا الرقم هو التكلفة الحقيقية لتوثيقك، وهو غير مسجّل في أي مكان من أدوات التحليل لديك.
أين يتسرّب التفعيل فعلًا
عادةً ما تُقاس مسارات تحويل التهيئة بدقة غير مناسبة. تقيس الفرق سجّل ← فُعِّل، فتلاحظ التراجع، وتستنتج أن المنتج معقّد أكثر من اللازم. لكن التراجع ليس حدثًا واحدًا، بل ثلاث لحظات مختلفة، ولكلٍّ منها سبب إخفاق مختلف.
1. الإعداد الأول
لدى المستخدم نيّة: لقد سجّل للتو، وهو متحمس، ويريد أن يرى المنتج يعمل. ما ينقصه هو معرفة الاتجاه. لا يعرف أيًّا من الأشياء الثمانية على الشاشة هو الخطوة الأولى. وهذه هي اللحظة الوحيدة التي تساعد فيها معظم المنتجات أصلًا، عادةً بجولة تعريفية: سلسلة من التلميحات التي تُبرز العناصر بترتيب ثابت.
تنجح الجولات حين يطابق وضع المستخدم افتراضات كاتب الجولة. وتتعطّل في اللحظة التي ينقر فيها المستخدم في مكان غير متوقع، أو يصل وبياناته مستوردة مسبقًا، أو يكون على باقة تُعطَّل فيها الخطوة الرابعة.
2. سير العمل الثاني
هذا هو القاتل الصامت. تجاوز المستخدم الإعداد، ورأى شيئًا من القيمة، ويريد الآن أن يُنجز ما سجّل من أجله حقًا: سير العمل متعدد الخطوات، المشروط، المعقّد فعلًا، الذي وُجد منتجك ليجعله ممكنًا.
لا أحد يصمّم جولة لسير العمل الثاني. فهو أكثر تنوعًا من أن يُكتب له سيناريو، وأهم من أن يُتجاهل. فيُحال المستخدم إلى الوثائق، وتتولى المفارقة التي وصفناها زمام الأمر.
3. الميزة التي لا يجدها أبدًا
أغلى تسرّب لا يبدو تسرّبًا، لأن المستخدم لا يطرح سؤالًا أبدًا. هو ببساطة لا يكتشف القدرة التي كانت ستجعله مستخدمًا متمرّسًا، فيجدّد اشتراكه في أدنى باقة، أو لا يجدّد إطلاقًا، لأنه لم يتقدّم بما يكفي ليرى لماذا يستحق المنتج ثمنه.
يبدو الأمر استخدامًا صحيًا. يسجّل الحساب دخوله، ويستخدم ميزتين، ثم يرحل بعد أحد عشر شهرًا بلا تذاكر دعم ولا شكاوى. لا شيء في لوحة مؤشراتك يتحوّل إلى اللون الأحمر أبدًا، لأن «المستخدم لم يكتشف الشيء الذي كان سيُبقيه» ليس حدثًا يمكنك قياسه.
لماذا لم تُصلح نافذة الدردشة هذا
كانت إجابة القطاع طوال العقد الماضي أن توضع نافذة دردشة في الزاوية. تولّاها البشر أولًا، ثم الروبوتات، والآن نماذج لغوية كبيرة تعتمد على وثائقك المخزّنة في قاعدة بيانات متجهية. وقد ساعد ذلك، فالمستخدم الذي يستطيع طرح سؤال داخل المنتج أفضل حالًا ممن لا يستطيع. لكنه لم يسدّ الفجوة، والسبب محدد.
روبوت الدردشة يجيب في فقاعة. والعمل يحدث في الواجهة.
اسأل روبوتًا جيدًا مدرَّبًا على الوثائق: «كيف أُعدّ SSO؟»، وستحصل على إجابة صحيحة، ومكتوبة بإتقان، من ست خطوات. والآن على المستخدم أن يقوم بالترجمة التي تخطّاها الروبوت:
1. يقرأ الخطوة الأولى ويحتفظ بها في ذاكرته.
2. يمسح الواجهة بحثًا عن شيء يطابق كلمات الخطوة الأولى.
3. يخمّن أي الزرّين المتشابهين هو المقصود.
4. ينقر، ثم يرى هل تشبه الشاشة التي ظهرت ما تصفه الخطوة الثانية.
5. إن لم تكن كذلك، يقرّر هل أساء فهم الإجابة أم أن الإجابة قديمة.
6. يكرّر ذلك مع كل خطوة متبقية، وثقته تتناقص في كل مرة.
هذه هي ضريبة الترجمة، وهي تُفرض على كل إجابة تقدّمها نافذة الدردشة. لقد نقل الروبوت التوثيق إلى داخل المنتج، دون أن ينقل العمل إلى داخله.
روبوت الدردشة يشرح في فقاعة. أما مدير نجاح العملاء فيُنجز المهمة، ولم يكن الشرح ولا الفقاعة هو المقصود أصلًا.
— ما تعلّمناه ونحن نبني Barkan
وهناك إخفاق ثانٍ أدقّ. فروبوت الدردشة الذي يقرأ وثائقك يعرف ما يفعله المنتج بوجه عام. لكنه لا يعرف ما على شاشة المستخدم الآن: على أي باقة هو، وأي الحقول ملأ بالفعل، وأي زر معطّل ولماذا. لذا تأتي إجاباته عامة وواثقة في اللحظات نفسها التي يحتاج فيها المستخدمون إلى شيء محدد.
---
ما الذي يفعله مدير نجاح العملاء بشكل مختلف
كل شركة SaaS تعرف الحل أصلًا، لأنها تطبّقه بالفعل، لكن لأكبر حساباتها. امنح العميل شخصًا بعينه يعرف المنتج، ويراقب استخدامه، ويسارع إلى مكالمة ليرافقه في الأجزاء الصعبة، فيُفعّل ذلك العميل حسابه، ويوسّع استخدامه، ويبقى.
لم يجادل أحد قط في أن هذا النموذج لا ينجح. كانت الحجة دائمًا أنه لا يقبل التوسّع: لا يمكنك أن تخصص مدير نجاح عملاء بشريًا لحساب يدفع $99 شهريًا وتبقى في السوق.
إذن السؤال ليس هل ينجح نموذج مدير نجاح العملاء، بل أيّ سلوكياته يمكن نقلها إلى البرمجيات. وهي أربعة.

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

يُنفّذ
في مسارات العمل المفهومة جيدًا والآمنة، نفّذ المهمة. املأ الحقول، وانقر خطوةً بعد خطوة، وتنقّل بين الصفحات. يقول المستخدم ما يريده بكلماته، ويشاهده يحدث، وهي تجربة مختلفة جذريًا عن أن يُعلَّم كيف يفعل ذلك بنفسه.
وهنا أيضًا تُكسب الثقة أو تُخسر، ولهذا ينبغي أن يتوقف كل إجراء مدمّر أو مكلف ويطلب الإذن قبل حدوثه، لا بعده.
يراقب
السلوك الذي يميّز مدير نجاح العملاء عن مكتب المساعدة: لم يضطر أحد إلى السؤال. مدير نجاح العملاء الجيد يلاحظ أن عميلًا أنهى الإعداد لكنه لم يفعّل قط الميزة التي تعتمد عليها حالة استخدامه، فيبادر بالتواصل. إنه تحرّك استباقي تقوده إشارات الاستخدام، وهو الذي يُنتج إيرادات التوسّع، لا مجرد تذاكر جرى تفاديها.
– يعرف الواجهة الحية، لا الوثائق فحسب.
– يدلّ على الطريق بمؤشر، بدل أن يصفه بنص.
– يُنفّذ مسارات العمل المعتمدة، ويتوقف قبل أي إجراء مدمّر.
– يراقب الاستخدام ويبادر بالكلام، قبل أن يتعثّر المستخدم أو يرحل.
الوثائق، وروبوت الدردشة، ومدير نجاح العملاء
كثيرًا ما تُقارن هذه المقاربات الثلاث كأنها إجابات متنافسة عن السؤال نفسه. لكنها ليست كذلك: إنها تجيب عن أسئلة مختلفة، وواحدة منها فقط تجيب عن السؤال الذي يطرحه المستخدم العالق فعلًا.
· التوثيق · نافذة الدردشة · مدير نجاح العملاء
أين يوجد · في تبويب آخر · داخل المنتج · داخل المنتج
ما يعرفه · المنتج بوجه عام · المنتج بوجه عام · الشاشة الحية لهذا المستخدم
ما يُنتجه · نص يحتاج إلى ترجمة · نص يحتاج إلى ترجمة · سير العمل مكتملًا
يتعامل مع سير العمل الثاني · بشكل ضعيف · أحيانًا · نعم
يلاحظ سؤالًا لم يُطرح · أبدًا · أبدًا · نعم
والصف الأهم هو الأخير. فالتوثيق ونوافذ الدردشة كلاهما قائم على ردّ الفعل: يتطلبان مستخدمًا يعرف أنه عالق، ومستعدًا للسؤال، وقادرًا على صياغة سؤاله. وكل مستخدم يستسلم بصمت يبقى غير مرئي لكليهما.
كيف تفعل ذلك دون إعادة بناء منتجك
الاعتراض المعقول عند هذه النقطة هو أن كل ما سبق يبدو إعادة كتابة للمنتج. لكنه ليس كذلك، ولا ينبغي أن يكون: فطبقة الإرشاد التي تتطلب منك إعادة هيكلة تطبيقك هي طبقة إرشاد لن يعتمدها أحد.
التثبيت وسم script واحد في القالب الذي تعرضه أصلًا على كل مسار:
<script async src="https://trybarkan.com/widget.js" data-barkan-site="site_your_key"></script>هذا هو التكامل كله. لا أغلفة للمكوّنات، ولا تعليقات توضيحية على المسارات، ولا نصوص جولات تكتبها وتعيد تسجيلها كلما تغيّرت الواجهة. يُنشئ شريط Barkan جذره الخاص بأنماط معزولة، ويقرأ الواجهة المعروضة، ويبدأ في الإجابة.
وسم script واحد — تثبّته في القالب الذي لديك أصلًا
$1.50 — لكل تهيئة مكتملة؛ أما المتروكة فمجانية
$25 — رصيد مجاني للبدء، دون الحاجة إلى بطاقة
اختر سير العمل الذي يولّد أكثر تذاكر «كيف أفعل؟»، لا الأكثر بريقًا، بل الأكثر إزعاجًا. فهناك تتّسع الفجوة بين توثيقك وواجهتك أكثر من أي مكان آخر، وهناك تُثبت طبقة الإرشاد قيمتها في أيام لا في أرباع سنة.
المقاييس التي تتحرك فعلًا
إن طبّقت هذا وأردت أن تعرف هل نجح، فالمقياس الرئيسي ليس «عدد الأسئلة المُجاب عنها». هذا الرقم يرتفع فورًا ولا يعني الكثير. راقب هذه المقاييس بدلًا منه:
– الوقت حتى أول إجراء ذي معنى. ليس من التسجيل إلى تسجيل الدخول، بل من التسجيل إلى الشيء الذي وُجد منتجك من أجله.
– معدل إكمال سير العمل الثاني. نسبة المستخدمين الذين يُكملون سير عمل معقدًا بعد أول سير عمل ناجح لهم. وهذا هو الرقم الذي لا يحرّكه التوثيق أبدًا.
– حصة تذاكر «كيف أفعل؟». ليس إجمالي التذاكر، بل نسبة ما في قائمة انتظارك من أسئلة «كيف أفعل؟» مقارنةً بالأعطال والفوترة. ينبغي لطبقة الإرشاد أن تُقلّص الفئة الأولى بشدة، وتترك البقية على حالها.
– اكتشاف الميزات لكل حساب. عدد القدرات المختلفة التي يستخدمها الحساب في أول 30 يومًا. وهذا هو المؤشر الاستباقي للتوسّع.
إن تحرّكت المقاييس الثلاثة الأولى ولم يتحرك الرابع، فقد بنيت مكتب مساعدة أفضل. أما تحرّك الرابع فهو ما يُخبرك بأن سلوك مدير نجاح العملاء، أي المراقبة، يعمل فعلًا.
---
التوثيق لن يختفي، ولا ينبغي أن يختفي. إنه الطبقة المرجعية، وللطبقات المرجعية قيمة عند من يريدونها: المطوّرون الذين يدمجون واجهة API الخاصة بك، والمسؤولون الذين يخطّطون لطرح المنتج في مؤسساتهم، والمستخدم العرضي الذي يفضّل القراءة حقًا.
لكن للمستخدم العالق في الرابعة عصرًا، وأمامه سير عمل لم يكتمل وموعد نهائي، لم تكن الإجابة يومًا مقالة أفضل. بل كانت شخصًا يعرف المنتج، ويرى شاشته، ويدلّه على الطريق، أو ينجز المهمة عنه ببساطة.
ضع مدير نجاح عملاء بالذكاء الاصطناعي داخل منتجك بوسم script واحد. دون إعادة بناء، ودون الحاجة إلى بطاقة.
«معظم المستخدمين لا يريدون إجابة أخرى. يريدون من يدلّهم على الطريق، أو من ينجز المهمة عنهم. هذا هو المنتج كله.»
Gabriel Lancelot
شريك مؤسس في Barkan
