Email AI-CRM

AI-керований CRM для публічних поштових скриньок (наприклад info@example.com). Вхідна пошта класифікується, збирається в треди; Claude формує чернетки відповідей; адміни затверджують відправку та бачать витрати API.

EN canonical: повні діаграми, таблиці API та runbook — Email AI-CRM (EN) · Архітектура · API · Гайд розробника

Огляд

Шар	Відповідальність
Збір	Cron `POST /api/cron/email-processor` (`action: poll`) або webhook
Процесор	`services/email/email-processor.ts` — parse, security, AI, CRM
Зберігання	PostgreSQL JSONB: `email_threads`, `email_contacts`, `email_messages`, `email_drafts`, `email_tasks`, `email_api_usage`
Вихід	`EmailSenderService` (nodemailer), `In-Reply-To` / `References`
Адмін UI	inbox, drafts, contacts, analytics, tasks

Бізнес-правила

Дедуп Message-ID — один RFC Message-ID не обробляється двічі.
Auto-send вимкнено — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
Cron poll у продакшні — кожні 1–5 хв; IDLE лише для довгоживучого Node (EMAIL_PROCESSOR_AUTOSTART).
Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

Шлях адміна

Маршрути адмін UI

Маршрут	Призначення
`/{locale}/admin/crm/inbox`	Список тредів
`/{locale}/admin/crm/inbox/[id]`	Деталі треду + повідомлення
`/{locale}/admin/crm/drafts`	Чернетки AI — approve / reject / send
`/{locale}/admin/crm/contacts`	CRM-контакти
`/{locale}/admin/crm/analytics`	Обсяг, intent/sentiment, вартість API
`/{locale}/admin/crm/tasks`	Follow-up та ескалації

Пайплайн

Parse → 2. 4-шаровий security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Черга чернеток → 6. Сповіщення (in-app / Slack).

База даних

Міграція	Таблиці
`009_email_crm_jsonb.sql`	`email_threads`, `email_contacts`, `email_messages`, `email_drafts`
`010_email_crm_tasks_jsonb.sql`	`email_tasks`, `email_api_usage`

Локальна конфігурація

Додайте в .env.local (див. env.local.template, блок EMAIL CRM):

Змінна	Опис
`IMAP_` / `SMTP_`	Ваш community inbox (будь-який IMAP/SMTP)
`ANTHROPIC_API_KEY`	Intent, sentiment, генерація чернеток
`CRON_SECRET`	Bearer для `/api/cron/email-processor`
`EMAIL_AUTO_SEND_ENABLED`	`false` до SMTP smoke test
`EMAIL_CRM_PERSISTENCE`	`memory` для швидкого dev; omit + міграції `009`/`010` для Postgres

Продакшн

Ті самі змінні — у secret store (k8s/Vercel). Міграції 009+010, cron poll кожні 1–5 хв. Див. гайд розробника.

Пов’язане

Email AI-CRM

EN canonical: повні діаграми, таблиці API та runbook — Email AI-CRM (EN) · Архітектура · API · Гайд розробника

Огляд

Шар	Відповідальність
Збір	Cron `POST /api/cron/email-processor` (`action: poll`) або webhook
Процесор	`services/email/email-processor.ts` — parse, security, AI, CRM
Зберігання	PostgreSQL JSONB: `email_threads`, `email_contacts`, `email_messages`, `email_drafts`, `email_tasks`, `email_api_usage`
Вихід	`EmailSenderService` (nodemailer), `In-Reply-To` / `References`
Адмін UI	inbox, drafts, contacts, analytics, tasks

Бізнес-правила

Дедуп Message-ID — один RFC Message-ID не обробляється двічі.
Auto-send вимкнено — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
Cron poll у продакшні — кожні 1–5 хв; IDLE лише для довгоживучого Node (EMAIL_PROCESSOR_AUTOSTART).
Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

Шлях адміна

Маршрути адмін UI

Маршрут	Призначення
`/{locale}/admin/crm/inbox`	Список тредів
`/{locale}/admin/crm/inbox/[id]`	Деталі треду + повідомлення
`/{locale}/admin/crm/drafts`	Чернетки AI — approve / reject / send
`/{locale}/admin/crm/contacts`	CRM-контакти
`/{locale}/admin/crm/analytics`	Обсяг, intent/sentiment, вартість API
`/{locale}/admin/crm/tasks`	Follow-up та ескалації

Пайплайн

Parse → 2. 4-шаровий security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Черга чернеток → 6. Сповіщення (in-app / Slack).

