Завантаження документації...
Підготовка контенту платформи 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"}'