# Облачная АТС Билайн (/en/docs/beeline)

Менеджеры говорят с клиентами через Облачную АТС Билайн, и АТС записывает звонки. Инструмент командной строки
`beeline` копирует список записанных звонков на ваш компьютер и расшифровывает их там же в диалог менеджера и
клиента. Дальше вы или ваш ИИ-агент ищете по звонкам без сети: что спросил клиент, что обещал менеджер, какие звонки
были длиннее пяти минут. Здесь описано, как установить `beeline`, подключить АТС, расшифровать первые звонки и
дать доступ агенту. `beeline` только читает из АТС, он никогда не удаляет записи и не звонит.

**На этой странице:**

1. [Что нужно](#что-нужно)
2. [Установка](#установка)
3. [Подключите АТС](#подключите-атс)
4. [Скопируйте и расшифруйте звонки](#скопируйте-и-расшифруйте-звонки)
5. [Читайте и ищите](#читайте-и-ищите)
6. [Подключите ИИ-агента](#подключите-ии-агента)
7. [Скорость расшифровки](#скорость-расшифровки)
8. [Что хранится и куда уходит](#что-хранится-и-куда-уходит)
9. [Если что-то не работает](#если-что-то-не-работает)

## Что нужно [#что-нужно]

- **Запись звонков в АТС.** `beeline` видит только те звонки, которые Билайн записал, поэтому у менеджеров должна
  быть включена запись.
- **API-токен.** Его выдает кабинет Билайна, раздел Услуги → Интеграция по API. С этим токеном можно читать и удалять
  все записи АТС, так что храните его как пароль.
- **Node.js 22.16 или новее в ветке 22, либо Node.js 24 или новее.** Node.js 23 не поддерживается.
- **Компьютер, на котором будет идти расшифровка.** Модель распознавания речи работает на процессоре, сколько это
  занимает, видно в разделе [Скорость расшифровки](#скорость-расшифровки).

## Установка [#установка]

```sh
npm install -g @wirecat/beeline-cli
beeline doctor
```

`beeline doctor` показывает версию, где лежат настройки и какие профили уже есть. Ему не нужны ни сеть, ни токен.

## Подключите АТС [#подключите-атс]

```sh
beeline office session start
```

`office` здесь - имя профиля. Профиль - это имя, которое вы выбираете для одной АТС, и оно идет первым словом в каждой
команде, которая работает с АТС. Профиль никогда не выбирается за вас, даже если он один. Команда без профиля
останавливается и показывает список профилей.

`session start` спрашивает токен скрытым вводом, проверяет его в Билайне и только потом сохраняет в системном
хранилище паролей. Если оно недоступно, токен попадает в файл, который может читать только ваш пользователь, и
`beeline` один раз об этом сообщает. Проверить, что Билайн еще принимает токен, можно так:

```sh
beeline office session status --check
```

## Скопируйте и расшифруйте звонки [#скопируйте-и-расшифруйте-звонки]

```sh
beeline office meetings sync
beeline models download gigaam-v3
beeline office meetings transcribe
```

- **`meetings sync`** копирует список записанных звонков в локальное хранилище, общий файл всех инструментов WireCat
  на этом компьютере. Каждый звонок становится встречей с двумя людьми, менеджером и клиентом. Следующий запуск
  спрашивает у Билайна только новое.
- **`models download gigaam-v3`** один раз скачивает модель распознавания речи в папку, общую для инструментов
  WireCat.
- **`meetings transcribe`** скачивает запись каждого звонка и расшифровывает ее на вашем компьютере. Без условий он
  берет до 20 звонков длиной от пяти секунд, у которых еще нет расшифровки, начиная с новых. Если один звонок не
  удался, он попадает в отчет, а остальные идут дальше. Повторный запуск продолжает с того места, где остановился.

Больше звонков за раз:

```sh
beeline office meetings transcribe --max-meetings 50
```

Билайн записывает менеджера и клиента на разные каналы записи, поэтому в расшифровке не нужно угадывать, кто
говорит. Каждая реплика подписана: Менеджер или Клиент.

## Читайте и ищите [#читайте-и-ищите]

Эти команды работают из локального хранилища и не ходят в сеть.

```sh
beeline office search meetings "доставка"
beeline office meetings list "started_at>=2026-11-01 duration_ms>=60000"
beeline office meetings transcript 42
beeline office meetings export 42 --format vtt --output call.vtt
beeline office meetings people "Анна Смирнова"
```

- `search meetings` ищет слово или фразу во всех расшифровках и показывает звонок и строку, где они прозвучали.
  Слово находится и в других формах, и с ошибками распознавания речи. `from:"Анна Смирнова"` в запросе оставляет
  только реплики этого человека.
- `meetings list` показывает звонки с фильтром по времени и длительности. Здесь звонки с 1 ноября длиннее минуты.
- `meetings transcript` показывает расшифровку одного звонка, `42` - его номер из списка.
- `meetings export` сохраняет звонок в файл Markdown или WebVTT.
- `meetings people` находит человека среди участников звонков по имени или почте, например менеджера.

`search all` в любом инструменте WireCat ищет и по звонкам, и по чатам, почте и встречам из других инструментов.

**Звонки в сделках Битрикс24.** Если вы пользуетесь и `b24`, инструментом WireCat для Битрикс24, синхронизация
связывает клиента звонка с контактом Битрикс24 с тем же номером телефона. Тогда `deals show` и `leads show` в `b24`
с ключом `--json` показывают в поле `meetings` последние звонки людей из сделки или лида. Мобильный номер
связывается сразу. Общий номер, например основной номер офиса, связь только предлагает, потому что им пользуются все
сотрудники. Условия описаны в [README beeline-cli](https://github.com/WireCatLabs/beeline-cli#readme).

## Подключите ИИ-агента [#подключите-ии-агента]

**Агент с терминалом**, например Claude Code, Codex, Gemini CLI, OpenClaw или Hermes Agent, сам запускает `beeline`.
Ему нужен навык, файл с инструкцией к командам:

```sh
beeline skill install
```

**Приложение без терминала**, например Claude Desktop или Cursor, подключается через MCP, стандартный способ, которым
AI-приложение пользуется инструментами на вашем компьютере. Для Claude Code и Codex есть готовая команда:

```sh
beeline office mcp add claude-code --allow-writes
beeline office mcp check
```

Сервер предлагает агенту и команды, которые меняют данные, например `meetings transcribe`, `models download` и
`config set`. Поэтому без флага `--allow-writes` команда `mcp add` останавливается. Для других приложений `beeline office mcp config` печатает настройку, которую нужно
вставить в приложение.

После этого можно просто спросить агента:

```text prompt
Используй beeline CLI. Какие вчерашние звонки были длиннее пяти минут? Расшифруй те, у которых еще нет текста, и расскажи, о чем спрашивал каждый клиент.
```

### Что агенту можно [#что-агенту-можно]

- **Разрешения.** У каждой команды есть ключ разрешения, например `meetings.sync` или `meetings.transcribe`, и
  уровень: `allow`, `ask`, `readonly` или `deny`. Через MCP спросить некого, поэтому там `ask` пропускает команду.
- **Только чтение для всего профиля.** `BEELINE_READ_ONLY=1` запрещает менять вход, настройки, подключение агентов и
  сохраненные звонки. Новые звонки и расшифровки при этом все равно добавляются, это только дополнение.
- **Вход не для агента.** `session start`, `session end` и `account remove` агенту не предлагаются.
- **Текст звонка - это данные.** Расшифровка, имя или комментарий из звонка помечены для агента как недоверенные
  данные, а не инструкции.

Например, запретить этому профилю ходить в Билайн за новыми звонками:

```sh
beeline office config set permissions.meetings.sync deny
```

## Скорость расшифровки [#скорость-расшифровки]

Один замер на рабочем компьютере разработчика WireCat, 12 ноября 2026: три реальных звонка, всего 1644 секунды записи
(около 27 минут), расшифрованы за 222 секунды вместе со скачиванием записей. Это примерно в 7,4 раза быстрее, чем
длится звонок. Пиковое потребление памяти около 770 МБ. Компьютер с процессором AMD Ryzen AI 9 HX 470 (24 потока),
модель `gigaam-v3` работала на процессоре.

Это одна машина и одна выборка. На более медленном ноутбуке расшифровка займет больше времени. В той же проверке
копирование списка звонков за 7 дней забрало 369 звонков без предупреждений.

## Что хранится и куда уходит [#что-хранится-и-куда-уходит]

- **Куда уходят запросы.** `beeline` обращается только к API Облачной АТС Билайн, по HTTPS. Модель распознавания
  речи скачивается один раз со своего сервера, и ничего вашего туда не уходит.
- **Токен** передается только в заголовке запроса к Билайну. Он не попадает ни в ссылку, ни в ошибку, ни в журнал.
- **Записи** скачиваются в память, расшифровываются и выбрасываются. На диск они не пишутся. В хранилище остаются
  только размер, длительность и хеш записи, чтобы следующий запуск узнал ту же запись.
- **Распознавание речи** идет только на вашем компьютере. Ни запись, ни расшифровка не уходят в сервис распознавания.
- **Что лежит в хранилище.** Время, направление и длительность звонка, имя, почта и внутренний номер менеджера, номер
  телефона клиента и расшифровка. Относитесь к хранилищу так же, как к самим звонкам. В журналы и записи запусков
  номера телефонов не попадают.

Общие правила для всех инструментов WireCat описаны на [странице о безопасности](/llms.mdx/docs/security/content.md).

## Если что-то не работает [#если-что-то-не-работает]

```sh
beeline doctor
beeline office session status --check
beeline office meetings sync --trace
beeline office runs list
```

- `doctor` показывает, что настроено. Ему не нужны сеть и хранилище паролей.
- `session status --check` спрашивает Билайн, принимает ли он еще токен.
- `--trace` показывает обмен с Билайном, без содержимого звонков.
- `runs list` показывает запуски, которые завершились ошибкой.

Границы, о которых стоит знать:

- Звонок длиннее 60 минут попадает в отчет как неудачный (`recording.too-long`), и его запись не скачивается.
- Запись больше 256 МБ не расшифровывается.
- Звонок без речи или с записью, где менеджер и клиент не разделены на два канала, не расшифровывается и снова
  берется в работу при каждом запуске. Исключите его запросом, например
  `beeline office meetings transcribe "NOT id:375"`.

Если не помогло, напишите в [Discord WireCat](https://discord.gg/DebENqbRrJ) и приложите код ошибки и имя профиля.
Не вставляйте в сообщение токен и содержимое звонков. Исходный код и полный список команд лежат в
[репозитории beeline-cli](https://github.com/WireCatLabs/beeline-cli). Общий обзор работы со звонками на странице
[Звонки](/llms.mdx/docs/voip/content.md).