База даних

Міграція	Таблиці
`009_email_crm_jsonb.sql`	`email_threads`, `email_contacts`, `email_messages`, `email_drafts`
`010_email_crm_tasks_jsonb.sql`	`email_tasks`, `email_api_usage`

Локальна конфігурація

Додайте в .env.local (див. env.local.template, блок EMAIL CRM):

Змінна	Опис
`IMAP_` / `SMTP_`	Ваш community inbox (будь-який IMAP/SMTP)
`ANTHROPIC_API_KEY`	Intent, sentiment, генерація чернеток
`CRON_SECRET`	Bearer для `/api/cron/email-processor`
`EMAIL_AUTO_SEND_ENABLED`	`false` до SMTP smoke test
`EMAIL_CRM_PERSISTENCE`	`memory` для швидкого dev; omit + міграції `009`/`010` для Postgres

Продакшн

Ті самі змінні — у secret store (k8s/Vercel). Міграції 009+010, cron poll кожні 1–5 хв. Див. гайд розробника.

Пов’язане

Email AI-CRM

EN canonical: повні діаграми, таблиці API та runbook — Email AI-CRM (EN) · Архітектура · API · Гайд розробника

Огляд

Шар	Відповідальність
Збір	Cron `POST /api/cron/email-processor` (`action: poll`) або webhook
Процесор	`services/email/email-processor.ts` — parse, security, AI, CRM
Зберігання	PostgreSQL JSONB: `email_threads`, `email_contacts`, `email_messages`, `email_drafts`, `email_tasks`, `email_api_usage`
Вихід	`EmailSenderService` (nodemailer), `In-Reply-To` / `References`
Адмін UI	inbox, drafts, contacts, analytics, tasks

Бізнес-правила

Дедуп Message-ID — один RFC Message-ID не обробляється двічі.
Auto-send вимкнено — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
Cron poll у продакшні — кожні 1–5 хв; IDLE лише для довгоживучого Node (EMAIL_PROCESSOR_AUTOSTART).
Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

Шлях адміна

Маршрути адмін UI

Маршрут	Призначення
`/{locale}/admin/crm/inbox`	Список тредів
`/{locale}/admin/crm/inbox/[id]`	Деталі треду + повідомлення
`/{locale}/admin/crm/drafts`	Чернетки AI — approve / reject / send
`/{locale}/admin/crm/contacts`	CRM-контакти
`/{locale}/admin/crm/analytics`	Обсяг, intent/sentiment, вартість API
`/{locale}/admin/crm/tasks`	Follow-up та ескалації

Пайплайн

Parse → 2. 4-шаровий security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Черга чернеток → 6. Сповіщення (in-app / Slack).

База даних

Міграція	Таблиці
`009_email_crm_jsonb.sql`	`email_threads`, `email_contacts`, `email_messages`, `email_drafts`
`010_email_crm_tasks_jsonb.sql`	`email_tasks`, `email_api_usage`

Локальна конфігурація

Додайте в .env.local (див. env.local.template, блок EMAIL CRM):

Змінна	Опис
`IMAP_` / `SMTP_`	Ваш community inbox (будь-який IMAP/SMTP)
`ANTHROPIC_API_KEY`	Intent, sentiment, генерація чернеток
`CRON_SECRET`	Bearer для `/api/cron/email-processor`
`EMAIL_AUTO_SEND_ENABLED`	`false` до SMTP smoke test
`EMAIL_CRM_PERSISTENCE`	`memory` для швидкого dev; omit + міграції `009`/`010` для Postgres

Продакшн

Ті самі змінні — у secret store (k8s/Vercel). Міграції 009+010, cron poll кожні 1–5 хв. Див. гайд розробника.

Пов’язане

bash


# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory

bash


# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory

bash


# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Завантаження документації...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Завантаження документації...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Завантаження документації...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Завантаження документації...

Завантаження документації...

Завантаження документації...

Email AI-CRM

Огляд

Бізнес-правила

Шлях адміна

Маршрути адмін UI

Пайплайн

База даних

Локальна конфігурація

Продакшн

Пов’язане

Email AI-CRM

Огляд

Бізнес-правила

Шлях адміна

Маршрути адмін UI

Пайплайн

База даних

Локальна конфігурація

Продакшн

Пов’язане

Email AI-CRM

Огляд

Бізнес-правила

Шлях адміна

Маршрути адмін UI

Пайплайн

База даних

Локальна конфігурація

Продакшн

Пов’язане