SIP Voice сіздің агентіңізді телефонға қоныстырады. Бұл кез келген стандартты SIP тізбегі арқылы нақты қоңырауларға жауап береді және қояды, қоңырау барысында тікелей сөйлесу айналымын жүргізеді және қоңырау аяқталғаннан кейін сізге жазбаны және қоңыраудан кейінгі қорытындыны береді. Бұл оператордан тәуелсіз: ол қарапайым SIP-пен сөйлеседі, сондықтан тасымалдаушыға байланып қалмайды — оны сіздің телекоммуникациялық провайдеріңіз берген кез келген тармаққа бағыттаңыз.
Плагин хост-та туған түрде жұмыс істейді және біріктіреді baresip (SIP/RTP соңы), бір ALSA кері байланыс аудио жолы және қоңырау мен шлюздің дауыс тізбегі арасындағы аудионы ауыстыратын шағын Python көпірі. Ол шлюзбен арқылы сөйлеседі aihummer.service.v1 келісім-шарт. Соңғы пайдаланушы арнасының мінез-құлқы арна бетінде көрсетіледі SIP; бұл бет плагиннің өзін қамтиды.
Телефон қоңырауы мен AiHummer бұрылыс арасындағы көпір. Қоңырау қосылған кезде, дыбыс ағады baresip ALSA циклдік байланысы арқылы Python көпіріне, ол іске қосылады дауыстан мәтінге → агент кезеңі → мәтіннен дауыстқа цикл жасап, жауапты қоңырауға қайта ойнатады. Екі дауысты қозғалтқыш қолжетімді:
yandex — нақты уақыттағы бұлтты сөйлеу қозғалтқышы.
local — толық өзіндік орналастырылған, пайдаланып faster-whisper STT және edge-tts
TTS үшін.
Оны қалай қолдануға болады
Қоңырау кезінде агент тек сөйлесе қана қоймай, басқаларын да істей алады:
ask_assistant — қоңырау шалушыға жауап беру үшін қоңырау кезінде агенттің кезегін іске қосыңыз.
send_dtmf — DTMF тондарын жіберу (мысалы, IVR арқылы өту немесе код енгізу үшін).
жазба — қоңырау дыбысын жазу.
араласып кіру — қоңырау шалушының агенттің сөйлеуін табиғи түрде бөліп тұруына мүмкіндік беріңіз.
қоңыраудан кейінгі қорыту — қоңырау аяқталғаннан кейін қысқаша мазмұнын жасаңыз.
[!WARNING]
SIP плагині қолдайды STT, TTS, барж-іну, DTMF және тек жазу. Оны
жасайды емес сөйлесуді аударуды қамтамасыз ету — бұл бөлек негізгі мүмкіндік
(қараңыз Сөйлеу аудармасы және видео)
және SIP қоңырау жолының бөлігі емес. Телефон қоңырауында оны ойдан шығармаңыз.
Орнату
Әкімші интерфейсіндегі нарықтан SIP Voice бағдарламасын бір рет басу арқылы орнатыңыз. Хостқа тән орналастырушы плагинді жүктейді, орнату қадамын іске қосады, оқшауланған systemd бірлігін көрсетеді және дайын деп белгілеуден бұрын денсаулық сақтау ұштағанын күтеді — қараңыз Орнату және жаңартулар. Содан кейін сіз SIP транкі тіркелгі деректерін баптап, таңдайсыз yandex немесе local қозғалтқыш.
[!TIP]
Толық өздігінен орналастырылған, төлемсіз модельдер орнату үшін таңдаңыз local қозғалтқыш:
faster-whisper және edge-tts дауыстық жолдың барлығын өзіңіздің серверіңізде сақтаңыз.
Қамтылу аясы: STT/TTS/DTMF/жазу/байланысқа кіру. Дауыстық аударма жоқ
қоңырау жолы (яғни негізгі мүмкіндік).
Қожайын-жергілікті.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 кері байланыс** аудио жолы және қоңырау мен шлюздің дауыс тізбегі арасындағы аудионы ауыстыратын шағын Python көпірі. Ол шлюзбен арқылы сөйлеседі `aihummer.service.v1` келісім-шарт. Соңғы пайдаланушы арнасының мінез-құлқы арна бетінде көрсетіледі [SIP](/kk/v1.0/channels/sip); бұл бет плагиннің өзін қамтиды.
## Дәлілдер
| Дала | Мән |
|---|---|
| Нұсқа | 25.1.0 |
| Денсаулық порты | 8830 |
| SIP тыңдау | 5062 |
| baresip басқару | 4444 |
| Жүру уақыты | baresip + ALSA loopback + Python көпірі, хост-туынды |
## Бұл дегеніміз не
Телефон қоңырауы мен AiHummer бұрылыс арасындағы көпір. Қоңырау қосылған кезде, дыбыс ағады `baresip` ALSA циклдік байланысы арқылы Python көпіріне, ол іске қосылады **дауыстан мәтінге → агент кезеңі → мәтіннен дауыстқа** цикл жасап, жауапты қоңырауға қайта ойнатады. Екі дауысты қозғалтқыш қолжетімді:
- **`yandex`** — нақты уақыттағы бұлтты сөйлеу қозғалтқышы.
- **`local`** — толық өзіндік орналастырылған, пайдаланып `faster-whisper` STT және `edge-tts`
TTS үшін.
## Оны қалай қолдануға болады
Қоңырау кезінде агент тек сөйлесе қана қоймай, басқаларын да істей алады:
- **`ask_assistant`** — қоңырау шалушыға жауап беру үшін қоңырау кезінде агенттің кезегін іске қосыңыз.
- **`send_dtmf`** — DTMF тондарын жіберу (мысалы, IVR арқылы өту немесе код енгізу үшін).
- **жазба** — қоңырау дыбысын жазу.
- **араласып кіру** — қоңырау шалушының агенттің сөйлеуін табиғи түрде бөліп тұруына мүмкіндік беріңіз.
- **қоңыраудан кейінгі қорыту** — қоңырау аяқталғаннан кейін қысқаша мазмұнын жасаңыз.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Функцияның ауқымы
> [!WARNING]
> SIP плагині қолдайды **STT, TTS, барж-іну, DTMF және тек жазу.** Оны
> жасайды **емес** сөйлесуді аударуды қамтамасыз ету — бұл бөлек негізгі мүмкіндік
> (қараңыз [Сөйлеу аудармасы және видео](/kk/v1.0/voice/diarization-translation-clone))
> және SIP қоңырау жолының бөлігі емес. Телефон қоңырауында оны ойдан шығармаңыз.
## Орнату
Әкімші интерфейсіндегі нарықтан SIP Voice бағдарламасын бір рет басу арқылы орнатыңыз. Хостқа тән орналастырушы плагинді жүктейді, орнату қадамын іске қосады, оқшауланған systemd бірлігін көрсетеді және дайын деп белгілеуден бұрын денсаулық сақтау ұштағанын күтеді — қараңыз [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates). Содан кейін сіз SIP транкі тіркелгі деректерін баптап, таңдайсыз `yandex` немесе `local` қозғалтқыш.
> [!TIP]
> Толық өздігінен орналастырылған, төлемсіз модельдер орнату үшін таңдаңыз **`local`** қозғалтқыш:
> `faster-whisper` және `edge-tts` дауыстық жолдың барлығын өзіңіздің серверіңізде сақтаңыз.
## Қауіпсіздік және шектеулер
- **Операторға бейтарап магистраль.** Стандартты SIP trunk, тасымалдаушымен шектелген жоқ; кодек, DTMF және бағыттау үйлесімділігін тексеріңіз.
- **Қамтылу аясы: STT/TTS/DTMF/жазу/байланысқа кіру.** Дауыстық аударма жоқ
қоңырау жолы (яғни негізгі мүмкіндік).
- **Қожайын-жергілікті.** `baresip`, loopback және көпір systemd аясында жұмыс істейді, жоқ
контейнерде.
- **Жазба анық.** Жазба және қоңырау соңындағы қорытындылар қоңырау мүмкіндіктері болып табылады
сіз қосасыз — қоңырау дыбысын жергілікті келісім/сақтау ережелеріңізге сәйкес өңдейсіз.
## Келесі қайда
- Арна: [SIP](/kk/v1.0/channels/sip)
- [Дыбыс кірісі/шығысы (STT/TTS)](/kk/v1.0/voice/stt-tts)
- [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates)