21 августа 2026 г.

Вашу документацию никто не читает — и ваш показатель активации это доказывает

Дело не в том, что ваша документация плохая. Просто она не там, написана не с той высоты и читают её не в тот момент. Разбираем анатомию этого разрыва — и четыре навыка, которые его закрывают.

Трое коллег вместе работают за одним ноутбуком

Каждая SaaS-компания пишет документацию. И почти каждая всё равно видит, как пользователи застревают. Эти два факта соседствуют в каждом квартальном отчёте, и вывод почти всегда один: нам нужна документация получше. Это неверный вывод. С документацией обычно всё в порядке. Проблема в том, что она просит пользователя уйти из продукта, перевести свою ситуацию в поисковый запрос, прочитать общий ответ и перевести его обратно в конкретные клики — ровно в тот момент, когда ему меньше всего хочется делать хоть что-то из этого.

Эта статья — об этом разрыве: где он возникает, во что обходится, почему чат-виджеты его не закрыли и что закрывает на самом деле.


Парадокс документации

У документации есть структурная проблема, которую не исправить никаким качеством текста. Её создают люди, которые понимают продукт полностью, для людей, которые не понимают его совсем, а читают её в другой вкладке браузера — не в продукте.

Каждый из этих трёх фактов приводит к своему сбою.

Пишут эксперты. Автор руководства знает, что «подключите рабочее пространство» означает: нажать на аватар, потом «Настройки», потом «Интеграции», потом третью карточку. Он пишет «подключите рабочее пространство», потому что для него это и есть инструкция. Пользователь читает её, смотрит на экран с сорока интерактивными элементами и не видит ничего с надписью «подключить рабочее пространство».

Пишут для абстрактного читателя. Документация описывает продукт, а не аккаунт пользователя. Она не может сказать: «Вы уже добавили два рабочих места, поэтому нужная вам кнопка будет серой, пока вы не перейдёте на тариф выше». Она описывает идеальный сценарий для пользователя, которого не существует: данных ещё нет, недоделанных настроек нет, ограничений тарифа нет.

Читают в другом месте. Как только пользователь открывает вкладку с документацией, он выходит из сценария, который пытался пройти. Ему приходится держать своё намерение в рабочей памяти, пока он читает текст. Большинство людей на это не способны, поэтому они пробегают текст глазами, гадают и возвращаются в продукт с полузабытой инструкцией.

Возьмите сценарий, который ваша команда считает хорошо задокументированным. Понаблюдайте, как новый пользователь пытается его пройти, держа документацию открытой на втором мониторе. Посчитайте, сколько раз он переключает окна. Это число и есть настоящая цена вашей документации, и в вашей аналитике оно нигде не записано.


Где на самом деле утекает активация

Воронки онбординга обычно размечены не с той детализацией. Команды измеряют зарегистрировался → активирован, замечают провал и делают вывод, что продукт слишком сложный. Но провал — это не одно событие. Это три разных момента, и срываются они по разным причинам.


1. Первая настройка

Намерение у пользователя есть: он только что зарегистрировался, он мотивирован, он хочет увидеть, как всё работает. Ему не хватает ориентиров. Он не знает, какая из восьми вещей на экране — первый шаг. Это единственный момент, когда большинство продуктов вообще помогает, обычно с помощью продуктового тура — серии подсказок, которые подсвечивают элементы в заданном порядке.

Туры работают, когда ситуация пользователя совпадает с допущениями автора тура. И ломаются, как только пользователь нажимает куда-то не туда, приходит с уже импортированными данными или оказывается на тарифе, где четвёртый шаг недоступен.


2. Вторая задача

Это тихий убийца. Пользователь прошёл настройку, увидел немного пользы и теперь хочет сделать то настоящее, ради чего зарегистрировался, — многошаговый, ветвящийся, по-настоящему сложный сценарий, ради которого ваш продукт и существует.

По второй задаче туров никто не делает. Она слишком вариативна, чтобы расписать её заранее, и слишком важна, чтобы её пропустить. Поэтому пользователя отправляют в документацию, и дальше в силу вступает описанный выше парадокс.


