Официалтәи аплагинқәа/SIP Voice аплагин
SIP Voice аплагин
v1.0.x · ирҿыцуп 2026-06-26

SIP Voice шәагент ателефон аҿы иҟанаҵоит. Иара иҵабыргу ааҭгарақәа стандарттәу
SIP-транк ала иҭакуеит насгьы инымҩаԥгоит, аҭелаан абжьытә реилаҳара ныҟәнагоит,
насгьы ааҭгара аналга аҭагалареи аҭелшьҭахьтәи ахьӡынҵеи иҟанаҵоит. Иара
аоператор-неитралтәуп: иара ианагӡоит ишьақәгылоу SIP, убри аҟынтә акарриер
аркра ыҟам — шәтелефониа провайдер ишәнаҭо транк ала иарбна шәрылацҳа.
Аплагин хост-нативла аус ауеит насгьы аиццакроуп baresip (SIP/RTP аендпоинт),
ALSA loopback аудио-мҩа, насгьы аҟыр Python-бридж, иара ааҭгареи агейту
абжьытә реилаҳареи рыбжьара аудио ныҟәигоит. Иара агейту дзацҳажәоит акантракт
ала. Ахархәаҩ ихадоу аканал ашьаҟ аканал адаҟьа аҿы иҟоуп SIP;
ари адаҟьа аплагин хаҭа дазааҭгылоит.
Афактқәа
| Афырт |
Аԥша |
| Аверсиа |
25.1.0 |
| Агәабзиара апорт |
8830 |
| SIP listen |
5062 |
| baresip control |
4444 |
| Аус ауа двигатель |
baresip + ALSA loopback + Python-бридж, хост-нативла |
Иарбан акоуа
Ателефонтә ааҭгареи AiHummer ашьаҟи рыбжьара абридж. Ааҭгара ианеилаҵоу, аудио
baresip аахьынтә ALSA loopback ала Python-бриджахьы ицоит, иара
ажәахьтә-текст → аагент ашьаҟ → атекстахьтә-ажәа цикл ныҟәнагоит насгьы аҭак
ааҭгарахьы анарыхуеит. Ҩба ажәатә двигатель ыҟоуп:
yandex — реалтаимтә ̄клауд ажәатә двигатель.
local — иаԥсам-хаҭала-хост, STT азы faster-whisper насгьы TTS азы edge-tts
ахархәарала.
Ишахархәоу
Ааҭгараан аагент ажәара мацара акәымкәа уаҳагьы дцозар алшоит:
ask_assistant — ааҭгаратәи аагент ашьаҟ инымҩаԥгара ааҭгараҩ иаҭакра азы.
send_dtmf — DTMF абжьытә рҭыжьра (амҵандаз IVR ала аиҭацара ма акод
аларгалара азы).
- аҭагалара — ааҭгара аудио аҭагалара.
- barge-in — ааҭгараҩ аагент ажәара ибжьаҟәиҵарц иаԥиҵоит наҟ-наҟ.
- аҭелшьҭахьтәи ахьӡынҵа — ааҭгара аналга ахьӡынҵа иҟанаҵоит.
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
Афункциа аобласт
[!WARNING]
SIP аплагин инаднаҳәалоит STT, TTS, barge-in, DTMF насгьы аҭагалара мацара.
Иара иҟанаҵом аныҟәгаҩцәа реихшара, ажәара аиҭагара ма абжьы аклонра.
Уи хаз-хазтәу core/sidecar алшарақәоуп (шәахәаԥш
Аеихшара, аиҭагара & аклонра)
насгьы SIP-ааҭгара амҩа ахәҭакым. Ателефон ааҭгараҿ уи шәамгәыӷлан.
Аиргылара
SIP Voice акакьала аиргыла амаркетплеис ала аадмин UI аҿы. Хост-нативтә деплоиер
аплагин ҭагалоит, аиргылара ашьаҟ нымҩаԥнагоит, иаԥшәырхоу систем sysтемd-юнит
рендар наулоит насгьы агәабзиара аендпоинт иазыԥшуеит ишеилгахаанӡа — шәахәаԥш
Аиргылареи аобновлениеи. Нас шәара шәSIP-транк
акредитқәа шәнастройка наулоит насгьы yandex ма local двигатель шәалхуеит.
[!TIP]
Иаԥсам-хаҭала-хост, иаԥсахуа-моделькам аситем азы, шәалхы local двигатель:
faster-whisper-и edge-tts-и абжьытә мҩа зегь шәхаҭа шәхост аҿы иаанрыжьуеит.
Ашәарҭадареи алимитқәеи
- Аоператор-неитралтә транк. Стандарттә SIP, акарриер аркра ыҟам.
- Аобласт — STT/TTS/DTMF/аҭагалара/barge-in. Аеихшара, аиҭагара ма абжьы
аклонра ааҭгара амҩа аҿы ыҟам.
- Хост-нативла.
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, убри аҟынтә акарриер
аркра ыҟам — шәтелефониа провайдер ишәнаҭо транк ала иарбна шәрылацҳа.
Аплагин хост-нативла аус ауеит насгьы аиццакроуп `baresip` (SIP/RTP аендпоинт),
**ALSA loopback** аудио-мҩа, насгьы аҟыр Python-бридж, иара ааҭгареи агейту
абжьытә реилаҳареи рыбжьара аудио ныҟәигоит. Иара агейту дзацҳажәоит акантракт
ала. Ахархәаҩ ихадоу аканал ашьаҟ аканал адаҟьа аҿы иҟоуп [SIP](/en/v1.0/channels/sip);
ари адаҟьа аплагин хаҭа дазааҭгылоит.
## Афактқәа
| Афырт | Аԥша |
|---|---|
| Аверсиа | 25.1.0 |
| Агәабзиара апорт | 8830 |
| SIP listen | 5062 |
| baresip control | 4444 |
| Аус ауа двигатель | baresip + ALSA loopback + Python-бридж, хост-нативла |
## Иарбан акоуа
Ателефонтә ааҭгареи AiHummer ашьаҟи рыбжьара абридж. Ааҭгара ианеилаҵоу, аудио
`baresip` аахьынтә ALSA loopback ала Python-бриджахьы ицоит, иара
**ажәахьтә-текст → аагент ашьаҟ → атекстахьтә-ажәа** цикл ныҟәнагоит насгьы аҭак
ааҭгарахьы анарыхуеит. Ҩба ажәатә двигатель ыҟоуп:
- **`yandex`** — реалтаимтә ̄клауд ажәатә двигатель.
- **`local`** — иаԥсам-хаҭала-хост, STT азы `faster-whisper` насгьы TTS азы `edge-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 акакьала аиргыла амаркетплеис ала аадмин UI аҿы. Хост-нативтә деплоиер
аплагин ҭагалоит, аиргылара ашьаҟ нымҩаԥнагоит, иаԥшәырхоу систем sysтемd-юнит
рендар наулоит насгьы агәабзиара аендпоинт иазыԥшуеит ишеилгахаанӡа — шәахәаԥш
[Аиргылареи аобновлениеи](/en/v1.0/marketplace/install-updates). Нас шәара шәSIP-транк
акредитқәа шәнастройка наулоит насгьы `yandex` ма `local` двигатель шәалхуеит.
> [!TIP]
> Иаԥсам-хаҭала-хост, иаԥсахуа-моделькам аситем азы, шәалхы **`local`** двигатель:
> `faster-whisper`-и `edge-tts`-и абжьытә мҩа зегь шәхаҭа шәхост аҿы иаанрыжьуеит.
## Ашәарҭадареи алимитқәеи
- **Аоператор-неитралтә транк.** Стандарттә SIP, акарриер аркра ыҟам.
- **Аобласт — STT/TTS/DTMF/аҭагалара/barge-in.** Аеихшара, аиҭагара ма абжьы
аклонра ааҭгара амҩа аҿы ыҟам.
- **Хост-нативла.** `baresip`, loopback, насгьы абридж systemd аҵаҟа аус руеит,
контеинер аҩныҵҟа акәымкәа.
- **Аҭагалара иарбоуп.** Аҭагалареи аҭелшьҭахьтәи ахьӡынҵеи шәара ишәырҭаххо ааҭгара
афункциақәоуп — ааҭгара аудио шәтыԥ аҳасаб/ахьчара аԥҟарақәа рыла шәахәаԥш.
## Аҩаҟа уаҳа
- Аканал: [SIP](/en/v1.0/channels/sip)
- [Ажәа ҭагала/аҭых (STT/TTS)](/en/v1.0/voice/stt-tts)
- [Аиргылареи аобновлениеи](/en/v1.0/marketplace/install-updates)