# Линии

Создание, обновление и удаление внешних линий приложения, а также чтение списка линий, арендованных у Voximplant или подключённых по SIP.

Bitrix24 API: `telephony.externalLine.*`, `voximplant.line.get`
Скоуп: `telephony`

## Операции

- [Список линий приложения](./lines/list.md) — `GET /v1/telephony-lines`
- [Поиск линий приложения](./lines/search.md) — `POST /v1/telephony-lines/search`
- [Добавить линию](./lines/create.md) — `POST /v1/telephony-lines`
- [Обновить линию](./lines/update.md) — `PATCH /v1/telephony-lines/:number`
- [Удалить линию](./lines/delete.md) — `DELETE /v1/telephony-lines/:number`
- [Поля линии приложения](./lines/fields.md) — `GET /v1/telephony-lines/fields`
- [Линии Voximplant](./lines/voximplant.md) — `GET /v1/voximplant-lines`

## Что нужно знать

Два эндпоинта возвращают линии из разных источников:
- `GET /v1/telephony-lines` — линии, **добавленные приложением** через `POST /v1/telephony-lines`. Актуально для приложений, подключающих собственную АТС к порталу.
- `GET /v1/voximplant-lines` — линии, **арендованные у Voximplant** или подключённые по SIP, видимые порталу. Только чтение.

Идентификатор линии приложения — строка `number`, заданная при создании. URL обновления и удаления использует именно её — спецсимволы нужно URL-кодировать.

## Поля линии приложения

| Поле | Тип | Описание |
|------|-----|---------|
| `number` | string | Номер внешней линии, заданный при создании |
| `name` | string \| null | Название линии, отображаемое в интерфейсе. `null`, если не задано при создании |
| `crmAutoCreate` | boolean | Автосоздание CRM-сущности при исходящем звонке через линию. По умолчанию `true` |
| `serverName` | string | Имя сервера телефонии. Только для чтения: в ответах не приходит, а запись отклоняется с `400 READONLY_FIELD` |

Какие из этих полей принимаются на запись — [Добавить линию](./lines/create.md) и [Обновить линию](./lines/update.md). Набор полей линий Voximplant описан на странице [Линии Voximplant](./lines/voximplant.md).

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

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