# Генерация и отправка коммерческих предложений

## Введение

Ключевая функция Telegram бота - автоматическая генерация и отправка персонализированных коммерческих предложений (КП) потенциальным спонсорам. Процесс занимает всего 30-60 секунд от выбора лида до отправки PDF на email.

```{note}
**Коммерческое предложение (КП)** - документ, содержащий предложение о спонсорстве с описанием пакета, преимуществ, цен и условий сотрудничества.
```

## Процесс генерации КП

### Шаг 1: Выбор лида

1. Откройте раздел **👥 Лиды**
2. Выберите соревнование
3. Найдите нужного лида в списке
4. Нажмите на лида чтобы открыть карточку

### Шаг 2: Начать создание КП

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

```
📄 Создать КП
```

Откроется список доступных шаблонов КП.

### Шаг 3: Выбор шаблона

Выберите шаблон коммерческого предложения:

```
Выберите шаблон КП:

💎 Генеральный спонсор 🤖
   250,000 ₽ · AI генерация

🏆 Спонсор категории RX 🤖
   100,000 ₽ · AI генерация

⭐ Официальный партнер 📝
   30,000 ₽ · Стандарт

📢 Информационный партнер 📝
   10,000 ₽ · Стандарт
```

#### Обозначения шаблонов

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

* - Значок
  - Описание
* - 🤖
  - **AI генерация** - КП создается с использованием искусственного интеллекта, учитывая специфику компании лида, отрасль, регион. Более персонализированный подход.
* - 📝
  - **Стандарт** - КП создается по фиксированному шаблону с подстановкой данных лида. Быстрее, но менее персонализировано.
```

```{tip}
**Рекомендуем использовать AI генерацию**

Шаблоны с 🤖 создают более убедительные КП, учитывая:
- Тип бизнеса компании-лида
- Регион проведения соревнования
- Предыдущие взаимодействия
- Интересы лида (указанный пакет)
```

### Шаг 4: Генерация КП

После выбора шаблона начнется генерация:

```
⏳ Генерирую КП...

Пожалуйста, подождите 10-15 секунд
```

#### Что происходит при генерации

:::{dropdown} С AI генерацией (🤖)
1. Система анализирует данные лида:
   - Название и сфера деятельности компании
   - ОКВЭД (вид деятельности)
   - Регион нахождения
   - Указанный заинтересованный пакет
   - История взаимодействий

2. AI (Perplexity) генерирует персонализированный текст:
   - Обращение с учетом специфики компании
   - Адаптированное описание преимуществ
   - Релевантные примеры и кейсы
   - Призыв к действию

3. Система создает PDF документ с:
   - Красивым дизайном
   - Логотипом соревнования
   - Персонализированным контентом
   - Контактами организатора
:::

:::{dropdown} Стандартная генерация (📝)
1. Система подставляет данные лида в шаблон:
   - Название компании
   - ФИО контактного лица
   - Название соревнования
   - Выбранный пакет

2. Используется предопределенный текст шаблона

3. Создается PDF документ
:::

### Шаг 5: Опции после генерации

После успешной генерации появятся кнопки действий:

```
✅ КП успешно сгенерировано!

Шаблон: Генеральный спонсор 🤖
Размер: 2.3 MB
Статус: Готово к отправке

[👁️ Посмотреть КП]
[📧 Отправить по Email]
[📥 Скачать PDF]
[📱 Открыть в Email клиенте]
[🔄 Сгенерировать заново]
[🔙 К лиду]
```

## Действия с КП

### Посмотреть КП (Preview)

Нажмите **👁️ Посмотреть КП** чтобы открыть preview в браузере:

```
Ссылка на preview:
https://ikong.ru/sponsors/preview/Xyz123AbC...

⏰ Ссылка действительна 24 часа

[Открыть в браузере →]
```

#### Для чего нужен preview

- ✅ Проверить содержимое перед отправкой
- ✅ Убедиться что все данные подставлены правильно
- ✅ Оценить качество AI генерации
- ✅ Скопировать ссылку для внутреннего использования

```{note}
**Preview ссылка - для внутреннего использования**

