﻿---
title: Управление лидами
description: "Сервис на Laravel + Filament: приём и распределение лидов, оценка, контроль сроков первого контакта, источники и отчёт для маркетинга."
---

## Что это за сервис

Рабочее место для менеджеров, которые обрабатывают входящие заявки, их руководителя и маркетинга. Сервис принимает лиды из всех источников, сразу назначает ответственного и следит, чтобы ни одна заявка не осталась без ответа.

Без такого сервиса заявки падают в общий ящик и часами ждут, пока их кто-нибудь возьмёт. Менеджеры выбирают крупных клиентов, а остальные заявки остаются без первого контакта. Маркетинг не может связать расходы на кампании с продажами, потому что источник теряется между формой на сайте, почтой и CRM. Оценка лидов ведётся в таблице раз в неделю, а руководитель узнаёт о пропущенной заявке, когда клиент уже жалуется или ушёл к конкуренту.

Первая версия сервиса — приём заявок из формы и импорта, автоматическое назначение ответственного и контроль срока первого контакта. Оценку лидов и отчёт для маркетинга добавляют вторым шагом, когда в базе накопится история заявок и станет понятно, какие признаки действительно отличают перспективных клиентов.

## Что он делает

- **Распределяет лиды сразу.** Каждая заявка сразу получает ответственного по правилам: по территории, загрузке менеджера или по очереди.
- **Оценивает лиды.** Расчётная оценка по размеру компании, источнику и активности поднимает наверх самые перспективные заявки.
- **Сохраняет источник.** Источник и кампания идут с лидом от формы до сделки, и маркетинг видит, какие каналы приносят продажи.
- **Контролирует сроки ответа.** Если за заданное время контакт не зафиксирован, лид отмечается просроченным, передаётся другому менеджеру или уходит в прогрев.
- **Показывает работу команды.** Руководитель видит время первого ответа, конверсию по менеджерам и заявки без контакта.

## Нюансы и особенности

- **У каждого лида есть владелец.** Без правил распределения общий ящик возвращается. Правила — это настройки, их меняет руководитель без правки кода, а ручное переназначение журналируется.
- **Оценка устаревает.** Если клиент две недели не проявляет активности, оценка снижается автоматически, иначе старые заявки занимают верх списка. Начинают с двух-трёх понятных сигналов и уточняют по результатам.
- **Источник обязателен.** Поле источника заполняется при создании лида, UTM-метки из форм проверяются. Пустой источник ломает всю аналитику маркетинга.
- **Контакты — в общем журнале.** Звонки и письма фиксируются в журнале активности, а не в личных заметках, чтобы коллега, подменяющий менеджера, видел всю историю.
- **Несколько статусов до квалификации.** Один статус «новый» не показывает, где заявки застревают. Минимум — «Новый», «Связались», «Прогрев».
- **Дубли склеивают.** Совпадение по почте или домену компании не создаёт новую запись, а добавляет историю к существующему лиду.
- **Доступ по ролям на сервере.** Менеджер видит свои лиды, руководитель — всю команду, маркетинг — источники и конверсию без контактов и заметок менеджеров.
- **Когда хватит готового продукта.** Если поток заявок небольшой и стандартная CRM уже распределяет лиды и считает источники, отдельный сервис не нужен. Он оправдан при собственных правилах распределения или множестве нестандартных источников.

## Как сгенерировать через ИИ-агентов

Промпты рассчитаны на AI-агента (Claude Code, Cursor и аналоги) в Laravel-проекте с установленным **Filament 4.x**. Отправляйте их по одному и проверяйте результат каждого шага.

### 1. Данные и модели

```text
Создай модели и миграции для управления лидами: Lead (имя, компания,
почта, домен, источник, кампания, UTM-метки, статус, оценка, ответственный,
время создания, время первого контакта), LeadActivity (лид, автор, тип,
результат, дата), AssignmentRule (тип: территория, загрузка, очередь;
условия, порядок, активность). Статусы: Новый, Связались, Прогрев,
Квалифицирован, Отклонён. Источник обязателен. Добавь фабрики.
```

### 2. Приём и склейка дублей

```text
Сделай приём лидов из формы на сайте через отдельный маршрут и импорт
из CSV в Filament. Проверяй UTM-метки, ищи дубль по почте и домену
компании: при совпадении добавляй активность к существующему лиду вместо
новой записи. Сразу после создания назначай ответственного по правилам.
```

Проверьте, что повторная отправка формы с той же почтой не создаёт второй лид.

### 3. Рабочее место менеджера

```text
Сгенерируй Filament-ресурс для Lead: таблица с оценкой, статусом, временем
с момента создания и отметкой просрочки; вкладки по статусам; фильтры
по источнику, кампании и ответственному; действия «Зафиксировать контакт»,
«Перевести в прогрев», «Переназначить». В карточке — журнал активности.
```

### 4. Сроки ответа и снижение оценки

```text
Добавь фоновую задачу по расписанию: лиды без контакта дольше порога
из конфига отмечать просроченными и уведомлять руководителя; после
второго порога переназначать по правилам. Снижай оценку лидов без
активности больше 14 дней. Все изменения пиши в журнал.
```

### 5. Роли и отчёты

```text
Настрой доступ: менеджер видит свои лиды, руководитель — команду,
маркетинг — только отчёт по источникам и кампаниям без контактов
и заметок. Добавь виджеты времени первого ответа и конверсии по менеджерам
и источникам и экспорт отчёта для маркетинга.
```

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

## Похожие сценарии

- [Дашборд воронки продаж](https://wpcraft.ru/kb/stacks/filament/use-cases/sales/pipeline-dashboard.md) — что происходит с лидом после квалификации.
- [Отслеживание цепочек касаний](https://wpcraft.ru/kb/stacks/filament/use-cases/sales/outbound-sequence-tracker.md) — прогрев лидов серией писем и звонков.
- [Атрибуция лидов](https://wpcraft.ru/kb/stacks/filament/use-cases/marketing/lead-attribution-dashboard.md) — детальная аналитика источников на стороне маркетинга.

## Материалы и источники

- [Refine: Lead Management Dashboard](https://refine.dev/use-cases/sales/lead-management/)
- [Filament 4.x: ресурсы](https://filamentphp.com/docs/4.x/resources/overview)
- [Filament 4.x: импорт](https://filamentphp.com/docs/4.x/actions/import)
- [Filament 4.x: фильтры таблиц](https://filamentphp.com/docs/4.x/tables/filters/overview)