HereConnect-obsidian/Telegram-бот - Сценарий работы с сервисом.md

# Сценарий работы с сервисом через Telegram

## 1. Начало работы
1. Пользователь находит бота в Telegram по его имени или ссылке.
2. Нажимает кнопку «Запустить» или отправляет команду `/start`.

   Привет! Я бот сервиса "НаСвязи". Помогу вам создать QR-код (для автомобиля, питомца, входной двери и т.д.).

## 2. Создание QR-кода
1. Бот предлагает выбрать объект для QR-кода:

   Выберите объект, для которого вы хотите создать QR-код:
   2. Автомобиль
   3. Питомец
   4. Дверь квартиры
   5. Стол в ресторане
   6. Другое

7. Пользователь выбирает вариант (например, отправляет «1» для автомобиля).
8. Бот запрашивает название QR-кода:

   Укажите название для вашего QR-кода. Например, "Моя машина" или "Ошейник Бобика".

9. Пользователь вводит название, например: "Моя машина".
10. Бот подтверждает:

   Отлично! Ваш QR-код будет называться "Моя машина". Теперь настройте действия, доступные при его сканировании.

## 3. Настройка действий
1. Бот предлагает выбрать действия:

   Какие действия вы хотите включить для использования QR-кода?
   2. Отправить сообщение
   3. Показать номер телефона
   4. Прикрепить геопозицию
   (Выберите номера действий через запятую, например: 1, 3)

5. Пользователь выбирает, например, «1, 2».

## 4. Получение QR-кода
1. Бот генерирует QR-код и отправляет его в виде изображения:

   Ваш QR-код "Моя машина" готов! Вот он:
   [изображение QR-кода]
   Вы можете скачать изображение и разместить его на объекте.

2. Бот предоставляет инструкции по размещению, соответствующие типу объекта:

   Рекомендации по размещению QR-кода для автомобиля:
   - Разместите наклейку на заднем стекле или в углу бокового стекла.

   Сделайте "НаСвязи" удобнее. Будем рады вашей поддержке: [https://hereconnect.condev.ru/donate](https://hereconnect.condev.ru/donate)

3. Пользователь завершает процесс, используя QR-код.

## 5. Получение уведомлений
1. Когда QR-код используется для отправки сообщения, пользователь получает уведомление через бота:

   Новое сообщение для QR-кода "Моя машина":
   "Ваша машина мешает проезду."

2. Если QR-код настроен для отображения номера телефона, пользователь видит текст:

   QR-код "Моя машина": номер телефона владельца показан.

## 6. Управление QR-кодами
1. Пользователь может управлять своими QR-кодами, отправляя команду `/manage`.
2. Бот выводит список созданных QR-кодов и предлагает изменить их:

   Вот ваши QR-коды:
   1. Моя машина
   2. Ошейник собаки
   Выберите номер для управления или создайте новый QR-код командой `/new`.

## 7. Получение статистики
1. Пользователь отправляет команду `/stats`, чтобы получить данные по взаимодействиям:

   Статистика для "Моя машина":
   - Сканирований: 12
   - Сообщений: 5

## 8. Поддержка
1. Если у пользователя возникают вопросы, он отправляет команду `/help`.
2. Бот предоставляет базовую информацию о сервисе:

   Это сервис "НаСвязи" для создания QR-кодов для удобной связи. Вы можете создавать и настраивать QR-коды, а также управлять своими объектами.


# Сценарии ОШИБОК:

## 1. Начало работы
1. Пользователь находит бота в Telegram по его имени или ссылке.
2. Нажимает кнопку «Запустить» или отправляет команду `/start`.

   Привет! Я бот сервиса "НаСвязи". Помогу вам создать QR-код (для автомобиля, питомца, входной двери и т.д.).

---

# Сценарий: Неверный ответ при выборе объекта

## Описание
Пользователь вводит неверное значение (например, текст вместо числа) или значение, не входящее в предложенный диапазон (например, "10" вместо "1-5").

### Шаги:
1. Бот предлагает выбрать объект:

   Выберите объект, для которого вы хотите создать QR-код:
   2. Автомобиль
   3. Питомец
   4. Дверь квартиры
   5. Стол в ресторане
   6. Другое

7. Пользователь вводит некорректный ответ, например: "шесть" или "10".
8. Бот отвечает:

   Пожалуйста, выберите вариант из списка, отправив число от 1 до 5.

9. Пользователь исправляет ввод, например: "3".

---

# Сценарий: Неверный ответ при вводе названия QR-кода

## Описание
Пользователь не вводит название или отправляет слишком короткое название.

### Шаги:
1. Бот запрашивает название для QR-кода:

   Укажите название для вашего QR-кода. Например, "Моя машина" или "Ошейник Бобика".

2. Пользователь оставляет сообщение пустым или вводит слишком короткое название, например: "а".
3. Бот отвечает:

   Название должно содержать хотя бы 2 символа. Попробуйте ещё раз.

4. Пользователь исправляет ввод, например: "Моя машина".

---

# Сценарий: Неверный ответ при выборе действий

## Описание
Пользователь вводит текст вместо номеров действий или указывает некорректные номера (например, "7" вместо "1-3").

### Шаги:
1. Бот предлагает выбрать действия:

   Какие действия вы хотите включить для использования QR-кода?
   2. Отправить сообщение
   3. Показать номер телефона
   4. Прикрепить геопозицию
   (Выберите номера действий через запятую, например: 1, 3)

5. Пользователь вводит некорректный ответ, например: "все" или "7".
6. Бот отвечает:

   Пожалуйста, выберите номера действий из списка (1, 2 или 3), разделяя их запятой.

7. Пользователь исправляет ввод, например: "1, 2".

---

# Сценарий: Неверный ответ при управлении QR-кодами

## Описание
Пользователь вводит номер, которого нет в списке, или текст вместо номера.

### Шаги:
1. Бот выводит список созданных QR-кодов:

   Вот ваши QR-коды:
   2. Моя машина
   3. Ошейник собаки
   Выберите номер для управления или создайте новый QR-код командой `/new`.

4. Пользователь вводит некорректный ответ, например: "5" или "два".
5. Бот отвечает:

   Пожалуйста, выберите существующий номер QR-кода из списка (1 или 2).

6. Пользователь исправляет ввод, например: "1".

---

# Сценарий: Неверный ответ при запросе статистики

## Описание
Пользователь отправляет неверную команду вместо `/stats`.

### Шаги:
1. Пользователь вводит некорректную команду, например: `/статистика`.
2. Бот отвечает:

   Команда не распознана. Попробуйте использовать команду `/stats` для получения статистики.

3. Пользователь исправляет ввод, например: `/stats`.

---

# Дополнительное уведомление
В каждом случае некорректного ввода бот может добавить общее дружелюбное напоминание:

   Если у вас возникли вопросы, воспользуйтесь командой `/help` для получения информации.