метод REST scope: telephony

telephony.externalLine.add

Добавить внешнюю линию

Кто может выполнять: любой пользователь

Описание

Метод telephony.externalLine.add добавляет внешнюю линию приложения.

Метод работает только в контексте приложения

Параметры

NUMBER string обязательный

Номер внешней линии

NAME string необязательный

Название внешней линии

CRM_AUTO_CREATE string необязательный

Автосоздание объекта CRM при исходящих звонках.

Возможные значения:

Y — включено
N — выключено

По умолчанию — Y

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"NUMBER":"74951234567","NAME":"Основная внешняя линия","CRM_AUTO_CREATE":"Y","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/telephony.externalLine.add

Ответ

HTTP-статус: 200

{
    "result": {
        "ID": 7
    },
    "time": {
        "start": 1772801648,
        "finish": 1772801648.420551,
        "duration": 0.420551061630249,
        "processing": 0,
        "date_start": "2026-03-06T15:54:08+03:00",
        "date_finish": "2026-03-06T15:54:08+03:00",
        "operating_reset_at": 1772802248,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

ID integer

Идентификатор созданной внешней линии

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "WRONG_AUTH_TYPE",
    "error_description": "Current authorization type is denied for this method"
}
Код Описание Значение
WRONG_AUTH_TYPE Current authorization type is denied for this method Метод вызван вне контекста приложения
ERROR_CORE NUMBER should not be empty Не передан обязательный параметр NUMBER
ERROR_CORE Line already exists Линия с указанным номером уже существует
ERROR_CORE DB error Ошибка базы данных при добавлении линии

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.