Plugin SIP Voice

v1.0.x · actualizat 2026-06-26

SIP Voice îți pune agentul la telefon. Răspunde și inițiază apeluri reale prin orice trunk SIP standard, execută un tur de vorbire live în timpul apelului și îți oferă o înregistrare și un rezumat post-apel când apelul se încheie. Este neutru față de operator: vorbește SIP simplu, deci nu există blocare la operator — îndreaptă-l către orice trunk îți oferă furnizorul tău de telefonie.

Plugin-ul rulează nativ pe gazdă și îmbină baresip (endpoint-ul SIP/RTP), o cale audio ALSA loopback și o mică punte Python care mută audio între apel și turul de voce al gateway-ului. Comunică cu gateway-ul prin contract. Comportamentul canalului pentru utilizatorul final este pe pagina de canal SIP; această pagină acoperă plugin-ul în sine.

Fapte

Câmp	Valoare
Versiune	25.1.0
Port de sănătate	8830
Ascultare SIP	5062
Control baresip	4444
Runtime	baresip + ALSA loopback + punte Python, nativ pe gazdă

Ce este

O punte între un apel telefonic și un tur AiHummer. Când un apel se conectează, audio curge de la baresip prin ALSA loopback în puntea Python, care rulează un ciclu speech-to-text → tur de agent → text-to-speech și redă răspunsul înapoi în apel. Sunt disponibile două motoare de vorbire:

yandex — un motor de vorbire cloud în timp real.
local — complet self-hosted, folosind faster-whisper pentru STT și edge-tts pentru TTS.

Cum se folosește

În timpul unui apel, agentul poate face mai mult decât doar să vorbească:

ask_assistant — rulează un tur de agent în apel pentru a răspunde apelantului.
send_dtmf — emite tonuri DTMF (de ex. pentru a naviga un IVR sau a introduce un cod).
înregistrare — captează audio-ul apelului.
barge-in — permite apelantului să întrerupă natural vorbirea agentului.
rezumat post-apel — produce un rezumat odată ce apelul se încheie.

caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller

Domeniul de funcționalități

[!WARNING] Plugin-ul SIP suportă doar STT, TTS, barge-in, DTMF și înregistrare. Nu oferă diarizarea vorbitorilor, traducerea vorbirii sau clonarea vocii. Acestea sunt capabilități separate de core/sidecar (vezi Diarizare, traducere și clonare) și nu fac parte din calea de apel SIP. Nu le presupune într-un apel telefonic.

Instalare

Instalează SIP Voice dintr-un singur click din marketplace în admin UI. Deployer-ul nativ pe gazdă descarcă plugin-ul, rulează pasul său de instalare, generează o unitate systemd izolată și așteaptă endpoint-ul de sănătate înainte de a-l marca gata — vezi Instalare și actualizări. Apoi configurezi credențialele trunk-ului tău SIP și alegi motorul yandex sau local.

[!TIP] Pentru o configurație complet self-hosted, fără modele plătite, alege motorul local: faster-whisper și edge-tts păstrează întreaga cale de voce pe propria ta gazdă.

Securitate și limitări

Trunk neutru față de operator. SIP standard, fără blocare la operator.
Domeniul este STT/TTS/DTMF/înregistrare/barge-in. Fără diarizare, traducere sau clonare de voce pe calea de apel.
Nativ pe gazdă. baresip, loopback-ul și puntea rulează sub systemd, nu într-un container.
Înregistrarea este explicită. Înregistrarea și rezumatele post-apel sunt funcții de apel pe care le activezi — gestionează audio-ul apelului conform regulilor tale locale de consimțământ/retenție.