# Telegram бот для организаторов

## Введение

Telegram бот **ИКОН Sponsors CRM** - это инструмент для организаторов соревнований, который позволяет управлять потенциальными спонсорами (лидами) и автоматизировать процесс отправки коммерческих предложений прямо из мессенджера.

```{note}
Бот доступен только авторизованным организаторам соревнований. Если у вас нет доступа, обратитесь к администратору платформы.
```

## Основные возможности

### Для чего нужен бот

- ✅ **Управление лидами** - создание, редактирование, отслеживание статусов потенциальных спонсоров
- ✅ **Генерация КП** - автоматическое создание коммерческих предложений с использованием AI
- ✅ **Отправка по email** - мгновенная отправка PDF файлов с КП прямо из Telegram
- ✅ **История взаимодействий** - логирование всех контактов с лидами
- ✅ **Задачи и напоминания** - планирование работы с лидами
- ✅ **Просмотр пакетов** - быстрый доступ к информации о спонсорских пакетах

### Преимущества

:::{grid} 2

:::{grid-item-card} 🚀 Скорость
Создание и отправка КП за 30 секунд
:::

:::{grid-item-card} 🤖 AI генерация
Персонализированные КП для каждого лида
:::

:::{grid-item-card} 📱 Мобильность
Работа из любой точки мира
:::

:::{grid-item-card} 📊 Аналитика
Полная история взаимодействий
:::

::::

## Требования к пользователям

### Кто может использовать бота

Доступ к боту имеют:

1. **Создатели соревнований** - пользователи, создавшие соревнование на ikong.ru
2. **Члены команды организатора** - пользователи, добавленные в команду через систему заявок
3. **Администраторы платформы** - staff и superuser

```{warning}
Для доступа к боту необходимо:
- Иметь аккаунт на ikong.ru
- Пройти авторизацию через Telegram
- Быть организатором хотя бы одного соревнования
```

### Как получить доступ

#### Если вы создатель соревнования