Эта ссылка предназначена только для менеджеров организатора. Не отправляйте её спонсору - используйте функцию "Отправить по Email" которая отправит PDF файл.
```

```{warning}
Ссылка действует 24 часа с момента создания. После этого preview будет недоступен, но КП останется в истории активностей лида.
```

### Скачать PDF

Нажмите **📥 Скачать PDF** чтобы скачать файл в Telegram:

- PDF файл будет отправлен прямо в чат с ботом
- Вы можете открыть его на любом устройстве
- Файл можно переслать, распечатать или сохранить

Имя файла: `КП_{Название_соревнования}_{Название_компании}.pdf`

Пример: `КП_KING_KONG_Осень_2025_СПОРТПИТ_ЦЕНТР.pdf`

### Открыть в Email клиенте

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

- На смартфоне автоматически откроется почтовый клиент
- Email лида будет подставлен в поле "Кому"
- Тема письма будет заполнена
- Тело письма будет содержать краткую информацию
- Вам останется только прикрепить PDF и отправить

```{tip}
Эта функция удобна если вы работаете с телефона и хотите отправить КП из своего личного email (не с ikong.ru).
```

### Сгенерировать заново

Нажмите **🔄 Сгенерировать заново** если:

- Не понравился результат AI генерации
- Хотите попробовать другой шаблон
- Данные лида изменились

```{note}
Каждая генерация создает новый preview с новым токеном. Старые preview остаются доступными 24 часа.
```

## Отправка КП по Email

### Начать отправку

Нажмите **📧 Отправить по Email**.

### Выбор email адреса

Система покажет email из профиля лида:

```
Отправить КП на email:

📧 ivan.petrov@sportpit.ru
   (из профиля лида)

[📧 Использовать этот email]
[✏️ Другой email]
[❌ Отмена]
```

#### Использовать email из профиля

Нажмите **📧 Использовать этот email** если email лида актуален.

#### Ввести другой email

Нажмите **✏️ Другой email** если нужно отправить на другой адрес:

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

Пример: new.email@company.ru
```

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

### Подтверждение отправки

Подтвердите отправку:

```
Отправить КП на email:
ivan.petrov@sportpit.ru

Компания: ООО "СПОРТПИТ ЦЕНТР"
Пакет: Генеральный спонсор
Размер PDF: 2.3 MB

[✅ Отправить] [❌ Отмена]
```

### Процесс отправки

После подтверждения:

```
📤 Отправляю email...
```

Обычно занимает 5-10 секунд.

### Результат отправки

```
✅ КП успешно отправлено!

📧 Email: ivan.petrov@sportpit.ru
🏢 Компания: ООО "СПОРТПИТ ЦЕНТР"
📎 PDF файл отправлен во вложении

Статус лида обновлён: Email отправлен

[📋 Preview КП (внутренняя ссылка)]
```

## Содержимое отправленного email

### Структура письма

Email, который получит спонсор, содержит:

#### Тема письма

```
Коммерческое предложение - KING KONG Осень 2025
```

#### Тело письма

```
Здравствуйте, Иван Петрович!

Высылаем коммерческое предложение по спонсорству соревнования KING KONG Осень 2025.

📋 Основная информация:
  • Дата проведения: 15.11.2025
  • Место проведения: Москва, СК "Олимпийский"
  • Пакет: Генеральный спонсор

🎁 Ключевые преимущества:
  • Название соревнования от спонсора
  • Логотип на всех материалах (80% охват)
  • Логотип на футболках участников
  • Призовой фонд 60,000 руб (6 мест Интеры М/Ж)
  • 200+ профессиональных фото
  • 10+ видеороликов
  • Итоговый видеоотчет (5-10 мин)

Полное коммерческое предложение во вложении.

По всем вопросам готовы ответить.

С уважением,
Команда ИКОН
ikong.ru
```

```{note}
**Топ-7 преимуществ**

В письме автоматически включаются первые 7 наиболее важных преимуществ из выбранного пакета. Если преимуществ меньше 7 - показываются все доступные.
```

#### Вложение

К письму прикреплен PDF файл:

