# Запуск и обзор

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

Проект открывается на «Обзоре». Пока чат не запущен, там «Запуск чата» — список шагов. После последнего шага там видно, как чат работает сегодня. Шаги по порядку описаны в [Быстром старте](https://tolkly.io/docs/ru/quickstart.md). Здесь — что значит каждое состояние.

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

## Шаги запуска
У «Запуска чата» есть полоса — по отрезку на шаг — со счётчиком «N из 7». Если на сервере нет бота Telegram, шага «Telegram для операторов» нет, и шагов 6.

Два шага общие для всей компании, у них пометка «для всей компании». Их делают один раз, и они готовы во всех проектах компании.

Цвет точки у шага:

- зелёная — готово;
- оранжевая — ждёт вас;
- серая — в процессе;
- красная — сломалось.

Раскрыт тот шаг, который нужно сделать сейчас: первый сломанный, а если таких нет — первый неготовый.

| Шаг | Что в нём написано |
|---|---|
| «ИИ отвечает по вашим правилам» | «Сайт ещё не прочитан»; «Читаем сайт…» (серая); «12 страниц · проверьте ответы»; «Проверено 1 нояб. · 12 страниц» — после того как вы нажали «ИИ отвечает верно»; «Чтение ждёт вашего решения» (оранжевая); «Чтение не удалось …» или «robots.txt закрывает главную» (красная) |
| «Чат в цветах вашего сайта» | «Посмотрите и подтвердите»; «Подтверждено …» — после того как вы нажали «Так хорошо» или сохранили цвет или приветствие в «Виджете» |
| «Установить на сайт» | «Ждём первую загрузку»; «Работает на example.com»; «Не виден на example.com 7 дней» (красная) — если чат не загружался там 7 дней |
| «Telegram для операторов», для всей компании | «Группы пока нет»; «Подключена …»; «Отключена …» — если владелец её отключил; «Бота удалили …» (красная) |
| «Пригласить операторов», для всей компании | «Пока только вы»; «1 приглашение ждёт» (серая); «Готово …» — когда в компанию вошёл второй человек или вы нажали «Отвечаю сам» |
| «Кто отвечает и когда» | «Отвечает только ИИ», пока не включено «У проекта есть операторы». Потом — «Сначала ИИ, потом люди» или «Только операторы» ([Передача людям](https://tolkly.io/docs/ru/handoff.md#who)) |
| «Пробный разговор» | «Ещё нет»; «Ждёт ответа» (серая), пока переданный разговор ждёт; «Ответ …» после первого ответа оператора. Настоящий разговор посетителя тоже засчитывается |

### Внутри шага
Раскрытый шаг показывает состояние, одно действие и ссылку на свой раздел, где настраивается остальное. Прямо в шаге можно сделать только две вещи:

- «ИИ отвечает по вашим правилам» — чат для ваших вопросов. У каждого ответа видны цитата и страница. Эти вопросы никогда не считаются разговорами посетителей.
- «Установить на сайт» — код и кнопка «Скопировать код».

Остальные шаги ведут на свою страницу: «Виджет», «Telegram», «Команда», «Передача людям» или инбокс.

### «Не получается?»
Под шагами, для владельцев и администраторов, — помощь к раскрытому шагу:

- **«Инструкция»** — страница этой документации для шага.
- **«Скопировать задание»** — что сделать и как проверить, понятными словами для разработчика или ИИ-агента. Для установки это весь промпт установки ([Для ИИ-агентов](https://tolkly.io/docs/ru/agents.md#prompt)).
- **«Написать нам»** копирует наш контакт вместе с названием проекта и шага.

## После запуска
Когда все шаги хотя бы раз были готовы, список сворачивается в строку «Чат запущен» с датой. «Показать шаги» раскрывает его снова. Точка у этой строки показывает худший из сегодняшних шагов: если какой-то шаг красный, она не будет зелёной.

Шаг может перестать работать и после запуска: чат 7 дней не виден на сайте, бота удалили из группы, чтение сайта не удалось. Тогда:

- шаг поднимается в «Требует внимания»;
- у «Проектов» появляется красная точка — её видят владельцы и администраторы;
- над инбоксом владельцев и администраторов появляется полоса.

Шаг, который ждёт вас (например, новое чтение ждёт вашего решения), тоже попадает в «Требует внимания», но без точки.

О пропавшем чате и неудачном чтении сообщают в группу Telegram компании. Если бота удалили из группы, владельцам и администраторам приходит письмо.

### Сегодня
Цифры с полуночи по часовому поясу проекта. Они обновляются раз в минуту.

| Плитка | Что считает |
|---|---|
| «Разговоров» | Разговоры, начатые сегодня, и сколько из них ИИ ответил с проверенным источником |
| «Передано людям» | Разговоры, переданные сегодня, и сколько из них ждут оператора сейчас |
| «Спасибо, помогло» | Разговоры, где посетитель нажал «Помогло». Считается только его кнопка — не молчание и не закрытие оператором |
| «Первый ответ» | Сколько в среднем прошло от передачи до первого ответа оператора, в рабочие часы |

### Можно улучшить
Для владельцев и администраторов — то, что не входит в шаги запуска, но делает чат лучше. Каждая строка ведёт в свой блок:

- **«Домены»** — заблокируйте чужие сайты или разрешите чат только на своих доменах ([Домены и зеркала](https://tolkly.io/docs/ru/domains.md)).
- **«Темы для оператора»** — вопросы, которые всегда уходят людям. Если темы уже есть, строка показывает их число ([Темы](https://tolkly.io/docs/ru/handoff.md#topics)).
- **«Вопросы и ответы»** — ответы операторов, записанные для базы знаний, и ваши собственные ([База знаний](https://tolkly.io/docs/ru/knowledge.md#drafts)).
- **«Подпись посетителя»** — ваш сайт подписывает посетителя, и операторы видят, кто пишет ([Подпись посетителя](https://tolkly.io/docs/ru/identity.md)).

## Отчёты
У владельцев и администраторов в главном меню есть «Отчёты»: цифры всех проектов вместе или одного за 7, 30 или 90 дней. После запуска ссылка «Отчёты» рядом с «Чат запущен» открывает их для этого проекта. Дни считаются по часовому поясу компании, он задаётся на странице «Команда».

- **Плитки:** разговоры; доля ИИ-диалогов, где посетитель нажал «Помогло»; сколько передано людям — после ИИ или сразу; первый ответ оператора — от передачи человеку, в рабочие часы, если они заданы у проекта. На каждой плитке видно и значение за прошлый период, если в нём были разговоры.
- **По дням:** каждый разговор попадает в одну часть: «Помогло», «ИИ отказал», «Переданы людям», «Без отклика». Наведите на день или выберите его клавиатурой, чтобы увидеть цифры. Пока разговоров меньше чем за 7 дней, вместо графика — таблица по дням.
- **Почему переданы людям,** **Операторы** (первые ответы и оценки) и **Чего не хватает в базе знаний:** вопросы посетителей, на которые ИИ не нашёл ответа в ваших источниках, частые сначала. «×3» — в трёх разговорах. «Ответить» открывает [форму ответа](https://tolkly.io/docs/ru/knowledge.md#drafts); вопрос с готовым ответом помечен «есть ответ» и уходит вниз.

Если ИИ-диалогов меньше 10, доля пишется как «5 из 9», а не в процентах. Молчание — отдельная часть, решённым оно не считается никогда. Решён ли вопрос, решает только посетитель ([Как отвечает Tolkly](https://tolkly.io/docs/ru/overview.md#resolved)). Ваши пробные вопросы в шаге запуска не считаются. Операторы «Отчёты» не видят.

## Стартовая страница
Что открывается при входе, задаётся на странице аккаунта, в блоке «Стартовая страница», отдельно для каждой компании. Большинству подходит «Авто»: владелец или администратор до первого запуска попадает на обзор проекта, чтобы закончить настройку, а после — в «Отчёты»; оператор попадает в инбокс. Вместо «Авто» можно выбрать «Отчёты» (для владельцев и администраторов), «Инбокс» или «Проекты». Выбор сохраняется сразу. Прямая ссылка всегда открывается там, куда ведёт.

## На телефоне
На телефоне обзор служит ещё и списком разделов проекта. До запуска это просто навигация, «Разделы проекта»: все состояния и так видны в шагах выше. После запуска это «Состояние»: у каждого раздела своя точка и одна строка, как в панели на компьютере. Например: «Работает на example.com», «Страниц: 12», «Сначала ИИ, потом люди» или «Цвета вашего сайта · звук выключен».