# Управление лидами через Telegram

## Введение

Раздел "Лиды" в Telegram боте позволяет полноценно управлять потенциальными спонсорами: создавать, редактировать, отслеживать статусы и вести историю взаимодействий.

```{note}
**Лид** - потенциальный спонсор, компания или организация, которая может быть заинтересована в спонсорстве вашего соревнования.
```

## Доступ к разделу лидов

### Как открыть раздел

1. Запустите бота `/start`
2. Выберите **🏢 CRM Спонсоры**
3. Нажмите **👥 Лиды**

Или используйте команду: `/leads`

### Выбор соревнования

После входа в раздел лидов вы увидите список ваших соревнований:

```
📍 KING KONG Осень 2025
📍 CrossFit Open 2026
📍 Битва залов Москва
```

Выберите соревнование, для которого хотите работать с лидами.

## Просмотр списка лидов

### Фильтрация по статусам

После выбора соревнования выберите фильтр:

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

* - Фильтр
  - Описание
* - **📋 Все лиды**
  - Показать всех лидов без фильтрации
* - **🆕 Новые**
  - Лиды со статусом "Новый" - требуют внимания
* - **✉️ Email отправлен**
  - Лиды, которым уже отправлено КП
* - **📞 Контактирован**
  - Лиды, с которыми был первый контакт
* - **💬 В переговорах**
  - Активные переговоры
* - **🎉 Выигранные**
  - Конвертированные спонсоры
* - **❌ Потерянные**
  - Отказавшиеся лиды
```

### Список лидов

Каждая карточка лида в списке показывает:

```
🏢 ООО "СПОРТПИТ ЦЕНТР"
📧 contact@sportpit.ru
📱 +7 (495) 123-45-67
📦 Генеральный спонсор
🎯 Вероятность: 70%
📊 Статус: ✉️ Email отправлен

[Открыть →]
```

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

Списки разбиты на страницы по 10 лидов:

```
◀️ Пред  |  Страница 2/5  |  След ▶️
```

## Создание нового лида

### Начало создания

Из списка лидов нажмите:

```
➕ Создать лида
```

Начнется пошаговый процесс создания лида.

### Шаг 1: Выбор соревнования

Если у вас несколько соревнований, выберите для какого создаете лида:

```
Выберите соревнование:

📍 KING KONG Осень 2025
📍 CrossFit Open 2026
```

### Шаг 2: Ввод ИНН или ОГРН компании

Введите ИНН (10 или 12 цифр) или ОГРН (13 цифр) компании:

```
Введите ИНН или ОГРН компании:

Пример: 7728168971
```

```{tip}
**Интеграция с DaData**

Система автоматически найдет компанию в ЕГРЮЛ и подтянет все данные:
- Полное наименование
- Юридический адрес
- ОКВЭД
- Список филиалов (если есть)
- Статус (действующая/ликвидирована)
```

### Шаг 3: Выбор филиала (если есть)

Если у компании есть филиалы, выберите нужный:

```
Найдено несколько адресов:

📍 Головной офис
   Москва, ул. Ленина, д. 1

📍 Филиал в Санкт-Петербурге
   СПб, Невский пр., д. 10

📍 Филиал в Казани
   Казань, ул. Баумана, д. 5
```

Или выберите "Головной офис" если не нужен филиал.

### Шаг 4: Подтверждение данных компании

Проверьте автоматически заполненные данные:

```
✅ Данные компании найдены:

🏢 ООО "СПОРТПИТ ЦЕНТР"
🆔 ИНН: 7728168971
📍 Адрес: г. Москва, ул. Ленина, д. 1
💼 ОКВЭД: Розничная торговля спортивными товарами
📊 Статус: Действующая

Подтвердить?

[✅ Да, верно] [✏️ Изменить]
```

```{warning}
**Ликвидированные компании**

Если компания ликвидирована, система покажет предупреждение:
```
❌ Компания ликвидирована!
Дата ликвидации: 15.03.2024

Все равно продолжить?

[Да] [Отмена]
```
```

### Шаг 5: Ввод контактного лица

Введите ФИО контактного лица (ЛПР - лицо принимающее решения):

```
Введите Имя и Отчество контактного лица:

Пример: Иван Петрович
```

```{note}
Имя и Отчество используются для персонализированного обращения в КП:
"Здравствуйте, Иван Петрович!"
```

### Шаг 6: Ввод email

Введите email контактного лица:

```
Введите email для отправки КП:

Пример: ivan.petrov@sportpit.ru
```

Система проверит формат email (наличие @ и домена).

### Шаг 7: Ввод телефона

Введите номер телефона:

```
Введите телефон:

Пример: +7 (495) 123-45-67
или: 89151234567
```

Допускаются любые форматы, система нормализует номер.

### Шаг 8: Выбор заинтересованного пакета

Выберите спонсорский пакет, который может заинтересовать лида:

```
Выберите пакет:

