SIP Ses siziň agentiňizi telefona goýýar. Ol islendik standart SIP trunk
arkaly hakyky jaňlary jogaplaýar we edýär, jaňyň dowamynda janly geplemek
aýlamasyny işledýär, jaň gutaranda size ýazgy we jaňdan soňky jemleme berýär. Ol
operatordan garaşsyz: ol arassa SIP gepleýär, şonuň üçin operator
baglanyşygy ýok — ony telefoniýa üpjün edijiňiziň berýän islendik trunkyna
gönükdiriň.
Plagin host-natiwe işleýär we baresip-i (SIP/RTP endpoint), ALSA loopback
ses ýoluny, we jaň bilen gateway-iň ses aýlamasynyň arasynda sesi geçirýän kiçi
Python köprini birleşdirýär. Ol şertnama arkaly gateway bilen gepleşýär. Ahyrky
ulanyjy kanalynyň özüni alyp barşy kanal sahypasynda SIP;
bu sahypa plaginiň özüni öz içine alýar.
Telefon jaňy bilen AiHummer aýlamasynyň arasyndaky köpri. Jaň birikende, ses
baresip-den ALSA loopback arkaly Python köprä akýar, ol sözden tekste →
agent aýlamasy → tekstden söze sikli işledýär we jogaby yzyna jaňa çalýar. Iki
geplemek hereketlendirijisi bar:
[!WARNING]
SIP plagini diňe STT, TTS, barge-in, DTMF we ýazgyny goldaýar. Ol geplän
diarizasiýasyny, geplemek terjimesini ýa-da ses klonlamagy bermeýär. Bular
aýratyn core/sidecar mümkinçilikleri (serediň
Diarizasiýa, terjime we klonlama)
we SIP jaň ýolunyň bölegi däl. Olary telefon jaňynda çaklamaň.
Gurnama
SIP Ses-i admin UI-däki marketdan bir gezek basmak bilen gurnaň. Host-natiwe
deployer plagini ýükläp alýar, onuň gurnama ädimini işledýär, sandbox-laşan
systemd birligini çykarýar we taýýar diýip bellemezden öň saglyk endpoint-ine
garaşýar — serediň Gurnama we täzelenmeler.
Soňra siz öz SIP trunk maglumatlaryňyzy sazlaýarsyňyz we yandex ýa-da local
hereketlendirijisini saýlaýarsyňyz.
[!TIP]
Doly öz hostuňyzda işleýän, töleg-modelsiz gurnama üçin local
hereketlendirijisini saýlaň: faster-whisper we edge-tts ähli ses ýoluny
öz hostuňyzda saklaýar.
Howpsuzlyk we çäklendirmeler
Operatordan garaşsyz trunk. Standart SIP, operator baglanyşygy ýok.
Gerim STT/TTS/DTMF/ýazga/barge-in. Jaň ýolunda diarizasiýa, terjime ýa-da
ses klony ýok.
Host-natiwe.baresip, loopback we köpri konteýnerde däl-de, systemd
astynda işleýär.
Ýazga aç-açan. Ýazga we jaňdan soňky jemlemeler siziň açýan jaň
aýratynlyklaryňyz — jaň sesini ýerli razylyk/saklama düzgünleriňize görä
dolandyryň.
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP Ses siziň agentiňizi telefona goýýar.** Ol islendik standart SIP trunk
arkaly hakyky jaňlary jogaplaýar we edýär, jaňyň dowamynda janly geplemek
aýlamasyny işledýär, jaň gutaranda size ýazgy we jaňdan soňky jemleme berýär. Ol
**operatordan garaşsyz**: ol arassa SIP gepleýär, şonuň üçin operator
baglanyşygy ýok — ony telefoniýa üpjün edijiňiziň berýän islendik trunkyna
gönükdiriň.
Plagin host-natiwe işleýär we `baresip`-i (SIP/RTP endpoint), **ALSA loopback**
ses ýoluny, we jaň bilen gateway-iň ses aýlamasynyň arasynda sesi geçirýän kiçi
Python köprini birleşdirýär. Ol şertnama arkaly gateway bilen gepleşýär. Ahyrky
ulanyjy kanalynyň özüni alyp barşy kanal sahypasynda [SIP](/en/v1.0/channels/sip);
bu sahypa plaginiň özüni öz içine alýar.
## Maglumatlar
| Meýdan | Bahasy |
|---|---|
| Wersiýa | 25.1.0 |
| Saglyk porty | 8830 |
| SIP diňleme | 5062 |
| baresip dolandyryş | 4444 |
| Runtime | baresip + ALSA loopback + Python köpri, host-native |
## Bu näme
Telefon jaňy bilen AiHummer aýlamasynyň arasyndaky köpri. Jaň birikende, ses
`baresip`-den ALSA loopback arkaly Python köprä akýar, ol **sözden tekste →
agent aýlamasy → tekstden söze** sikli işledýär we jogaby yzyna jaňa çalýar. Iki
geplemek hereketlendirijisi bar:
- **`yandex`** — realtime bulut geplemek hereketlendirijisi.
- **`local`** — STT üçin `faster-whisper` we TTS üçin `edge-tts` ulanyp, doly öz
hostuňyzda işleýän.
## Ol nähili ulanylýar
Jaň wagtynda agent diňe gürlemekden başga zat edip biler:
- **`ask_assistant`** — jaň edýäne jogap bermek üçin jaň içinde agent aýlamasyny
işletmek.
- **`send_dtmf`** — DTMF tonlaryny çykarmak (mysal üçin, IVR-de gezmek ýa-da kod
girizmek üçin).
- **ýazga** — jaň sesini ýazga almak.
- **barge-in** — jaň edýäniň agentiň geplemegini tebigy ýagdaýda bölmegine rugsat bermek.
- **jaňdan soňky jemleme** — jaň gutaranda jemleme öndürmek.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Aýratynlyk gerimi
> [!WARNING]
> SIP plagini **diňe STT, TTS, barge-in, DTMF we ýazgyny goldaýar.** Ol geplän
> diarizasiýasyny, geplemek terjimesini ýa-da ses klonlamagy **bermeýär.** Bular
> aýratyn core/sidecar mümkinçilikleri (serediň
> [Diarizasiýa, terjime we klonlama](/en/v1.0/voice/diarization-translation-clone))
> we SIP jaň ýolunyň bölegi däl. Olary telefon jaňynda çaklamaň.
## Gurnama
SIP Ses-i admin UI-däki marketdan bir gezek basmak bilen gurnaň. Host-natiwe
deployer plagini ýükläp alýar, onuň gurnama ädimini işledýär, sandbox-laşan
systemd birligini çykarýar we taýýar diýip bellemezden öň saglyk endpoint-ine
garaşýar — serediň [Gurnama we täzelenmeler](/en/v1.0/marketplace/install-updates).
Soňra siz öz SIP trunk maglumatlaryňyzy sazlaýarsyňyz we `yandex` ýa-da `local`
hereketlendirijisini saýlaýarsyňyz.
> [!TIP]
> Doly öz hostuňyzda işleýän, töleg-modelsiz gurnama üçin **`local`**
> hereketlendirijisini saýlaň: `faster-whisper` we `edge-tts` ähli ses ýoluny
> öz hostuňyzda saklaýar.
## Howpsuzlyk we çäklendirmeler
- **Operatordan garaşsyz trunk.** Standart SIP, operator baglanyşygy ýok.
- **Gerim STT/TTS/DTMF/ýazga/barge-in.** Jaň ýolunda diarizasiýa, terjime ýa-da
ses klony ýok.
- **Host-natiwe.** `baresip`, loopback we köpri konteýnerde däl-de, systemd
astynda işleýär.
- **Ýazga aç-açan.** Ýazga we jaňdan soňky jemlemeler siziň açýan jaň
aýratynlyklaryňyz — jaň sesini ýerli razylyk/saklama düzgünleriňize görä
dolandyryň.
## Indiki nirä
- Kanal: [SIP](/en/v1.0/channels/sip)
- [Sesi içeri/daşary (STT/TTS)](/en/v1.0/voice/stt-tts)
- [Gurnama we täzelenmeler](/en/v1.0/marketplace/install-updates)