# Конфигурируемые дела

Конфигурируемое дело — запись в таймлайне CRM-сущности с собственным оформлением: иконкой, заголовком, блоками тела и кнопками. Внешний вид задаёт структура `layout`. Подходит для интеграций, которые показывают в таймлайне сделки, лида, контакта или компании карточку звонка, заявки, доставки или другого внешнего события.

Раздел содержит только создание, чтение и обновление. Удаление и список — через общий API дел: [`DELETE /v1/activities/:id`](/docs/entities/activities) и [`GET /v1/activities`](/docs/entities/activities).

Битрикс24 API: `crm.activity.configurable.*`
Скоуп: `crm`

## Операции

- [Создать дело](./configurable/create.md) — `POST /v1/activity-configurable`
- [Получить дело](./configurable/get.md) — `GET /v1/activity-configurable/:id`
- [Обновить дело](./configurable/update.md) — `PATCH /v1/activity-configurable/:id`

## Когда использовать

- Звонок из внешней телефонии показывается в таймлайне сделки карточкой с кнопкой действия.
- Заявка из внешнего сервиса отображается с действиями «Подтвердить» и «Отклонить».
- Доставка или внешнее событие появляется в карточке лида с собственной иконкой и ссылкой.

## Требования к OAuth-приложению

Методы работают только в контексте приложения: нужен ключ авторизации `vibe_app_*` с токеном сессии в заголовке `Authorization: Bearer`. Персональный API-ключ `vibe_api_*` Битрикс24 отклоняет с `ERROR_WRONG_CONTEXT`. Изменить дело может только то приложение, которое его создало.

Пользовательские типы дел `crm.activity.type.*` регистрируются в Битрикс24 — отдельного эндпоинта в API Вайбкод для них нет. Без своего типа дело создаётся с типом `CONFIGURABLE`.

## Смотрите также

- [Дела](/docs/entities/activities)
- [Привязки дел](/docs/entities/activities/bindings)
- [Лог таймлайна](/docs/timeline-logs)
- [Ключи и авторизация](/docs/keys-auth)