3. Функция, которую так и не находят

Самая дорогая утечка не похожа на утечку, потому что пользователь не задаёт ни одного вопроса. Он просто так и не открывает для себя возможность, которая сделала бы его продвинутым пользователем, и продлевает подписку на самом дешёвом тарифе — или не продлевает вовсе, потому что так и не зашёл достаточно далеко, чтобы понять, за что здесь стоит платить.

Со стороны это похоже на здоровое использование. Аккаунт заходит в систему, пользуется двумя функциями и уходит через одиннадцать месяцев — без тикетов в поддержку и без жалоб. Ничто на вашем дашборде так и не краснеет, потому что «пользователь так и не нашёл то, что удержало бы его» — не то событие, которое можно отследить.


Почему чат-виджет этого не исправил

Последние десять лет индустрия отвечала на это чат-виджетом в углу экрана. Сначала в нём сидели люди, потом боты, теперь — LLM с вашей документацией в векторном хранилище. Это помогло: пользователю, который может задать вопрос прямо в продукте, лучше, чем тому, кто не может. Но разрыв это не закрыло, и причина вполне конкретна.

Чат-бот отвечает в облачке. А работа происходит в интерфейсе.

Спросите хорошего бота по документации: «Как настроить 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>

Вот и вся интеграция. Никаких обёрток для компонентов, никаких аннотаций маршрутов, никаких сценариев туров, которые нужно писать и перезаписывать при каждом изменении интерфейса. Виджет монтирует собственный корень с изолированными стилями, читает отрисованный интерфейс и начинает отвечать.

1 тег script — для установки в шаблон, который у вас уже есть

$1.50 — за пройденный онбординг; брошенные ничего не стоят

$25 — на балансе для начала, без привязки карты

Выберите сценарий, который порождает больше всего тикетов вида «как это сделать», — не самый эффектный, а самый надоедливый. Именно там разрыв между документацией и интерфейсом шире всего, и именно там слой подсказок докажет свою ценность за дни, а не за кварталы.


Метрики, которые действительно сдвигаются

Если вы это внедрили и хотите понять, сработало ли, главная метрика — не «отвеченные вопросы». Эта цифра сразу растёт и почти ничего не значит. Лучше следите вот за этими:

– Время до первого значимого действия. Не от регистрации до входа, а от регистрации до того, ради чего существует ваш продукт.

– Выполнение второй задачи. Доля пользователей, которые проходят сложный сценарий после первого успешного. Эту цифру документация не сдвигает никогда.

– Доля тикетов «как это сделать». Не общее число тикетов, а доля очереди, которая приходится на вопросы «как это сделать», а не на баги и оплату. Слой подсказок должен резко сократить первую категорию и не затронуть остальные.

– Освоение функций на аккаунт. Сколько разных возможностей аккаунт затрагивает за первые 30 дней. Это опережающий индикатор расширения.

Если первые три сдвинулись, а четвёртая нет, вы построили улучшенную службу поддержки. Именно движение четвёртой говорит о том, что навык менеджера по успеху клиентов — наблюдение — действительно работает.

---

Документация никуда не денется — и не должна. Это справочный слой, а справочные слои ценны для тех, кому они нужны: разработчиков, интегрирующих ваш API, администраторов, планирующих внедрение, и тех редких пользователей, которые искренне предпочитают читать.

Но пользователю, который застрял в четыре часа дня с недоделанной задачей и горящим дедлайном, никогда не была нужна статья получше. Ему был нужен кто-то, кто знает продукт, видит его экран и покажет — или просто сделает.

Встройте ИИ-менеджера по успеху клиентов в свой продукт одним тегом script. Без переделки продукта и без привязки карты.

«Большинству пользователей не нужен ещё один ответ. Они хотят, чтобы им показали путь или чтобы всё сделали за них. В этом весь продукт.» 

Gabriel Lancelot

Сооснователь Barkan

Gabriel Lancelot, сооснователь Barkan