- **Имя файла:** `КП_KING_KONG_Осень_2025_СПОРТПИТ_ЦЕНТР.pdf`
- **Размер:** обычно 2-4 MB (зависит от шаблона)
- **Содержимое:** полное коммерческое предложение с дизайном

### Что видит получатель

Спонсор получает:
1. Профессионально оформленное письмо с кратким описанием
2. Топ-7 преимуществ пакета для быстрого ознакомления
3. PDF вложение с полным КП для детального изучения

## Отслеживание отправленных КП

### Автоматическое логирование

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

```
📅 28.10.2025 15:30
✉️ Email отправлен

Шаблон: Генеральный спонсор (AI)
Email: ivan.petrov@sportpit.ru
PDF файл: КП_KING_KONG_Осень_2025_СПОРТПИТ_ЦЕНТР.pdf
Ссылка на preview (внутренняя): https://ikong.ru/sponsors/preview/...
Отправлено через Telegram бот

Автор: Иван Организатор
```

### Обновление статуса лида

Если статус лида был **🆕 Новый**, он автоматически изменится на **✉️ Email отправлен**.

Для других статусов изменение не происходит автоматически.

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

Чтобы посмотреть все отправленные КП лиду:

1. Откройте карточку лида
2. Нажмите **💬 История**
3. Найдите записи с типом "✉️ Email отправлен"

## Особенности AI генерации

### Когда использовать AI

🤖 **Используйте AI когда:**
- Лид впервые получает КП от вас
- Компания имеет специфическую отрасль
- Нужна максимальная персонализация
- Есть уникальные условия или требования

📝 **Используйте стандарт когда:**
- Отправляете повторно (обновленная версия)
- Нужна максимальная скорость
- Шаблон универсальный и не требует адаптации

### Как работает AI

```{admonition} Алгоритм AI генерации
:class: note

1. **Анализ данных лида:**
   - Полное название компании и сокращенное
   - ОКВЭД код и расшифровка (сфера деятельности)
   - Регион регистрации компании
   - Размер компании (если доступно из ЕГРЮЛ)
   - История взаимодействий с компанией

2. **Анализ соревнования:**
   - Название и концепция соревнования
   - Дата и место проведения
   - Ожидаемое количество участников
   - Целевая аудитория
   - Формат (онлайн/оффлайн)

3. **Генерация контента:**
   - Персонализированное приветствие
   - Адаптированное описание преимуществ пакета
   - Релевантные примеры использования брендинга
   - Расчет ROI с учетом отрасли
   - Призыв к действию, учитывающий специфику B2B

4. **Постобработка:**
   - Проверка грамматики и стилистики
   - Форматирование по шаблону дизайна
   - Вставка логотипов и изображений
   - Генерация PDF
```

### Время генерации

- **Стандарт:** 5-8 секунд
- **AI:** 10-15 секунд (зависит от нагрузки на AI сервис)

```{tip}
Если AI генерация занимает более 30 секунд, попробуйте повторить или используйте стандартный шаблон.
```

### Качество AI генерации

AI старается создать максимально релевантное КП, но результат может варьироваться.

**Что делать если результат не устраивает:**
1. Нажмите **🔄 Сгенерировать заново** - AI создаст новую версию
2. Попробуйте другой шаблон
3. Используйте стандартную генерацию
4. Отредактируйте шаблон в веб-интерфейсе

## Советы по отправке КП

### Best Practices

:::{admonition} 💡 Проверяйте preview перед отправкой
:class: tip

Всегда просматривайте КП через "👁️ Посмотреть КП" перед отправкой спонсору. Убедитесь что:
- ✅ Имя контактного лица указано верно
- ✅ Название компании правильное
- ✅ Пакет соответствует интересам лида
- ✅ Цены актуальны
- ✅ Контакты организатора корректны
:::

:::{admonition} 💡 Отправляйте в рабочее время
:class: tip

Оптимальное время отправки КП:
- **Вторник-Четверг** - самые активные дни для B2B
- **10:00-12:00 или 14:00-16:00** - когда люди проверяют почту
- ❌ Избегайте понедельников (завал после выходных) и пятниц (низкая активность)
:::

