# Привязки

Связывание одной лог-записи с несколькими CRM-сущностями. Помимо родительской сущности (указанной при создании), запись можно дополнительно привязать к другим записям CRM — она появится в их таймлайнах тоже.

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

## Операции

- [Привязать запись](./bindings/bind.md) — `POST /v1/timeline-logs/:id/bind`
- [Отвязать](./bindings/unbind.md) — `POST /v1/timeline-logs/:id/unbind`
- [Список привязок](./bindings/list.md) — `GET /v1/timeline-logs/:id/bindings`

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

- AI-агент обработал сделку клиента — событие должно появиться и в таймлайне сделки, и в таймлайне контакта, и в таймлайне компании. Создаём запись для сделки, привязываем к контакту и компании.
- Платёж по счёту прошёл — отметить во всех связанных карточках одновременно.
- Документ подписан несколькими сторонами — лог в таймлайне всех вовлечённых контактов и компаний.

## Типовой сценарий

1. Создать лог-запись для основной сущности: [`POST /v1/timeline-logs`](/docs/timeline-logs/logs/create) с `entityTypeId: 2, entityId: <dealId>`.
2. Привязать к контакту: [`POST /v1/timeline-logs/:id/bind`](./bindings/bind.md) с `entityTypeId: 3, entityId: <contactId>`.
3. Привязать к компании: ещё один `POST /:id/bind` с `entityTypeId: 4`.
4. Проверить итоговый список: [`GET /v1/timeline-logs/:id/bindings`](./bindings/list.md) — должно быть три привязки.

## Поддерживаемые типы сущностей

| `entityTypeId` | строковый `ENTITY_TYPE` |
|:---:|---|
| 1 | `lead` |
| 2 | `deal` |
| 3 | `contact` |
| 4 | `company` |
| 7 | `quote` |
| 14 | `order` |
| 31 | `smart_invoice` |
| ≥ 128 | `dynamic_<entityTypeId>` (произвольные смарт-процессы) |

В bind/unbind можно передать либо `entityTypeId` (числовой), либо `entityType` (строка) напрямую — Вайбкод сам подставит нужное значение в B24-вызов. В ответе `bindings.list` приходят оба поля для удобства клиента.

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

- [Таймлайн CRM](/docs/timeline-logs)
- [Записи журнала](/docs/timeline-logs/logs)
- [Смарт-процессы](/docs/entities/smart-processes)