---
title: "Изменить настройки CRM кабинета"
method: PATCH
path: "/api/v1/crm/settings"
tags: ["CRM leads"]
---

# Изменить настройки CRM кабинета

`PATCH /api/v1/crm/settings`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/settings`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Поле, которого нет в запросе, не меняется. Режим вне owner_only и after_qualification отклоняется кодом crm.lead_lock_mode_invalid.

## Headers

- `X-Tenant` string, required

## Request body

- CRMSettingsPatch
  - `lead_lock_mode` 'owner_only' | 'after_qualification': owner_only - лид с самого начала виден только владельцу (умолчание); after_qualification - новый лид видят все, у кого есть доступ к CRM, после квалификации он закрепляется за владельцем. Роль с правом all видит все лиды в любом режиме
  - `mail_intake` CRMMailIntake: Лиды и клиенты из писем: письмо с нового адреса в выбранных ящиках модуля «Почта» заводит клиента и лид или только карточку клиента; письмо известного клиента ложится в его открытую сделку или лид. При включении разбираются и письма, уже лежащие в ящике, за выбранный срок. Письма читаются от имени того, кто включил настройку
    - `enabled` boolean: Разбирать письма
    - `mode` 'lead' | 'customer': Что создаёт письмо с нового адреса: lead - клиента и лид, customer - только карточку клиента
    - `account_ids` UUID[]: Почтовые ящики, из которых берутся письма; при включении нужен хотя бы один
    - `history` 'week' | 'month' | 'all' | 'none': За какой срок разобрать письма, уже лежащие в ящике, при включении: week - неделя, month - месяц, all - всё время, none - не разбирать старые, только новые
    - `owner_id` integer: Ответственный; нет — владелец личного ящика, у общего ящика — тот, кто включил настройку
    - `calendar` boolean: Ставить ответственному дело «Ответить клиенту» в календарь
    - `due_minutes` 15 | 30 | 60 | 120 | 240 | 1440: Через сколько минут срок дела
    - `enabled_by` integer: Кто включил настройку; задаёт сервер
    - `since` string, date-time: Письма раньше этой отметки не разбираются; задаёт сервер при включении по сроку history
    - `line_id` string, uuid: Линия обращений почты: ответственного даёт её очередь, письма в нерабочее время ждут начала рабочего дня, автоответ письмом — по её настройке; нет — без линии
  - `mail_line_id` string: Перенести почту в линию обращений, не меняя остальную настройку писем и того, от чьего имени читается почта; пустая строка — почта без линии. Не передаётся вместе с mail_intake

## Response `200`

Настройки после изменения

- CRMSettings
  - `lead_lock_mode` 'owner_only' | 'after_qualification', required: owner_only - лид с самого начала виден только владельцу (умолчание); after_qualification - новый лид видят все, у кого есть доступ к CRM, после квалификации он закрепляется за владельцем. Роль с правом all видит все лиды в любом режиме
  - `mail_intake` CRMMailIntake: Лиды и клиенты из писем: письмо с нового адреса в выбранных ящиках модуля «Почта» заводит клиента и лид или только карточку клиента; письмо известного клиента ложится в его открытую сделку или лид. При включении разбираются и письма, уже лежащие в ящике, за выбранный срок. Письма читаются от имени того, кто включил настройку
    - `enabled` boolean: Разбирать письма
    - `mode` 'lead' | 'customer': Что создаёт письмо с нового адреса: lead - клиента и лид, customer - только карточку клиента
    - `account_ids` UUID[]: Почтовые ящики, из которых берутся письма; при включении нужен хотя бы один
    - `history` 'week' | 'month' | 'all' | 'none': За какой срок разобрать письма, уже лежащие в ящике, при включении: week - неделя, month - месяц, all - всё время, none - не разбирать старые, только новые
    - `owner_id` integer: Ответственный; нет — владелец личного ящика, у общего ящика — тот, кто включил настройку
    - `calendar` boolean: Ставить ответственному дело «Ответить клиенту» в календарь
    - `due_minutes` 15 | 30 | 60 | 120 | 240 | 1440: Через сколько минут срок дела
    - `enabled_by` integer: Кто включил настройку; задаёт сервер
    - `since` string, date-time: Письма раньше этой отметки не разбираются; задаёт сервер при включении по сроку history
    - `line_id` string, uuid: Линия обращений почты: ответственного даёт её очередь, письма в нерабочее время ждут начала рабочего дня, автоответ письмом — по её настройке; нет — без линии
  - `updated_at` string, date-time: Нет, пока кабинет не менял настройки

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)