Плагинҳои расмӣ / Плагини овозии SIP
Плагини овозии SIP v1.0.x · навсозӣ шуд 2026-06-26 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
SIP Voice агенти шуморо ба телефон мегузорад. Он зангҳои воқеиро тавассути ҳар
trunk-и стандартии SIP ҷавоб медиҳад ва мекунад, дар вақти занг як turn-и зиндаи
нутқро иҷро мекунад ва ҳангоми анҷоми занг ба шумо як сабт ва ҷамъбасти пас аз
зангро медиҳад. Он аз оператор мустақил аст: бо SIP-и оддӣ гуфтугӯ мекунад,
бинобар ин қулфшавӣ ба оператор нест — онро ба ҳар trunk-е, ки таъминкунандаи
телефонии шумо медиҳад, нишон диҳед.
Плагин ба таври host-native кор мекунад ва baresip (нуқтаи ниҳоии SIP/RTP), як
роҳи аудиои ALSA loopback ва як пули хурди Python, ки аудиоро байни занг ва
turn-и овозии gateway интиқол медиҳад, ба ҳам мепайвандад. Он бо gateway тавассути
қарордод гуфтугӯ мекунад. Рафтори канал барои корбари ниҳоӣ дар саҳифаи канали
SIP аст; ин саҳифа худи плагинро фаро мегирад.
Далелҳо
Майдон
Қимат
Версия
25.1.0
Порти саломатӣ
8830
Гӯшкунии SIP
5062
Контроли baresip
4444
Runtime
baresip + ALSA loopback + пули Python, host-native
Он чист
Пуле байни занги телефонӣ ва turn-и AiHummer. Вақте занг пайваст мешавад, аудио аз
baresip тавассути ALSA loopback ба пули Python ҷорӣ мешавад, ки сикли
нутқ-ба-матн → turn-и агент → матн-ба-нутқ -ро иҷро мекунад ва ҷавобро ба занг
бозмепазад. Ду муҳаррики нутқ дастрас аст:
yandex — муҳаррики нутқи абрии реалвақт.
local — комилан худмизбон, бо истифода аз faster-whisper барои STT ва
edge-tts барои TTS.
Чӣ тавр истифода мешавад
Дар вақти занг агент метавонад бештар аз танҳо гап задан кунад:
ask_assistant — як turn-и агенти дохили зангро барои ҷавоб додан ба
зангзананда иҷро кунад.
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 насб кунед. Деплойери host-native
плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и
изолятсияшударо ренд мекунад ва пеш аз омода эълон кардан, мунтазири нуқтаи ниҳоии
саломатӣ мешавад — нигаред ба Насб ва навсозиҳо .
Сипас шумо маълумоти trunk-и SIP-и худро танзим мекунед ва муҳаррики yandex ё
local-ро интихоб мекунед.
[!TIP]
Барои танзими комилан худмизбон ва бидуни моделҳои пулакӣ, муҳаррики local -ро
интихоб кунед: faster-whisper ва edge-tts тамоми роҳи овозро дар мизбони худи
шумо нигоҳ медоранд.
Амният ва маҳдудиятҳо
Trunk-и аз оператор мустақил. SIP-и стандартӣ, бидуни қулфшавӣ ба оператор.
Доира STT/TTS/DTMF/сабт/barge-in аст. Бидуни диаризатсия, тарҷума ё клони овоз
дар роҳи занг.
Host-native. baresip, loopback ва пул зери systemd кор мекунанд, на дар
контейнер.
Сабт возеҳ аст. Сабт ва ҷамъбастҳои пас аз занг хусусиятҳои зангеанд, ки
шумо фаъол мекунед — бо аудиои занг мувофиқи қоидаҳои маҳаллии розигӣ/нигоҳдории
худ муносибат кунед.
Минбаъд ба куҷо
← Қаблӣ
Einstein (плагини хотира)
Баъдӣ →
Плагини Pocket Agent
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP Voice агенти шуморо ба телефон мегузорад.** Он зангҳои воқеиро тавассути ҳар
trunk-и стандартии SIP ҷавоб медиҳад ва мекунад, дар вақти занг як turn-и зиндаи
нутқро иҷро мекунад ва ҳангоми анҷоми занг ба шумо як сабт ва ҷамъбасти пас аз
зангро медиҳад. Он **аз оператор мустақил** аст: бо SIP-и оддӣ гуфтугӯ мекунад,
бинобар ин қулфшавӣ ба оператор нест — онро ба ҳар trunk-е, ки таъминкунандаи
телефонии шумо медиҳад, нишон диҳед.
Плагин ба таври host-native кор мекунад ва `baresip` (нуқтаи ниҳоии SIP/RTP), як
роҳи аудиои **ALSA loopback** ва як пули хурди Python, ки аудиоро байни занг ва
turn-и овозии gateway интиқол медиҳад, ба ҳам мепайвандад. Он бо gateway тавассути
қарордод гуфтугӯ мекунад. Рафтори канал барои корбари ниҳоӣ дар саҳифаи канали
[SIP](/en/v1.0/channels/sip) аст; ин саҳифа худи плагинро фаро мегирад.
## Далелҳо
| Майдон | Қимат |
|---|---|
| Версия | 25.1.0 |
| Порти саломатӣ | 8830 |
| Гӯшкунии SIP | 5062 |
| Контроли baresip | 4444 |
| Runtime | baresip + ALSA loopback + пули Python, host-native |
## Он чист
Пуле байни занги телефонӣ ва turn-и AiHummer. Вақте занг пайваст мешавад, аудио аз
`baresip` тавассути ALSA loopback ба пули Python ҷорӣ мешавад, ки сикли
**нутқ-ба-матн → turn-и агент → матн-ба-нутқ**-ро иҷро мекунад ва ҷавобро ба занг
бозмепазад. Ду муҳаррики нутқ дастрас аст:
- **`yandex`** — муҳаррики нутқи абрии реалвақт.
- **`local`** — комилан худмизбон, бо истифода аз `faster-whisper` барои STT ва
`edge-tts` барои TTS.
## Чӣ тавр истифода мешавад
Дар вақти занг агент метавонад бештар аз танҳо гап задан кунад:
- **`ask_assistant`** — як turn-и агенти дохили зангро барои ҷавоб додан ба
зангзананда иҷро кунад.
- **`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 насб кунед. Деплойери host-native
плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и
изолятсияшударо ренд мекунад ва пеш аз омода эълон кардан, мунтазири нуқтаи ниҳоии
саломатӣ мешавад — нигаред ба [Насб ва навсозиҳо](/en/v1.0/marketplace/install-updates).
Сипас шумо маълумоти trunk-и SIP-и худро танзим мекунед ва муҳаррики `yandex` ё
`local`-ро интихоб мекунед.
> [!TIP]
> Барои танзими комилан худмизбон ва бидуни моделҳои пулакӣ, муҳаррики **`local`**-ро
> интихоб кунед: `faster-whisper` ва `edge-tts` тамоми роҳи овозро дар мизбони худи
> шумо нигоҳ медоранд.
## Амният ва маҳдудиятҳо
- **Trunk-и аз оператор мустақил.** 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)