3CX (V16/V18/V20)
Aggiungi un SIP Trunk generico, tipo “basato su registrazione o IP”. Inserisci host + credenziali Vokly, crea la regola inbound sul DID e una regola di failover verso l’interno di reception.
← Supporto Guida tecnica · VAR / Fonia
Integrazione SIP verso Vokly
Il tecnico della fonia ha una cosa da fare bene: instradare il numero del cliente verso Vokly con un trunk SIP. Qui trovi le fasi, i parametri e il collaudo, passo per passo.
In sintesi
Due direzioni: inbound — le chiamate del numero vanno da PBX/carrier verso Vokly; ritorno audio — Vokly raggiunge il tuo PBX all’indirizzo pubblico che gli comunichi. L’indirizzo SIP e le credenziali te li fornisce Vokly in fase di attivazione: non serve generarli tu.
Prerequisiti
- Il numero/DID che deve rispondere tramite l’AI.
- Accesso amministrativo al PBX (3CX, Asterisk/FreePBX, Kalliope, NethVoice, Wildix…) o al pannello del carrier VoIP.
- Indirizzo pubblico del PBX (FQDN/IP raggiungibile), oppure la gestione del trunk lato carrier.
- I parametri SIP forniti da Vokly all’attivazione: indirizzo, username, password, numero.
- Backup della configurazione del PBX prima di ogni modifica: punto di rollback sempre disponibile.
Le 6 fasi
- 1
Raccogli i parametri
Da Vokly ricevi all'attivazione: indirizzo SIP, username e password del trunk, e il numero assegnato. In cambio comunica a Vokly l'indirizzo pubblico del tuo PBX (FQDN o IP, con porta se diversa dalla 5060), così l'audio di ritorno può raggiungere il centralino.
- 2
Crea il trunk SIP sul PBX
Sul centralino (o sul pannello del carrier VoIP) crea un trunk SIP verso l'indirizzo Vokly, con autenticazione digest (username + password forniti). Registrazione o peering per IP a seconda di quanto indicato in attivazione.
- 3
Media: codec, cifratura, DTMF
Abilita e porta in cima alla lista i codec supportati: G.722, G.711 µ-law (PCMU), G.711 A-law (PCMA). Transport auto (UDP/TCP/TLS), cifratura media consentita (SRTP opzionale), DTMF RFC 2833 / telephone-event.
- 4
Instradamento inbound
Instrada il numero/DID che deve rispondere l'AI verso il trunk Vokly, con risposta immediata (l'agente è attivo h24). Se vuoi una selezione (es. tasto 1 = AI), gestiscila nel tuo IVR e poi inoltra al trunk.
- 5
Failover: mai perdere una chiamata
Configura la regola “trunk down / unreachable”: se Vokly non è raggiungibile, il PBX deve deviare automaticamente alla reception o destinazione originale. È la rete di sicurezza che garantisce continuità anche in caso di guasto o manutenzione.
- 6
Collaudo con chiamata reale
Chiama il numero da rete fissa e mobile e verifica: audio bidirezionale pulito (no voce a senso unico, no eco), riconoscimento del parlato, DTMF, trasferimento a operatore e failover (simulando il trunk down). Solo dopo, go-live.
Parametri del trunk
Forniti da Vokly (all’attivazione)
| Indirizzo SIP (host) | Endpoint verso cui il PBX instrada le chiamate |
|---|---|
| Username SIP | Autenticazione digest del trunk |
| Password SIP | Autenticazione digest del trunk |
| Numero / DID | Numero assegnato che risponde tramite Vokly |
Che comunichi tu a Vokly
| FQDN / IP pubblico del PBX | Dove Vokly instrada l’audio di ritorno |
|---|---|
| Porta SIP | 5060 di default (indicala se diversa) |
Impostazioni tecniche (le imposti sul PBX)
| Codec | G.722, G.711 µ-law (PCMU), G.711 A-law (PCMA) — in cima alla lista |
|---|---|
| Transport | auto (UDP / TCP / TLS) |
| Cifratura media | SRTP consentito (non forzato) |
| DTMF | RFC 2833 / telephone-event |
| Porta SIP | 5060 (default) |
Trasferimento a operatore
Il target di trasferimento (interno, gruppo di suoneria o numero esterno) si imposta lato Vokly: l’agente inoltra la chiamata a quel target quando il chiamante lo richiede o quando la richiesta esce dal perimetro dell’AI. Sul PBX assicurati solo che l’instradamento verso quel target sia permesso e raggiungibile.
Rete, NAT e firewall
- Consenti il segnale SIP (porta 5060, o TLS se usato) e il range RTP verso Vokly.
- Verifica il NAT traversal del PBX (IP pubblico/porta esterna corretti nell’header).
- Attenzione al SIP ALG del router/firewall: se altera i pacchetti, disattivalo.
Note per i PBX più comuni
Asterisk / FreePBX
Crea un trunk PJSIP verso l’host Vokly con le credenziali. In FreePBX: Connectivity → Trunks + Inbound Route sul DID; imposta la Destination on Congestion come failover.
KalliopePBX / NethVoice / Wildix
Trunk SIP standard verso l’host Vokly con autenticazione digest. Instrada il DID al trunk e definisci la destinazione di fallback in caso di trunk non registrato.
Carrier VoIP (Messagenet, VoipVoice, Vianova…)
Se il numero è sul carrier, imposta l’inoltro/trunk del DID verso l’indirizzo Vokly dal pannello del provider, con le credenziali fornite. Utile quando non c’è un PBX on-premise.
Le voci esatte dei menu variano per versione: il concetto è sempre lo stesso — trunk SIP + route inbound + failover.
Collaudo — checklist go-live
- Chiamata da rete fissa e da mobile: l’AI risponde subito.
- Audio bidirezionale pulito: nessuna voce a senso unico, nessuna eco.
- Il parlato viene riconosciuto; i DTMF (tastiera) funzionano.
- Trasferimento a operatore a buon fine, con l’interno/numero giusto che squilla.
- Failover: simula il trunk down e verifica la deviazione alla reception.
- Qualità e latenza accettabili (obiettivo < 1,5 s di round-trip end-to-end).
Problemi frequenti
Voce a senso unico o eco
Quasi sempre NAT / RTP: apri il range RTP verso Vokly, disattiva un SIP ALG troppo aggressivo sul firewall e verifica il NAT traversal del PBX.
Le chiamate non arrivano all’AI
Controlla registrazione/autenticazione (username, password, host esatti), che il DID sia instradato al trunk giusto e che il firewall non blocchi la 5060.
DTMF non riconosciuti
Imposta DTMF su RFC 2833 (telephone-event) sul trunk; evita “in-band audio” o “SIP INFO” se non concordati.
Audio distorto / codec mismatch
Abilita e priorizza G.722 e G.711 (PCMU/PCMA). Rimuovi codec non compatibili in cima alla lista per evitare transcodifiche inutili.
Serve una mano con un centralino specifico?
Il team fonia affianca VAR e installatori sull’integrazione e sul collaudo.