# Телефония: Администрирование и конфигурация

Документ описывает администрирование и конфигурацию телефонии в 1Форме: типы PBX (FreeSwitch, Oktell, Простые звонки), разделение SipProviders и TelephonySettings, параметры Click-to-Call и WebRTC, SIP-аккаунты пользователей, события SmartPack и типовую нагрузку для сайзинга. Для администраторов площадки и инженеров внедрения.

## Поддерживаемые PBX и разделение SIP-провайдера с PBX

Платформа поддерживает три типа интеграции PBX с разными моделями инициации звонка.

| Тип | ServerType | Примечание |
|-----|-----------|-----------|
| **FreeSwitch** | 1 | Основной. Callback-модель. Типовая конфигурация в production |
| **Oktell** | 2 | Требует профиль в доп. учётных записях |
| **Простые звонки** | 3 | Минимальная интеграция |

**SipProviders** — конфигурация SIP-сервера для прямых звонков (WebRTC из браузера, нативный SIP с мобильного). Звонок идёт напрямую между клиентом и SIP-сервером.

**TelephonySettings** — конфигурация PBX для Click-to-Call. Платформа отправляет HTTP-запрос к PBX, PBX инициирует callback. Клиент в этом не участвует.

## Конфигурация TelephonySettings (PBX)

Основные параметры:

| Параметр | Описание | Пример |
|----------|----------|--------|
| ServerType | Тип PBX (1=FreeSwitch, 2=Oktell, 3=Простые звонки) | 1 (FreeSwitch) |
| ServerUrl | URL для callback-запросов | `https://<sip-сервер>/fs1f/click2call/` |
| ServerLogin / ServerPassword | Авторизация (пароль хранится в зашифрованном виде) | — |
| InternalPhoneMatchRegExp | Regex внутреннего номера | `^\d{5}$` |
| FirstDigitInPhone | Замена первой цифры при городском вызове | — |
| DefaultPhonePrefix | Префикс по умолчанию | — |
| DefaultIntlPhonePrefix | Международный префикс | — |
| AllowClientCallControl | Разрешить управление звонком с клиента | — |
| CallRedirectSmartExpressionId | SmartExpression для переадресации | null |

## Конфигурация SipProviders и SIP-аккаунтов пользователей

Типовая конфигурация — несколько провайдеров, отличающихся доменом SIP-сервера. Стандартные порты: SIP `5061`, WSS `7443`.

| Поле | Назначение |
|-----------|-----------|
| `WSAddress` | WebSocket для WebRTC |
| `Realm` | SIP realm |
| `ICEServers` | JSON конфигурация ICE/TURN серверов |
| `SIPServer` / `SIPPort` | Основной SIP-сервер |
| `SIPServerReserve` / `SIPPortReserve` | Резервный SIP-сервер |

Привязка пользователя к SIP-провайдеру (UserSipSettings). Два типа:

- **TypeId=1 (Mobile)** — нативный SIP-клиент на мобильном
- **TypeId=2 (Web)** — WebRTC из браузера

Бизнес-правило: одна `IsDefault = true` настройка на каждый TypeId.

## События SmartPack, типовая нагрузка и связанная документация

Привязка SmartScript-пакетов к событиям телефонии. Механизм реализован, но в типовых инсталляциях используется редко.

| Событие | Параметры |
|---------|-----------|
| IncomingCallStarted | user, callId, phone, incoming, redirected, external, startTime |
| IncomingTalkStarted | + talkStartTime |
| IncomingTalkComplete | + talkEndTime, recordingUrl |
| OutgoingCallStarted | аналогично incoming |
| OutgoingTalkStarted | + talkStartTime |
| OutgoingTalkComplete | + talkEndTime, recordingUrl |

| Метрика | Порядок значений |
|---------|------------------|
| Поток звонков | тысячи в месяц |
| SIP-провайдеры | от 1 до 5 |
| TelephonySettings | 1 рабочая конфигурация |
| TelephonyActionsPacks | редко используется, обычно 0 |