SIP Voice выводзіць вашага агента на тэлефон. Ён прымае і робіць сапраўдныя
званкі праз любы стандартны SIP-транк, выконвае жывы маўленчы ход падчас званка і
перадае вам запіс і паслязванковае рэзюмэ, калі званок завяршаецца. Ён
аператар-нейтральны: размаўляе на простым SIP, таму няма прывязкі да аператара
— накіруйце яго на любы транк, які дае ваш тэлефанійны правайдар.
Плагін працуе host-native і злучае разам baresip (эндпойнт SIP/RTP), аўдыёшлях
ALSA loopback і невялікі Python-мост, які перамяшчае аўдыё паміж званком і
галасавым ходам шлюза. Ён размаўляе са шлюзам праз кантракт. Паводзіны канала для
канчатковага карыстальніка апісаны на старонцы канала
SIP; гэтая старонка ахоплівае сам плагін.
Мост паміж тэлефонным званком і ходам AiHummer. Калі званок злучаецца, аўдыё
цячэ ад baresip праз ALSA loopback у Python-мост, які выконвае цыкл
маўленне-ў-тэкст → ход агента → тэкст-у-маўленне і прайгравае адказ назад у
званок. Даступны два маўленчыя рухавікі:
yandex — воблачны маўленчы рухавік рэальнага часу.
local — цалкам self-hosted, выкарыстоўваючы faster-whisper для STT і
edge-tts для TTS.
Як гэта выкарыстоўваецца
Падчас званка агент можа рабіць больш, чым проста размаўляць:
ask_assistant — запусціць ход агента падчас званка, каб адказаць таму, хто
тэлефануе.
send_dtmf — выдаваць DTMF-тоны (напр. для навігацыі па IVR або ўводу кода).
запіс — захоп аўдыё званка.
barge-in — дазволіць таму, хто тэлефануе, натуральна перапыніць маўленне
агента.
паслязванковае рэзюмэ — стварыць рэзюмэ пасля завяршэння званка.
[!WARNING]
Плагін SIP падтрымлівае толькі STT, TTS, barge-in, DTMF і запіс. Ён не
забяспечвае дыярызацыю дыктараў, пераклад маўлення ці кланаванне голасу. Гэта
асобныя магчымасці core/sidecar (гл.
Дыярызацыя, пераклад і кланаванне)
і яны не з’яўляюцца часткай шляху SIP-званка. Не разлічвайце на іх падчас
тэлефоннага званка.
Усталяванне
Усталюйце SIP Voice у адзін клік з маркетплэйса ў адмін-інтэрфейсе. Host-native
дэплоер спампоўвае плагін, выконвае яго крок усталявання, рэндэрыць ізаляваны
systemd-юніт і чакае эндпойнт здароўя, перш чым пазначыць яго гатовым — гл.
Усталяванне і абнаўленні. Затым вы
наладжваеце ўліковыя дадзеныя свайго SIP-транка і выбіраеце рухавік yandex ці
local.
[!TIP]
Для цалкам self-hosted налады без платных мадэлей выберыце рухавік local:
faster-whisper і edge-tts трымаюць увесь галасавы шлях на вашым уласным хосце.
Бяспека і абмежаванні
Аператар-нейтральны транк. Стандартны SIP, без прывязкі да аператара.
Ахоп — STT/TTS/DTMF/запіс/barge-in. Без дыярызацыі, перакладу ці кланавання
голасу на шляху званка.
Host-native.baresip, loopback і мост працуюць пад systemd, а не ў
кантэйнеры.
Запіс яўны. Запіс і паслязванковыя рэзюмэ — гэта функцыі званка, якія вы
ўключаеце — апрацоўвайце аўдыё званка згодна з вашымі мясцовымі правіламі
згоды/захоўвання.
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP Voice выводзіць вашага агента на тэлефон.** Ён прымае і робіць сапраўдныя
званкі праз любы стандартны SIP-транк, выконвае жывы маўленчы ход падчас званка і
перадае вам запіс і паслязванковае рэзюмэ, калі званок завяршаецца. Ён
**аператар-нейтральны**: размаўляе на простым SIP, таму няма прывязкі да аператара
— накіруйце яго на любы транк, які дае ваш тэлефанійны правайдар.
Плагін працуе host-native і злучае разам `baresip` (эндпойнт SIP/RTP), аўдыёшлях
**ALSA loopback** і невялікі Python-мост, які перамяшчае аўдыё паміж званком і
галасавым ходам шлюза. Ён размаўляе са шлюзам праз кантракт. Паводзіны канала для
канчатковага карыстальніка апісаны на старонцы канала
[SIP](/en/v1.0/channels/sip); гэтая старонка ахоплівае сам плагін.
## Факты
| Field | Value |
|---|---|
| Версія | 25.1.0 |
| Порт здароўя | 8830 |
| SIP listen | 5062 |
| baresip control | 4444 |
| Асяроддзе выканання | baresip + ALSA loopback + Python-мост, host-native |
## Што гэта
Мост паміж тэлефонным званком і ходам AiHummer. Калі званок злучаецца, аўдыё
цячэ ад `baresip` праз ALSA loopback у Python-мост, які выконвае цыкл
**маўленне-ў-тэкст → ход агента → тэкст-у-маўленне** і прайгравае адказ назад у
званок. Даступны два маўленчыя рухавікі:
- **`yandex`** — воблачны маўленчы рухавік рэальнага часу.
- **`local`** — цалкам self-hosted, выкарыстоўваючы `faster-whisper` для STT і
`edge-tts` для TTS.
## Як гэта выкарыстоўваецца
Падчас званка агент можа рабіць больш, чым проста размаўляць:
- **`ask_assistant`** — запусціць ход агента падчас званка, каб адказаць таму, хто
тэлефануе.
- **`send_dtmf`** — выдаваць DTMF-тоны (напр. для навігацыі па IVR або ўводу кода).
- **запіс** — захоп аўдыё званка.
- **barge-in** — дазволіць таму, хто тэлефануе, натуральна перапыніць маўленне
агента.
- **паслязванковае рэзюмэ** — стварыць рэзюмэ пасля завяршэння званка.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Ахоп магчымасцей
> [!WARNING]
> Плагін SIP падтрымлівае **толькі STT, TTS, barge-in, DTMF і запіс.** Ён **не**
> забяспечвае дыярызацыю дыктараў, пераклад маўлення ці кланаванне голасу. Гэта
> асобныя магчымасці core/sidecar (гл.
> [Дыярызацыя, пераклад і кланаванне](/en/v1.0/voice/diarization-translation-clone))
> і яны не з'яўляюцца часткай шляху SIP-званка. Не разлічвайце на іх падчас
> тэлефоннага званка.
## Усталяванне
Усталюйце SIP Voice у адзін клік з маркетплэйса ў адмін-інтэрфейсе. Host-native
дэплоер спампоўвае плагін, выконвае яго крок усталявання, рэндэрыць ізаляваны
systemd-юніт і чакае эндпойнт здароўя, перш чым пазначыць яго гатовым — гл.
[Усталяванне і абнаўленні](/en/v1.0/marketplace/install-updates). Затым вы
наладжваеце ўліковыя дадзеныя свайго SIP-транка і выбіраеце рухавік `yandex` ці
`local`.
> [!TIP]
> Для цалкам self-hosted налады без платных мадэлей выберыце рухавік **`local`**:
> `faster-whisper` і `edge-tts` трымаюць увесь галасавы шлях на вашым уласным хосце.
## Бяспека і абмежаванні
- **Аператар-нейтральны транк.** Стандартны SIP, без прывязкі да аператара.
- **Ахоп — STT/TTS/DTMF/запіс/barge-in.** Без дыярызацыі, перакладу ці кланавання
голасу на шляху званка.
- **Host-native.** `baresip`, loopback і мост працуюць пад systemd, а не ў
кантэйнеры.
- **Запіс яўны.** Запіс і паслязванковыя рэзюмэ — гэта функцыі званка, якія вы
ўключаеце — апрацоўвайце аўдыё званка згодна з вашымі мясцовымі правіламі
згоды/захоўвання.
## Куды далей
- Канал: [SIP](/en/v1.0/channels/sip)
- [Уваход/выхад маўлення (STT/TTS)](/en/v1.0/voice/stt-tts)
- [Усталяванне і абнаўленні](/en/v1.0/marketplace/install-updates)