💎 Генеральный спонсор - 250,000 ₽
🏆 Спонсор категории RX - 100,000 ₽
⭐ Официальный партнер - 30,000 ₽
📢 Информационный партнер - 10,000 ₽
```

### Шаг 9: Указание вероятности сделки

Оцените вероятность закрытия сделки (0-100%):

```
Укажите вероятность сделки (0-100%):

Примеры:
• 10-30% - первый контакт
• 40-60% - активные переговоры
• 70-90% - близко к подписанию
```

Или нажмите "Пропустить" - по умолчанию установится 50%.

### Шаг 10: Финализация

Проверьте все данные и нажмите:

```
✅ Создать лида
```

Лид будет создан со статусом "🆕 Новый".

## Просмотр карточки лида

### Открытие карточки

Нажмите на лида из списка чтобы открыть полную информацию:

```
🏢 ООО "СПОРТПИТ ЦЕНТР"

👤 Контакт: Иван Петрович
📧 ivan.petrov@sportpit.ru
📱 +7 (495) 123-45-67

📦 Пакет: Генеральный спонсор
💰 Цена: 250,000 ₽
🎯 Вероятность: 70%

📊 Статус: ✉️ Email отправлен
📅 Создан: 15.10.2025
📅 Обновлен: 20.10.2025

💬 Последняя активность:
20.10.2025 - КП отправлено по email
```

### Доступные действия

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

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

* - Кнопка
  - Действие
* - **📞 Позвонить**
  - Открывает набор номера в телефоне (tel: ссылка)
* - **📧 Email**
  - Открывает почтовый клиент (mailto: ссылка)
* - **🔄 Обновить данные**
  - Повторный запрос в DaData для обновления данных компании
* - **🔀 Изменить статус**
  - Выбор нового статуса из списка
* - **📄 Создать КП**
  - Переход к генерации коммерческого предложения
* - **💬 История**
  - Просмотр всех активностей (звонки, встречи, email)
* - **➕ Активность**
  - Добавить новую активность (звонок, встреча, заметка)
```

## Редактирование лида

### Обновление данных компании

Нажмите **🔄 Обновить данные** в карточке лида:

```
Обновить данные компании из ЕГРЮЛ?

[✅ Да, обновить] [❌ Отмена]
```

Система запросит актуальные данные из DaData и обновит:
- Название компании
- Юридический адрес
- ОКВЭД
- Статус компании

```{warning}
Контактные данные (ФИО, email, телефон) НЕ обновляются автоматически, т.к. они уникальны для каждого лида.
```

### Изменение статуса

Нажмите **🔀 Изменить статус**:

```
Текущий статус: ✉️ Email отправлен

Выберите новый статус:

🆕 Новый
📞 Контактирован
📊 Презентация
🤝 Встреча назначена
💬 Переговоры
📄 Контракт отправлен
✅ Контракт подписан
⏳ Ожидание платежа
🎉 Выигран
❌ Потерян
⏸️ Отложен
```

После выбора статус обновится и будет залогирован в историю.

### Редактирование контактов

Для изменения email, телефона или ФИО контактного лица:

1. Перейдите на веб-версию ikong.ru
2. Откройте CRM → Лиды
3. Найдите нужного лида
4. Отредактируйте поля
5. Сохраните изменения

```{note}
Редактирование полей лида через бота пока недоступно. Используйте веб-интерфейс.
```

## Быстрые действия с лидом

### Позвонить лиду

Нажмите **📞 Позвонить** в карточке лида:

- На смартфоне откроется набор номера
- На десктопе откроется приложение для звонков (если установлено)

После звонка не забудьте добавить активность "Звонок" в истории.

### Написать email

Нажмите **📧 Email** в карточке лида:

- Откроется ваш почтовый клиент
- Email получателя будет подставлен автоматически
- Тема и тело письма будут пустыми

Для отправки КП используйте специальную функцию "Создать КП" → "Отправить по Email".

## Работа с несколькими лидами

### Массовые действия

Пока недоступны массовые действия через бота. Для множественных операций используйте веб-интерфейс:

- Экспорт лидов в CSV
- Массовое изменение статусов
- Массовая отправка email

### Дублирование лида

Если нужно создать похожего лида (например, другой филиал той же компании):

1. Создайте нового лида с тем же ИНН
2. Выберите другой филиал
3. Укажите другое контактное лицо

## История взаимодействий

### Просмотр активностей

Нажмите **💬 История** в карточке лида:

