Завантаження документації...
Підготовка контенту платформи Ring
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
EN canonical: полные тела запросов, примеры curl и JSON webhook — Email AI-CRM API (EN)
Все /api/admin/email/* требуют сессии platform admin (admin или superadmin).
/api/cron/* и /api/webhooks/email/inbound — CRON_SECRET или WEBHOOK_EMAIL_SECRET, не user session.
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/threads | Список тредов; query status |
PATCH | /api/admin/email/threads | { id, status } |
GET | /api/admin/email/threads/[id] | Тред + messages + drafts + tasks |
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/drafts | status: pending |
POST | /api/admin/email/drafts/[id]/approve | Утвердить |
POST | /api/admin/email/drafts/[id]/reject | { reason? } |
POST | /api/admin/email/drafts/[id]/send | SMTP; опционально toEmail, subject |
| Метод | Путь | Описание |
|---|---|---|
GET / POST | /api/admin/email/contacts | Поиск / создание контакта |
GET / POST | /api/admin/email/tasks | Список / создание задачи |
POST | /api/admin/email/tasks/[id]/complete | { completionNotes? } |
GET | /api/admin/email/analytics | Query range: 7d, 30d, 90d |
POST или GET /api/cron/email-processorAuth: Authorization: Bearer $CRON_SECRET
action | Поведение |
|---|---|
poll (default) | pollInboundBatch() — UNSEEN → process → disconnect |
status | Статистика процессора + IMAP |
stop | Остановить IDLE |
start | IDLE (нужен EMAIL_PROCESSOR_ALLOW_HTTP_START=true) |
mark-overdue-tasks | Просроченные задачи |
GET /api/cron/email-analytics7-дневный снимок дашборда (как admin analytics).
POST /api/webhooks/email/inboundAuth: Bearer $WEBHOOK_EMAIL_SECRET или HMAC-SHA256 в X-Email-Webhook-Signature.
Минимальные поля: messageId, from, subject, bodyText. Вызывает EmailProcessor.ingestEvent() с uid: 0.
EN canonical: полные тела запросов, примеры curl и JSON webhook — Email AI-CRM API (EN)
Все /api/admin/email/* требуют сессии platform admin (admin или superadmin).
/api/cron/* и /api/webhooks/email/inbound — CRON_SECRET или WEBHOOK_EMAIL_SECRET, не user session.
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/threads | Список тредов; query status |
PATCH | /api/admin/email/threads | { id, status } |
GET | /api/admin/email/threads/[id] | Тред + messages + drafts + tasks |
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/drafts | status: pending |
POST | /api/admin/email/drafts/[id]/approve | Утвердить |
POST | /api/admin/email/drafts/[id]/reject | { reason? } |
POST | /api/admin/email/drafts/[id]/send | SMTP; опционально toEmail, subject |
| Метод | Путь | Описание |
|---|---|---|
GET / POST | /api/admin/email/contacts | Поиск / создание контакта |
GET / POST | /api/admin/email/tasks | Список / создание задачи |
POST | /api/admin/email/tasks/[id]/complete | { completionNotes? } |
GET | /api/admin/email/analytics | Query range: 7d, 30d, 90d |
POST или GET /api/cron/email-processorAuth: Authorization: Bearer $CRON_SECRET
action | Поведение |
|---|---|
poll (default) | pollInboundBatch() — UNSEEN → process → disconnect |
status | Статистика процессора + IMAP |
stop | Остановить IDLE |
start | IDLE (нужен EMAIL_PROCESSOR_ALLOW_HTTP_START=true) |
mark-overdue-tasks | Просроченные задачи |
GET /api/cron/email-analytics7-дневный снимок дашборда (как admin analytics).
POST /api/webhooks/email/inboundAuth: Bearer $WEBHOOK_EMAIL_SECRET или HMAC-SHA256 в X-Email-Webhook-Signature.
Минимальные поля: messageId, from, subject, bodyText. Вызывает EmailProcessor.ingestEvent() с uid: 0.
EN canonical: полные тела запросов, примеры curl и JSON webhook — Email AI-CRM API (EN)
Все /api/admin/email/* требуют сессии platform admin (admin или superadmin).
/api/cron/* и /api/webhooks/email/inbound — CRON_SECRET или WEBHOOK_EMAIL_SECRET, не user session.
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/threads | Список тредов; query status |
PATCH | /api/admin/email/threads | { id, status } |
GET | /api/admin/email/threads/[id] | Тред + messages + drafts + tasks |
| Метод | Путь | Описание |
|---|---|---|
GET | /api/admin/email/drafts | status: pending |
POST | /api/admin/email/drafts/[id]/approve | Утвердить |
POST | /api/admin/email/drafts/[id]/reject | { reason? } |
POST | /api/admin/email/drafts/[id]/send | SMTP; опционально toEmail, subject |
| Метод | Путь | Описание |
|---|---|---|
GET / POST | /api/admin/email/contacts | Поиск / создание контакта |
GET / POST | /api/admin/email/tasks | Список / создание задачи |
POST | /api/admin/email/tasks/[id]/complete | { completionNotes? } |
GET | /api/admin/email/analytics | Query range: 7d, 30d, 90d |
POST или GET /api/cron/email-processorAuth: Authorization: Bearer $CRON_SECRET
action | Поведение |
|---|---|
poll (default) | pollInboundBatch() — UNSEEN → process → disconnect |
status | Статистика процессора + IMAP |
stop | Остановить IDLE |
start | IDLE (нужен EMAIL_PROCESSOR_ALLOW_HTTP_START=true) |
mark-overdue-tasks | Просроченные задачи |
GET /api/cron/email-analytics7-дневный снимок дашборда (как admin analytics).
POST /api/webhooks/email/inboundAuth: Bearer $WEBHOOK_EMAIL_SECRET или HMAC-SHA256 в X-Email-Webhook-Signature.
Минимальные поля: messageId, from, subject, bodyText. Вызывает EmailProcessor.ingestEvent() с uid: 0.
curl -X POST "$BASE_URL/api/cron/email-processor" \
-H "Authorization: Bearer $CRON_SECRET" \
-H "Content-Type: application/json" \
-d '{"action":"poll"}'
curl -X POST "$BASE_URL/api/cron/email-processor" \
-H "Authorization: Bearer $CRON_SECRET" \
-H "Content-Type: application/json" \
-d '{"action":"poll"}'
curl -X POST "$BASE_URL/api/cron/email-processor" \
-H "Authorization: Bearer $CRON_SECRET" \
-H "Content-Type: application/json" \
-d '{"action":"poll"}'