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

`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 сотрудников через запятую из [списка пользователей](/docs/entities/users/list). |

## Поля ответа

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

## Примеры

### cURL OAuth

```bash
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 |

[Справочник ошибок](/docs/errors)

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

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

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

[Calls](/docs/calls)

[SIP](/docs/voximplant-sip)