SIP ses agentiňizi telefonyň başynda goýýar. Ol jogap berýär we islendik standart SIP trunk arkaly hakyky jaňlary amala aşyrýar, jaň wagtynda göni söz görnüşini işledýär we jaň gutaranda size ýazgy we jaňdan soňky gysgaça bellik berýär. Ol operatora garaşsyz: bu açyk SIP-iň dilini ulanar, şonuň üçin daşky üpjün ediji bilen çäklendirilme ýok — ony telefonyňyzyň üpjün edijisi beren haýsy trunk bolsa şoňa gönükdiriň.
Plugin myhman-tanalyjyny işledýär we birlikde birleşdirýär baresip (SIP/RTP ugry), bir ALSA gaýtadan baglanyşyk ses ýoly we çagyrşyk bilen geçelginiň ses öwrülişi arasynda sesi geçiren kiçi Python köprüsü. Ol geçelge bilen aragatnaşyk edýär aihummer.service.v1 şertnama. Ahyry ulanyjy kanalyň hereketi kanal sahypasynda bar SIP; bu sahypa pluginiň özüni öz içine alýar.
Telefon jaňy bilen AiHummer öwrülişiň arasynda bir köprü. Jaň baglanyşanda, ses akýar baresip ALSA loopback arkaly Python köprüsine, ol ýerine ýetirýän daşky sözden ýazga → agentiň nobaty → ýazgydan sözleýiş döwr edýär we jogaby gaýtadan jaňyň içine oýnaýar. Iki ses enjamy bar:
yandex — çalt wagtda bulut ses motory.
local — doly özbaşdak oturdylan, ulanyp faster-whisper STT üçin we edge-tts
TTS üçin.
Ol nähili ulanylýar
Jaň wagty agent diňe geplemekden başga zatlar hem edip biler:
ask_assistant — jaň edene jogap bermek üçin jaň agentliginde bir nobat işleýär.
send_dtmf — DTMF tonlaryny çykar (meselem, IVR arkaly ýöretmek ýa-da kody girizmek üçin).
ýazgy — jaň sesini ýazga alyň.
arasyna girmek — jaň ediji agentiň çykyşyna tebigy ýagdaýda päsgel bermäge rugsat beriň.
jaňdan soňky gysgaça maglumat — jaň gutarandan soň beýannama düz.
[!WARNING]
SIP plaginini goldaýar STT, TTS, aralaşmak, DTMF we diňe ýazgy. Ol
etýär däk sözlü terjime üpjün etmek — bu başga bir esasy kuwwat
(seret Sözlü terjimä we wideo)
we SIP jaň ugrynyň bir bölegi däldir. Telefon jaňynda munuň bardygyny çaklama.
Gurnama
Admin UI-de marketplace-den bir basyş bilen SIP Voice gurnuň. Host-native deployer plugin-i göçürýär, gurmak ädimini ýerine ýetirýär, howpsuzlykda çäklendirilmiş systemd unit döredýär we saglyk nokadyny garaşýar, soňra onuň taýýardygyny belläp berýär — serediň Gurnama we täzelenmeler. Soňra siz SIP şlýuz görkezmelerini sazlaýarsyňyz we saýlaýarsyňyz yandex ýa-da local motory.
[!TIP]
Doly öz öňünden ýylman çykarylan, tölegsiz modeller bilen işläp bilýän ulgam üçin, saýlaň local motory:
faster-whisper we edge-tts Diňleýän sesiň beýik öňüni öz serweriňizde saklaň.
Howpsuzlyk we çäklendirmeler
Operatora garaşsyz magistral. Standart SIP trunk, daşlaýjy çäklendirmesi ýok; codec, DTMF we ugrukdyryş gabatlylygyny barla.
Çäk STT/TTS/DTMF/ ýazgy/ aralyk girmegi öz içine alýar. Sözlü terjime ýok
ugur çagyryşy (bu esasy öňdebaryjy häsiýetdir).
Mehman-jaýlybaresip, loopback we köprü systemd astynda işleýär, däldir
gapda.
Ýazgy aç-açan. Ýazgy we jaňdan soňky jemleýji hasabatlar jaň aýratynlyklarydyr
siz mümkinçilik berýärsiňiz — jaň sesi bilen baglanyşykly işleri ýerli razyçylyk/saklama düzgünleriňize görä işleýärsiňiz.
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP ses agentiňizi telefonyň başynda goýýar.** Ol jogap berýär we islendik standart SIP trunk arkaly hakyky jaňlary amala aşyrýar, jaň wagtynda göni söz görnüşini işledýär we jaň gutaranda size ýazgy we jaňdan soňky gysgaça bellik berýär. Ol **operatora garaşsyz**: bu açyk SIP-iň dilini ulanar, şonuň üçin daşky üpjün ediji bilen çäklendirilme ýok — ony telefonyňyzyň üpjün edijisi beren haýsy trunk bolsa şoňa gönükdiriň.
Plugin myhman-tanalyjyny işledýär we birlikde birleşdirýär `baresip` (SIP/RTP ugry), bir **ALSA gaýtadan baglanyşyk** ses ýoly we çagyrşyk bilen geçelginiň ses öwrülişi arasynda sesi geçiren kiçi Python köprüsü. Ol geçelge bilen aragatnaşyk edýär `aihummer.service.v1` şertnama. Ahyry ulanyjy kanalyň hereketi kanal sahypasynda bar [SIP](/tk/v1.0/channels/sip); bu sahypa pluginiň özüni öz içine alýar.
## Faktlar
| Merkez | Bahasy |
|---|---|
| Wersiýa | 25.1.0 |
| Saglyk porty | 8830 |
| SIP diňle | 5062 |
| baresip dolandyryşy | 4444 |
| Iş wagty | baresip + ALSA loopback + Python köpri, myhman-öz-özüni |
## Ol näme
Telefon jaňy bilen AiHummer öwrülişiň arasynda bir köprü. Jaň baglanyşanda, ses akýar `baresip` ALSA loopback arkaly Python köprüsine, ol ýerine ýetirýän **daşky sözden ýazga → agentiň nobaty → ýazgydan sözleýiş** döwr edýär we jogaby gaýtadan jaňyň içine oýnaýar. Iki ses enjamy bar:
- **`yandex`** — çalt wagtda bulut ses motory.
- **`local`** — doly özbaşdak oturdylan, ulanyp `faster-whisper` STT üçin we `edge-tts`
TTS üçin.
## Ol nähili ulanylýar
Jaň wagty agent diňe geplemekden başga zatlar hem edip biler:
- **`ask_assistant`** — jaň edene jogap bermek üçin jaň agentliginde bir nobat işleýär.
- **`send_dtmf`** — DTMF tonlaryny çykar (meselem, IVR arkaly ýöretmek ýa-da kody girizmek üçin).
- **ýazgy** — jaň sesini ýazga alyň.
- **arasyna girmek** — jaň ediji agentiň çykyşyna tebigy ýagdaýda päsgel bermäge rugsat beriň.
- **jaňdan soňky gysgaça maglumat** — jaň gutarandan soň beýannama düz.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Aýratynlyk möçberi
> [!WARNING]
> SIP plaginini goldaýar **STT, TTS, aralaşmak, DTMF we diňe ýazgy.** Ol
> etýär **däk** sözlü terjime üpjün etmek — bu başga bir esasy kuwwat
> (seret [Sözlü terjimä we wideo](/tk/v1.0/voice/diarization-translation-clone))
> we SIP jaň ugrynyň bir bölegi däldir. Telefon jaňynda munuň bardygyny çaklama.
## Gurnama
Admin UI-de marketplace-den bir basyş bilen SIP Voice gurnuň. Host-native deployer plugin-i göçürýär, gurmak ädimini ýerine ýetirýär, howpsuzlykda çäklendirilmiş systemd unit döredýär we saglyk nokadyny garaşýar, soňra onuň taýýardygyny belläp berýär — serediň [Gurnama we täzelenmeler](/tk/v1.0/marketplace/install-updates). Soňra siz SIP şlýuz görkezmelerini sazlaýarsyňyz we saýlaýarsyňyz `yandex` ýa-da `local` motory.
> [!TIP]
> Doly öz öňünden ýylman çykarylan, tölegsiz modeller bilen işläp bilýän ulgam üçin, saýlaň **`local`** motory:
> `faster-whisper` we `edge-tts` Diňleýän sesiň beýik öňüni öz serweriňizde saklaň.
## Howpsuzlyk we çäklendirmeler
- **Operatora garaşsyz magistral.** Standart SIP trunk, daşlaýjy çäklendirmesi ýok; codec, DTMF we ugrukdyryş gabatlylygyny barla.
- **Çäk STT/TTS/DTMF/ ýazgy/ aralyk girmegi öz içine alýar.** Sözlü terjime ýok
ugur çagyryşy (bu esasy öňdebaryjy häsiýetdir).
- **Mehman-jaýly** `baresip`, loopback we köprü systemd astynda işleýär, däldir
gapda.
- **Ýazgy aç-açan.** Ýazgy we jaňdan soňky jemleýji hasabatlar jaň aýratynlyklarydyr
siz mümkinçilik berýärsiňiz — jaň sesi bilen baglanyşykly işleri ýerli razyçylyk/saklama düzgünleriňize görä işleýärsiňiz.
## Indi nire?
- Kanal: [SIP](/tk/v1.0/channels/sip)
- [Sözlü girişi/çykşy (STT/TTS)](/tk/v1.0/voice/stt-tts)
- [Gurnama we täzelenmeler](/tk/v1.0/marketplace/install-updates)