Для AI-агентов: markdown этой страницы — /docs-content/voximplant-lines/default.md индекс документации — /llms.txt

Исходящая линия по умолчанию

GET /v1/voximplant-lines/default

Скоуп: telephony | Авторизация: X-Api-Key | URL: https://vibecode.bitrix24.tech/v1

GET /v1/voximplant-lines/default вызывает voximplant.line.outgoing.get и возвращает data: {lineId}. PUT с телом {lineId} вызывает voximplant.line.outgoing.set, затем перечитывает настройку. lineId обязателен и должен существовать в GET /v1/voximplant-lines. Пустой или неизвестный идентификатор: 400 до записи. Настройка меняется для всего портала.

Ошибки: 400 неверные параметры; 401 ключ или токен; 403 scope, права Б24 или READONLY на записи; 422 отказ Б24; 429 лимиты; 502 недоступность; 503 таймаут или заморозка.

PUT /v1/voximplant-lines/default

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

Поле	Тип	Обязательно	Значение
lineId	string	да для PUT	ID из доступных линий; настройка всего портала.

Поля ответа

Поле	Значение
success	Успех операции
data	Результат, описанный выше; секреты исключены

Примеры

cURL Личный ключ

Terminal

curl -X GET 'https://vibecode.bitrix24.tech/v1/voximplant-lines/default' \
  -H 'X-Api-Key: FAKE_VIBE_API_KEY'

cURL OAuth

Terminal

curl -X GET 'https://vibecode.bitrix24.tech/v1/voximplant-lines/default' \
  -H 'X-Api-Key: FAKE_VIBE_API_KEY' \
  -H 'Authorization: Bearer FAKE_APP_SESSION_TOKEN'

JavaScript Личный ключ

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/voximplant-lines/default', {
  method: 'GET',
  headers: {"X-Api-Key": "FAKE_VIBE_API_KEY"},
});
console.log(await response.json());

JavaScript OAuth

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/voximplant-lines/default', {
  method: 'GET',
  headers: {"X-Api-Key": "FAKE_VIBE_API_KEY", "Authorization": "Bearer FAKE_APP_SESSION_TOKEN"},
});
console.log(await response.json());

Наблюдалось на тестовом портале 2026-10-02; пример содержит поля ответа без секретов.

JSON

{
  "success": true,
  "data": {
    "lineId": "reg151083"
  }
}

Запишите выбранный lineId через PUT с теми же заголовками авторизации:

Terminal

curl -X PUT https://vibecode.bitrix24.tech/v1/voximplant-lines/default \
  -H 'X-Api-Key: FAKE_VIBE_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"lineId":"reg151083"}'

Ошибки

HTTP	Code
400	INVALID_PARAMS / MISSING_REQUIRED_FIELDS / READONLY_FIELD
401	MISSING_API_KEY / INVALID_API_KEY / TOKEN_MISSING
403	SCOPE_DENIED / WRITE_BLOCKED_READONLY_KEY / BITRIX_ACCESS_DENIED
422	BITRIX_ERROR
429	RATE_LIMITED
502	BITRIX_UNAVAILABLE
503	BITRIX_TIMEOUT

Справочник ошибок

403, если у ключа нет скоупа telephony:

JSON

{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'telephony' scope"
  }
}

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

Calls

SIP