```
История взаимодействий:

📅 20.10.2025 15:30
✉️ Email отправлен
Шаблон: Генеральный спонсор
PDF: КП_KINGKONG_SPORTPIT.pdf
Автор: Иван Организатор

📅 15.10.2025 10:00
📞 Звонок
Длительность: 15 мин
Результат: Заинтересован, попросил выслать КП
Автор: Иван Организатор

📅 10.10.2025 14:00
📝 Заметка
Компания ищет спонсорство для усиления бренда
Автор: Иван Организатор
```

### Добавление активности

Нажмите **➕ Активность** и выберите тип:

```
Выберите тип активности:

📞 Звонок
🤝 Встреча
📝 Заметка
```

#### Добавить звонок

1. Выберите **📞 Звонок**
2. Введите длительность (опционально):
   ```
   Длительность звонка (в минутах):
   Пример: 15
   ```
3. Введите результат/заметку:
   ```
   Результат звонка:
   Пример: Заинтересован, попросил выслать КП
   ```
4. Нажмите **✅ Сохранить**

#### Добавить встречу

1. Выберите **🤝 Встреча**
2. Введите место встречи:
   ```
   Место встречи:
   Пример: Офис компании, Москва
   ```
3. Введите результат:
   ```
   Результат встречи:
   Пример: Обсудили условия пакета, ждут решения директора
   ```
4. Нажмите **✅ Сохранить**

#### Добавить заметку

1. Выберите **📝 Заметка**
2. Введите текст заметки:
   ```
   Текст заметки:
   Пример: Компания планирует расширение в регионы
   ```
3. Нажмите **✅ Сохранить**

```{tip}
Активности видят все члены команды организатора. Используйте заметки для передачи контекста коллегам.
```

## Советы по работе с лидами

### Best Practices

:::{admonition} 💡 Заполняйте все поля при создании
:class: tip

Чем больше информации о лиде, тем легче работать с ним в дальнейшем. Обязательно указывайте:
- ФИО контактного лица для персонализации
- Реальный email для отправки КП
- Рабочий телефон для связи
:::

:::{admonition} 💡 Используйте DaData
:class: tip

Автоматическое заполнение данных из ЕГРЮЛ экономит время и снижает количество ошибок. Всегда используйте ИНН/ОГРН вместо ручного ввода.
:::

:::{admonition} 💡 Обновляйте статусы
:class: tip

Актуальные статусы помогают отслеживать воронку продаж. Меняйте статус после каждого значимого взаимодействия:
- После звонка → "Контактирован"
- После отправки КП → "Email отправлен"
- После встречи → "Переговоры"
:::

:::{admonition} 💡 Ведите историю
:class: tip

Добавляйте активности после каждого контакта. Это поможет:
- Вам вспомнить детали через неделю
- Коллегам понять контекст
- Анализировать эффективность продаж
:::

:::{admonition} 💡 Оценивайте вероятность реалистично
:class: tip

Вероятность сделки помогает планировать бюджет:
- 0-30% - холодный лид, только первый контакт
- 30-60% - теплый лид, есть интерес
- 60-90% - горячий лид, почти готов подписать
- 90-100% - ожидаем только оплату
:::

### Типичные ошибки

:::{admonition} ❌ Не обновлять статусы
:class: warning

Без актуальных статусов теряется контроль над воронкой продаж. Вы не знаете сколько лидов в работе, сколько ждут ответа.
:::

:::{admonition} ❌ Не добавлять заметки
:class: warning

Через неделю вы забудете детали разговора. Заметки - это ваша память и память команды.
:::

:::{admonition} ❌ Дублировать лидов
:class: warning

Перед созданием лида проверьте, может он уже есть в базе. Используйте поиск по названию компании или ИНН.
:::

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

### Как найти лида по названию компании?

Используйте фильтры по статусам и просматривайте список. Полнотекстовый поиск через бота пока недоступен.

Для быстрого поиска используйте веб-интерфейс: CRM → Лиды → строка поиска.

### Можно ли удалить лида?

Удаление лидов через бота недоступно. Для удаления используйте веб-интерфейс или обратитесь к администратору.

```{warning}
Удаление лида удаляет всю историю взаимодействий. Лучше использовать статус "❌ Потерян".
```

### Как передать лида другому менеджеру?

Лиды привязаны к соревнованию, а не к конкретному менеджеру. Все члены команды организатора видят всех лидов.

Используйте заметки чтобы указать кто работает с лидом:
```
Заметка: Передан Петру Иванову, продолжит переговоры
```

### Что если компания ликвидирована?

Система покажет предупреждение при вводе ИНН ликвидированной компании. Вы можете продолжить создание лида, но скорее всего сделка не состоится.

Рекомендуем найти актуальную компанию или филиал.

### Как изменить соревнование лида?

Изменение соревнования лида недоступно. Создайте нового лида для другого соревнования.

---

**Следующие шаги:**
- [Генерация и отправка КП](telegram-bot-proposals.md)
- [Задачи и напоминания](telegram-bot-features.md#tasks)