Email AI-CRM — гайд розробника

Налаштування модуля на локальному або self-hosted клоні Ring: .env.local, міграції (за потреби), перевірка ingest і відправки чернетки з адмін UI.

EN canonical: повний troubleshooting і webhook — Email AI-CRM developer guide (EN)

1. Локальне середовище

Блок EMAIL CRM з env.local.template → .env.local:

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

2. Міграції

bash


psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql

Приберіть EMAIL_CRM_PERSISTENCE=memory, якщо потрібна персистентність у Postgres.

3. Ingest (локально)

bash


curl -sS -X POST "http://localhost:3000/api/cron/email-processor" \
  -H "Authorization: Bearer $CRON_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"poll"}'

4. SMTP smoke test

Тест на IMAP_USER.
poll.
Admin → Email Inbox → Email Drafts → approve → send.
Після успіху: EMAIL_AUTO_SEND_ENABLED=true.

5. Продакшн cron

bash


curl -sS -X POST "$BASE_URL/api/cron/email-processor" \
  -H "Authorization: Bearer ${CRON_SECRET}" \
  -d '{"action":"poll"}'

Усунення несправностей

Симптом	Перевірка
Порожній inbox	Міграції або `memory`? `ANTHROPIC_API_KEY`?
401 на cron	`CRON_SECRET` у Bearer
Send fails	`SMTP_*`, порт 587

Пов’язане

Email AI-CRM — гайд розробника

EN canonical: повний troubleshooting і webhook — Email AI-CRM developer guide (EN)

1. Локальне середовище

Блок EMAIL CRM з env.local.template → .env.local:

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

2. Міграції

bash


psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql

Приберіть EMAIL_CRM_PERSISTENCE=memory, якщо потрібна персистентність у Postgres.

3. Ingest (локально)

bash


curl -sS -X POST "http://localhost:3000/api/cron/email-processor" \
  -H "Authorization: Bearer $CRON_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"poll"}'

4. SMTP smoke test

Тест на IMAP_USER.
poll.
Admin → Email Inbox → Email Drafts → approve → send.
Після успіху: EMAIL_AUTO_SEND_ENABLED=true.

5. Продакшн cron

bash


curl -sS -X POST "$BASE_URL/api/cron/email-processor" \
  -H "Authorization: Bearer ${CRON_SECRET}" \
  -d '{"action":"poll"}'

Усунення несправностей

Симптом	Перевірка
Порожній inbox	Міграції або `memory`? `ANTHROPIC_API_KEY`?
401 на cron	`CRON_SECRET` у Bearer
Send fails	`SMTP_*`, порт 587

Пов’язане

Email AI-CRM — гайд розробника

EN canonical: повний troubleshooting і webhook — Email AI-CRM developer guide (EN)

1. Локальне середовище

Блок EMAIL CRM з env.local.template → .env.local:

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

2. Міграції

bash


psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql

Приберіть EMAIL_CRM_PERSISTENCE=memory, якщо потрібна персистентність у Postgres.

3. Ingest (локально)

bash


curl -sS -X POST "http://localhost:3000/api/cron/email-processor" \
  -H "Authorization: Bearer $CRON_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"poll"}'

4. SMTP smoke test

Тест на IMAP_USER.
poll.
Admin → Email Inbox → Email Drafts → approve → send.
Після успіху: EMAIL_AUTO_SEND_ENABLED=true.

5. Продакшн cron

bash


curl -sS -X POST "$BASE_URL/api/cron/email-processor" \
  -H "Authorization: Bearer ${CRON_SECRET}" \
  -d '{"action":"poll"}'

Усунення несправностей

Симптом	Перевірка
Порожній inbox	Міграції або `memory`? `ANTHROPIC_API_KEY`?
401 на cron	`CRON_SECRET` у Bearer
Send fails	`SMTP_*`, порт 587

Documentation

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

Documentation

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

Documentation

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

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

Documentation

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

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

Documentation

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

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

Documentation

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

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

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

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

Email AI-CRM — гайд розробника

1. Локальне середовище

2. Міграції

3. Ingest (локально)

4. SMTP smoke test

5. Продакшн cron

Усунення несправностей

Пов’язане

Email AI-CRM — гайд розробника

1. Локальне середовище

2. Міграції

3. Ingest (локально)

4. SMTP smoke test

5. Продакшн cron

Усунення несправностей

Пов’язане

Email AI-CRM — гайд розробника

1. Локальне середовище

2. Міграції

3. Ingest (локально)

4. SMTP smoke test

5. Продакшн cron

Усунення несправностей

Пов’язане