# Звонки в CRM

Регистрация входящих и исходящих внешних звонков в CRM Битрикс24, отображение карточки звонка оператору, завершение со статусом и длительностью, прикрепление текстовой транскрипции диалога.

Bitrix24 API: `telephony.externalcall.*`, `telephony.call.attachTranscription`
Скоуп: `telephony`

## Операции

- [Зарегистрировать звонок](./crm/register.md) — `POST /v1/calls/register`
- [Завершить звонок](./crm/finish.md) — `POST /v1/calls/:callId/finish`
- [Показать карточку](./crm/show.md) — `POST /v1/calls/:callId/show`
- [Скрыть карточку](./crm/hide.md) — `POST /v1/calls/:callId/hide`
- [Прикрепить транскрипцию](./crm/transcription.md) — `POST /v1/calls/:callId/transcription`

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

1. Входящий звонок поступил во внешнюю АТС → `POST /v1/calls/register` с `crmCreate: true` создаёт лид, если номер не найден в CRM. В ответе — `CALL_ID` и `CRM_ENTITY_ID`.
2. Карточка показывается оператору: `POST /v1/calls/:callId/show`.
3. Звонок завершается: `POST /v1/calls/:callId/finish` с длительностью и кодом результата.
4. После распознавания речи прикрепляется транскрипция: `POST /v1/calls/:callId/transcription` со списком реплик.

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

- [Телефония — обзор](../telephony.md)
- [Линии](./lines.md)
- [Исходящие звонки](./outbound.md)