# 09 — n8n и автоматизация

# n8n — автоматизация ITG

## Назначение
Связать сайт, CRM, аналитику, электронную почту и уведомления в воспроизводимые процессы.

## Приоритетные сценарии
### 1. Заявка с сайта → Twenty CRM
- Получить заявку из формы.
- Проверить обязательные поля.
- Найти существующую компанию/контакт.
- Создать или обновить запись в CRM.
- Создать задачу follow-up.
- Записать идентификатор события и статус обработки.

### 2. Экспресс-аудит сайта
- Получить URL и контактные данные.
- Проверить валидность URL и разрешённые адреса.
- Запустить разрешённые проверки производительности и SEO.
- Сформировать отчёт.
- Отправить клиенту и сохранить ссылку в CRM.

### 3. Уведомления
- Ошибка автоматизации.
- Новая заявка.
- Просроченный follow-up.
- Изменение статуса интеграции.

## Стандарт workflow
- Уникальный ID события и идемпотентность.
- Таймауты, ретраи и обработка ошибок.
- Секреты только в credentials/хранилище секретов.
- Отдельные тестовые данные.
- Наблюдаемость: журнал выполнения и алерты.
- Явные критерии успешного завершения.

## Фактический инвентарь на 11.10.2026
Через n8n MCP доступно **15 workflow**, из них **3 активных**:
- `itgC8Digest20261007` — IT GROUP — Daily Follow-up digest.
- `itgC7901e7a356f6` — IT GROUP — Twenty opportunity events.
- `puOTAOvlbzAiH0ze` — ITG — BookStack health and quality gate.

Автоматизация аудита сайтов представлена отдельными **неактивными** ручными сценариями: intake (`acvtlYyojy35oxdg`), просмотр очереди (`BIPJOHreI2sCqGPb`), проверка URL (`TnGks4RmPM2KCkVA`), классификатор событий (`q2jEfj4lgS5lBSyy`). Их описания явно ограничивают сетевые вызовы и запись в CRM; полноценный производственный процесс экспресс-аудита этим не подтверждён. Активный контроль BookStack имел ошибку DNS при запуске по расписанию 11.10.2026; детали в [регламенте контроля качества](https://wiki.karpiev.ru/books/itg-baza-znanii/page/20-kontrol-kacestva-i-aktualizaciia).

## Дальнейшая работа
- Актуализировать инвентарь workflows при изменениях.
- Описать webhook-адреса и контракт входных данных без секретов.
- Настроить тестовые сценарии и оповещения.
- Связать статусы выполнения с CRM.

**Статус:** проектная документация, а не подтверждение фактического развёртывания каждого сценария.