1. Зарегистрируйтесь на [ikong.ru](https://ikong.ru)
2. Создайте соревнование
3. Перейдите в настройки профиля → Telegram
4. Привяжите свой Telegram аккаунт
5. Запустите бота

#### Если вы член команды

1. Получите приглашение от организатора
2. Подайте заявку на вступление в команду
3. Дождитесь одобрения заявки организатором
4. Запустите бота

```{seealso}
Подробнее о системе заявок см. [Заявки в команду](telegram-bot-features.md#team-requests)
```

## Первый запуск

### Шаг 1: Найти бота

Найдите бота в Telegram по имени: **@ikongrubot** (имя может отличаться)

Или перейдите по прямой ссылке из профиля на ikong.ru.

### Шаг 2: Запустить бота

Нажмите кнопку **Start** или отправьте команду `/start`

Бот поприветствует вас и покажет главное меню.

### Шаг 3: Перейти в CRM

В главном меню выберите:

```
🏢 CRM Спонсоры
```

Откроется меню управления лидами и коммерческими предложениями.

## Главное меню CRM

После перехода в CRM вы увидите главное меню с разделами:

```{list-table}
:header-rows: 1
:widths: 15 35 50

* - Кнопка
  - Раздел
  - Описание
* - 👥 Лиды
  - [Управление лидами](telegram-bot-leads.md)
  - Создание, просмотр, редактирование потенциальных спонсоров
* - 📦 Пакеты
  - [Спонсорские пакеты](telegram-bot-features.md#packages)
  - Просмотр доступных пакетов спонсорства
* - ✅ Задачи
  - [Задачи и напоминания](telegram-bot-features.md#tasks)
  - Управление задачами и дедлайнами
* - 👨‍💼 Заявки
  - [Заявки в команду](telegram-bot-features.md#team-requests)
  - Управление заявками новых членов команды
```

## Основные команды

### Навигационные команды

```bash
/start      # Запустить бота, показать главное меню
/menu       # Вернуться к главному меню
/help       # Показать справку
```

### CRM команды

```bash
/leads      # Перейти к управлению лидами
/packages   # Показать спонсорские пакеты
/tasks      # Показать активные задачи
```

```{tip}
Используйте кнопки в меню вместо команд - это быстрее и удобнее!
```

## Навигация по боту

### Кнопки навигации

В каждом разделе доступны кнопки:

- **🔙 Назад** - вернуться к предыдущему экрану
- **🏠 Главное меню** - вернуться на главную страницу CRM
- **↻ Обновить** - обновить данные на текущей странице

### Inline кнопки

Некоторые действия выполняются через inline кнопки:

- Синие кнопки - основные действия (например, "Отправить по Email")
- Серые кнопки - дополнительные действия
- Зеленые кнопки - подтверждение (например, "✓ Одобрить")
- Красные кнопки - отмена или удаление

### Пагинация

Списки (лиды, задачи) разбиты на страницы по 10 элементов:

```
◀️ Назад  |  Страница 2/5  |  Вперед ▶️
```

## Статусы лидов

Бот использует систему статусов для отслеживания прогресса работы с лидом:

```{list-table}
:header-rows: 1
:widths: 10 20 70

* - Иконка
  - Статус
  - Описание
* - 🆕
  - Новый
  - Лид только создан, с ним еще не было контакта
* - ✉️
  - Email отправлен
  - КП отправлено на email лида
* - 📞
  - Контактирован
  - Был первый контакт (звонок, встреча)
* - 📊
  - Презентация
  - Проведена презентация пакетов спонсорства
* - 🤝
  - Встреча назначена
  - Запланирована личная встреча
* - 💬
  - Переговоры
  - Идут активные переговоры по условиям
* - 📄
  - Контракт отправлен
  - Договор отправлен на подпись
* - ✅
  - Контракт подписан
  - Договор подписан обеими сторонами
* - ⏳
  - Ожидание платежа
  - Ждем поступления оплаты
* - 🎉
  - Выигран
  - Лид конвертирован в спонсора, сделка завершена
* - ❌
  - Потерян
  - Лид отказался от сотрудничества
* - ⏸️
  - Отложен
  - Работа с лидом приостановлена временно
```

```{note}
Статусы обновляются автоматически при выполнении определенных действий. Например, после отправки email статус меняется на "Email отправлен".
```

## Быстрый старт

### Типичный сценарий работы

1. **Создайте лида** из раздела "Лиды" → "➕ Создать лида"
2. **Заполните данные** компании (система подтянет данные из ЕГРЮЛ по ИНН)
3. **Выберите пакет**, который может заинтересовать лида
4. **Создайте КП** нажав на лида → "📄 Создать КП"
5. **Выберите шаблон** (рекомендуем с пометкой AI)
6. **Дождитесь генерации** КП (~10-15 секунд)
7. **Отправьте по email** - письмо уйдет с PDF вложением
8. **Отслеживайте** статус лида и историю взаимодействий

```{seealso}
Подробные инструкции:
- [Работа с лидами](telegram-bot-leads.md)
- [Генерация и отправка КП](telegram-bot-proposals.md)
```

## Советы по использованию

```{tip}
**Используйте AI генерацию**

Шаблоны с пометкой "🤖 AI" создают более персонализированные КП с учетом:
- Специфики компании лида
- Типа бизнеса
- Региона проведения соревнования
- Истории взаимодействий
```

```{tip}
**Проверяйте preview перед отправкой**

Всегда просматривайте КП через кнопку "👁️ Посмотреть КП" перед отправкой спонсору. Preview ссылка действительна 24 часа.
```

```{tip}
**Ведите историю активностей**

Добавляйте заметки о каждом контакте с лидом через раздел "Активности". Это поможет команде быть в курсе всех взаимодействий.
```

## Частые вопросы

### Не могу найти бота в Telegram

Убедитесь, что:
1. Вы используете правильное имя бота
2. У вас есть аккаунт на ikong.ru
3. Ваш Telegram привязан к профилю на ikong.ru

### Бот не отвечает на команды

Возможные причины:
1. Вы не являетесь организатором ни одного соревнования
2. Ваша заявка в команду еще не одобрена
3. Бот временно недоступен (технические работы)

Обратитесь к администратору через [ikong.ru/support](https://ikong.ru/support)

### Как добавить нового члена команды

1. Новый член должен зарегистрироваться на ikong.ru
2. Привязать Telegram к аккаунту
3. Подать заявку на вступление через бота
4. Вы увидите заявку в разделе "👨‍💼 Заявки"
5. Одобрите заявку - доступ будет предоставлен

### Что делать если КП не отправляется

Проверьте:
1. ✅ Email адрес лида указан верно
2. ✅ У лида заполнены все обязательные поля (ФИО, компания)
3. ✅ Шаблон КП выбран правильно
4. ✅ Ваш интернет работает стабильно

Если проблема сохраняется - обратитесь в поддержку.

## Дополнительные материалы

```{toctree}
:maxdepth: 2

telegram-bot-leads
telegram-bot-proposals
telegram-bot-features
```

---

**Нужна помощь?**

- 📧 Email: [support@ikong.ru](mailto:support@ikong.ru)
- 💬 Telegram: [@ikong_support](https://t.me/ikong_support)
- 📖 Документация: [ikong.ru/docs](https://ikong.ru/docs/)