:::{admonition} 💡 Персонализируйте first contact
:class: tip

Перед отправкой КП:
1. Позвоните лиду и представьтесь
2. Узнайте кто принимает решения по спонсорству
3. Спросите какой пакет может быть интересен
4. Отправьте КП в течение часа после звонка
5. Добавьте все детали в заметки лида
:::

:::{admonition} 💡 Следите за активностью
:class: tip

После отправки:
- Добавьте задачу "Связаться через 2-3 дня"
- Отслеживайте открытие email (если настроен tracking)
- Будьте готовы оперативно ответить на вопросы
:::

:::{admonition} 💡 Используйте правильный пакет
:class: tip

Убедитесь что выбранный пакет соответствует:
- Бюджету компании (проверьте размер компании)
- Целям лида (усиление бренда vs продажи)
- Региону (федеральный vs региональный охват)
:::

### Частые ошибки

:::{admonition} ❌ Массовая рассылка без персонализации
:class: warning

Не отправляйте одно и то же КП всем лидам. Используйте AI генерацию или минимум проверяйте что пакет релевантен.
:::

:::{admonition} ❌ Отправка без предварительного контакта
:class: warning

"Холодные" КП имеют низкую конверсию. Сначала установите контакт (звонок, встреча), затем отправляйте КП.
:::

:::{admonition} ❌ Забывать добавлять активности
:class: warning

Всегда логируйте когда отправили КП. Это поможет вам и команде отслеживать историю.
:::

:::{admonition} ❌ Не следить за статусами
:class: warning

После отправки КП обновите статус на "📞 Контактирован" или "💬 Переговоры" после следующего контакта. Не оставляйте лида в статусе "✉️ Email отправлен" навсегда.
:::

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

### Отправка разных пакетов

Если лид интересуется несколькими пакетами:

1. Создайте КП для первого пакета
2. Отправьте на email
3. Вернитесь к лиду (кнопка **🔙 К лиду**)
4. Снова нажмите **📄 Создать КП**
5. Выберите другой шаблон
6. Отправьте на тот же или другой email

Все отправки будут залогированы в истории лида.

### Повторная отправка

Если нужно отправить КП повторно (например, после корректировок):

1. Создайте новое КП (обновленные данные)
2. В комментарии к отправке укажите что это обновленная версия
3. Добавьте заметку в активности лида:
   ```
   Отправлена обновленная версия КП с учетом обсуждения от 25.10
   ```

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

### Что если email не отправляется?

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

Если проблема сохраняется:
- Попробуйте скачать PDF и отправить вручную
- Обратитесь в поддержку ikong.ru

### Можно ли редактировать КП перед отправкой?

Нет, редактирование КП через бота недоступно.

Если нужны изменения:
1. Измените шаблон в веб-интерфейсе (CRM → Шаблоны)
2. Сгенерируйте КП заново
3. Или используйте другой шаблон

### Как узнать что спонсор получил и открыл КП?

Email tracking пока в разработке. Сейчас вы можете:
- Позвонить лиду через 2-3 дня после отправки
- Спросить "Получили ли КП?" и "Есть ли вопросы?"
- Добавить активность с результатом звонка

### Сколько раз можно отправить КП одному лиду?

Неограниченно, но рекомендуем:
- **1-2 раза** для первого контакта
- **3-4 раза** если есть корректировки условий
- Избегайте спама - не отправляйте чаще 1 раза в неделю без запроса лида

### Что если лид в другом городе?

Не проблема! Email доставляется мгновенно в любую точку мира.

Учитывайте:
- Часовой пояс получателя (не отправляйте ночью)
- Региональные особенности (федеральные vs местные пакеты)
- Логистику мероприятия (транспортные расходы)

### Preview ссылка перестала работать

Preview ссылки действуют только 24 часа. После этого:
- Просмотр через браузер недоступен
- PDF остается в истории активностей
- Можно сгенерировать новое КП

Для долгосрочного хранения:
- Скачайте PDF в Telegram
- Сохраните локально или в облаке
- Или используйте веб-интерфейс (там КП хранятся бессрочно)

---

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