[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-telephony\u002Fanalytics\u002Fvoices":3,"docs-tabs-telephony\u002Fanalytics\u002Fvoices":6},{"content":4,"lastmod":5},"\n## Справочник голосов\n\n`GET \u002Fv1\u002Fcalls\u002Fvoices`\n\nВозвращает словарь доступных голосов для синтеза речи. Идентификаторы из ответа передаются как параметр `voice` в [`POST \u002Fv1\u002Fcalls\u002Fauto-call`](..\u002Foutbound\u002Fauto-call.md).\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fcalls\u002Fvoices \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fcalls\u002Fvoices \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fcalls\u002Fvoices', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\n\nconst { success, data } = await res.json()\nconst voices = Object.entries(data)\n\u002F\u002F [['ruinternalfemale', 'Русский (женский) (Default)'], ...]\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fcalls\u002Fvoices', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Словарь голосов: ключ — идентификатор голоса, значение — название для отображения с указанием источника синтеза в скобках |\n| `data.\u003CvoiceId>` | string | Название голоса. В скобках — источник синтеза: `Amazon` или `Default`. Передавайте `voiceId` как параметр `voice` в автозвонке |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"auenglishfemale\": \"Австралийский английский (женский) (Amazon)\",\n    \"brportuguesefemale\": \"Бразильский португальский (женский) (Amazon)\",\n    \"ruinternalfemale\": \"Русский (женский) (Default)\",\n    \"ruinternalmale\": \"Русский (мужской) (Default)\",\n    \"ukenglishfemale\": \"Английский (женский) (Amazon)\",\n    \"ukenglishmale\": \"Английский (мужской) (Amazon)\",\n    \"usenglishfemale\": \"Американский английский (женский) (Default)\",\n    \"usenglishmale\": \"Американский английский (мужской) (Default)\",\n    \"eurfrenchfemale\": \"Французский (женский) (Amazon)\",\n    \"eurfrenchmale\": \"Французский (мужской) (Amazon)\",\n    \"eurgermanfemale\": \"Немецкий (женский) (Default)\",\n    \"eurgermanmale\": \"Немецкий (мужской) (Default)\",\n    \"jpjapanesefemale\": \"Японский (женский) (Default)\",\n    \"chchinesefemale\": \"Китайский (женский) (Default)\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `telephony`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'telephony' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный API-ключ |\n| 401 | `TOKEN_MISSING` | Ключ не имеет настроенных токенов Битрикс24 |\n| 401 | `KEY_INACTIVE` | API-ключ неактивен или отозван |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `telephony` |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку (текст в `error.message`) |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**`data` — объект-словарь, не массив.** Для перебора всех голосов используйте `Object.entries(data)`. Получить конкретный голос по идентификатору: `data['ruinternalfemale']`.\n\n**Голос по умолчанию.** При вызове автозвонка без параметра `voice` Битрикс24 выбирает голос по умолчанию исходя из языка портала. Для русскоязычного портала — `ruinternalfemale`.\n\n**Набор голосов зависит от тарифа.** Доступные голоса и их идентификаторы могут различаться в зависимости от тарифного плана портала.\n\n## Смотрите также\n\n- [Автозвонок с синтезом речи](..\u002Foutbound\u002Fauto-call.md) — использует идентификатор голоса из этого справочника\n- [Автозвонок с аудиофайлом](..\u002Foutbound\u002Fauto-call-audio.md)\n- [Статистика звонков](.\u002Fstatistics.md)\n- [Телефония — обзор](\u002Fdocs\u002Ftelephony)\n","2026-06-23",{}]