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

Телефония сотрудников

GET /v1/telephony-users

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

GET /v1/telephony-users?userIds=42,43 вызывает voximplant.user.get с USER_ID массивом. Нужен OAuth-ключ приложения; вебхук получает 403 OAUTH_REQUIRED до вызова Б24. Поля ответа: id, defaultLine, phoneEnabled, sipServer, sipLogin, hasPassword, innerNumber. SIP_PASSWORD наружу не отдаётся. Б24 сам проверяет права и может требовать подтверждение доступа администратором.

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

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

Поле	Тип	Обязательно	Значение
userIds	string	да	Положительные ID сотрудников через запятую из списка пользователей.

Поля ответа

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

Примеры

cURL OAuth

Terminal

curl -X GET 'https://vibecode.bitrix24.tech/v1/telephony-users?userIds=42,43' \
  -H 'X-Api-Key: FAKE_VIBE_API_KEY' \
  -H 'Authorization: Bearer FAKE_APP_SESSION_TOKEN'

JavaScript OAuth

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/telephony-users?userIds=42,43', {
  method: 'GET',
  headers: {"X-Api-Key": "FAKE_VIBE_API_KEY", "Authorization": "Bearer FAKE_APP_SESSION_TOKEN"},
});
console.log(await response.json());

Успешный ответ OAuth живьём не проверен: ключа OAuth-приложения нет.

Ошибки

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	OAUTH_REQUIRED

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

403 при использовании вебхучного ключа:

JSON

{
  "success": false,
  "error": {
    "code": "OAUTH_REQUIRED",
    "message": "This endpoint requires an OAuth application key; webhook keys have no application context."
  }
}

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

Calls

SIP