SIP Səs agentinizi telefona qoyur. O, istənilən standart SIP trunk üzərindən
real zəngləri cavablandırır və yerləşdirir, zəng zamanı canlı nitq növbəsi işə
salır və zəng bitdikdə sizə qeyd və zəngdən sonrakı xülasə təqdim edir. O,
operator-neytraldır: sadə SIP danışır, beləliklə operator kilidi (carrier
lock-in) yoxdur — onu telefoniya provayderinizin verdiyi istənilən trunk-a yönəldin.
Plagin host-native işləyir və baresip (SIP/RTP son nöqtəsi), ALSA loopback
audio yolu və zəng ilə gateway-in səs növbəsi arasında audionu daşıyan kiçik bir
Python körpüsünü bir araya gətirir. O, gateway ilə müqavilə üzərindən danışır.
Son istifadəçi kanal davranışı kanal səhifəsindədir SIP;
bu səhifə plaginin özünü əhatə edir.
Telefon zəngi ilə AiHummer növbəsi arasında körpü. Zəng qoşulduqda, audio
baresip-dən ALSA loopback vasitəsilə Python körpüsünə axır, körpü
nitqdən-mətnə → agent növbəsi → mətndən-nitqə dövrünü işə salır və cavabı
zəngə geri oxudur. İki nitq mühərriki mövcuddur:
yandex — real-vaxt bulud nitq mühərriki.
local — tamamilə öz-özünə hostlanan, STT üçün faster-whisper və TTS
üçün edge-tts istifadə edən.
Necə istifadə olunur
Zəng zamanı agent sadəcə danışmaqdan daha çoxunu edə bilər:
ask_assistant — zəng edənə cavab vermək üçün zəng içi agent növbəsi işə salır.
send_dtmf — DTMF tonları yayır (məs. IVR-də naviqasiya etmək və ya kod daxil etmək üçün).
qeydetmə — zəng audiosunu tutur.
barge-in — zəng edənin agentin nitqini təbii şəkildə kəsməsinə imkan verir.
zəngdən sonrakı xülasə — zəng bitdikdə xülasə hazırlayır.
[!WARNING]
SIP plagini yalnız STT, TTS, barge-in, DTMF və qeydetməni dəstəkləyir. O,
spiker diarizasiyası, nitq tərcüməsi və ya səs klonlaması təqdim etmir.
Bunlar ayrı core/sidecar imkanlarıdır (baxın
Diarizasiya, tərcümə və klonlama)
və SIP zəng yolunun bir hissəsi deyil. Telefon zəngində onları gözləməyin.
Quraşdırma
SIP Səs-i admin UI-dakı marketplace-dən bir kliklə quraşdırın. Host-native
yerləşdirici plagini yükləyir, onun quraşdırma addımını işə salır, qum
qutusunda (sandboxed) systemd vahidi yaradır və hazır kimi qeyd etməzdən əvvəl
sağlamlıq son nöqtəsini gözləyir — baxın Quraşdırma və yeniləmələr.
Sonra SIP trunk məlumatlarınızı konfiqurasiya edir və yandex və ya local
mühərrikini seçirsiniz.
[!TIP]
Tamamilə öz-özünə hostlanan, pullu-modelsiz quraşdırma üçün local
mühərrikini seçin: faster-whisper və edge-tts bütün səs yolunu öz
hostunuzda saxlayır.
Təhlükəsizlik və məhdudiyyətlər
Operator-neytral trunk. Standart SIP, operator kilidi yoxdur.
Əhatə STT/TTS/DTMF/qeydetmə/barge-in-dir. Zəng yolunda diarizasiya,
tərcümə və ya səs klonu yoxdur.
Host-native.baresip, loopback və körpü konteynerdə deyil, systemd
altında işləyir.
Qeydetmə açıqdır. Qeydetmə və zəngdən sonrakı xülasələr sizin
aktivləşdirdiyiniz zəng funksiyalarıdır — zəng audiosunu yerli razılıq/saxlama
qaydalarınıza uyğun idarə edin.
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP Səs agentinizi telefona qoyur.** O, istənilən standart SIP trunk üzərindən
real zəngləri cavablandırır və yerləşdirir, zəng zamanı canlı nitq növbəsi işə
salır və zəng bitdikdə sizə qeyd və zəngdən sonrakı xülasə təqdim edir. O,
**operator-neytraldır**: sadə SIP danışır, beləliklə operator kilidi (carrier
lock-in) yoxdur — onu telefoniya provayderinizin verdiyi istənilən trunk-a yönəldin.
Plagin host-native işləyir və `baresip` (SIP/RTP son nöqtəsi), **ALSA loopback**
audio yolu və zəng ilə gateway-in səs növbəsi arasında audionu daşıyan kiçik bir
Python körpüsünü bir araya gətirir. O, gateway ilə müqavilə üzərindən danışır.
Son istifadəçi kanal davranışı kanal səhifəsindədir [SIP](/en/v1.0/channels/sip);
bu səhifə plaginin özünü əhatə edir.
## Faktlar
| Sahə | Dəyər |
|---|---|
| Versiya | 25.1.0 |
| Sağlamlıq portu | 8830 |
| SIP dinləmə | 5062 |
| baresip idarəetmə | 4444 |
| İcra mühiti | baresip + ALSA loopback + Python körpüsü, host-native |
## Bu nədir
Telefon zəngi ilə AiHummer növbəsi arasında körpü. Zəng qoşulduqda, audio
`baresip`-dən ALSA loopback vasitəsilə Python körpüsünə axır, körpü
**nitqdən-mətnə → agent növbəsi → mətndən-nitqə** dövrünü işə salır və cavabı
zəngə geri oxudur. İki nitq mühərriki mövcuddur:
- **`yandex`** — real-vaxt bulud nitq mühərriki.
- **`local`** — tamamilə öz-özünə hostlanan, STT üçün `faster-whisper` və TTS
üçün `edge-tts` istifadə edən.
## Necə istifadə olunur
Zəng zamanı agent sadəcə danışmaqdan daha çoxunu edə bilər:
- **`ask_assistant`** — zəng edənə cavab vermək üçün zəng içi agent növbəsi işə salır.
- **`send_dtmf`** — DTMF tonları yayır (məs. IVR-də naviqasiya etmək və ya kod daxil etmək üçün).
- **qeydetmə** — zəng audiosunu tutur.
- **barge-in** — zəng edənin agentin nitqini təbii şəkildə kəsməsinə imkan verir.
- **zəngdən sonrakı xülasə** — zəng bitdikdə xülasə hazırlayır.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Funksiya əhatəsi
> [!WARNING]
> SIP plagini **yalnız STT, TTS, barge-in, DTMF və qeydetməni** dəstəkləyir. O,
> spiker diarizasiyası, nitq tərcüməsi və ya səs klonlaması **təqdim etmir.**
> Bunlar ayrı core/sidecar imkanlarıdır (baxın
> [Diarizasiya, tərcümə və klonlama](/en/v1.0/voice/diarization-translation-clone))
> və SIP zəng yolunun bir hissəsi deyil. Telefon zəngində onları gözləməyin.
## Quraşdırma
SIP Səs-i admin UI-dakı marketplace-dən bir kliklə quraşdırın. Host-native
yerləşdirici plagini yükləyir, onun quraşdırma addımını işə salır, qum
qutusunda (sandboxed) systemd vahidi yaradır və hazır kimi qeyd etməzdən əvvəl
sağlamlıq son nöqtəsini gözləyir — baxın [Quraşdırma və yeniləmələr](/en/v1.0/marketplace/install-updates).
Sonra SIP trunk məlumatlarınızı konfiqurasiya edir və `yandex` və ya `local`
mühərrikini seçirsiniz.
> [!TIP]
> Tamamilə öz-özünə hostlanan, pullu-modelsiz quraşdırma üçün **`local`**
> mühərrikini seçin: `faster-whisper` və `edge-tts` bütün səs yolunu öz
> hostunuzda saxlayır.
## Təhlükəsizlik və məhdudiyyətlər
- **Operator-neytral trunk.** Standart SIP, operator kilidi yoxdur.
- **Əhatə STT/TTS/DTMF/qeydetmə/barge-in-dir.** Zəng yolunda diarizasiya,
tərcümə və ya səs klonu yoxdur.
- **Host-native.** `baresip`, loopback və körpü konteynerdə deyil, systemd
altında işləyir.
- **Qeydetmə açıqdır.** Qeydetmə və zəngdən sonrakı xülasələr sizin
aktivləşdirdiyiniz zəng funksiyalarıdır — zəng audiosunu yerli razılıq/saxlama
qaydalarınıza uyğun idarə edin.
## Sonra hara
- Kanal: [SIP](/en/v1.0/channels/sip)
- [Səs giriş/çıxış (STT/TTS)](/en/v1.0/voice/stt-tts)
- [Quraşdırma və yeniləmələr](/en/v1.0/marketplace/install-updates)