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.
Il centralino deve passare a Vokly il numero di chi chiama, non il numero
del centralino o il fisso del cliente. Senza, ogni chiamata arriva con lo stesso numero:
nei Logs Chiamate di Vokly non si distingue più chi ha chiamato. Sui centralini è
l’opzione di pass-through del Caller ID (per 3CX vedi più sotto).
Il numero va nella parte utente dell’intestazione From
(sip:+390200000000@…), non nel nome visualizzato.
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.
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.
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.
Abilita e porta in cima alla lista i codec supportati: G.722, G.711 µ-law (PCMU), G.711 A-law (PCMA). Transport TCP (porta 5060) o TLS (porta 5061, consigliata), cifratura media consentita (SRTP opzionale), DTMF RFC 2833 / telephone-event.
Instrada il numero/DID che deve rispondere l'AI verso il trunk Vokly, con risposta immediata (l'agente è attivo h24) e con il numero del chiamante originale (vedi la nota in cima). Se vuoi una selezione (es. tasto 1 = AI), gestiscila nel tuo IVR e poi inoltra al trunk.
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.
Chiama il numero da rete fissa e mobile e verifica: audio bidirezionale pulito (no voce a senso unico, no eco), riconoscimento del parlato, DTMF, numero del chiamante nei Logs Chiamate di Vokly, trasferimento a operatore e failover (simulando il trunk down). Solo dopo, go-live.
| 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 |
| FQDN / IP pubblico del PBX | Dove Vokly instrada l’audio di ritorno |
|---|---|
| Porta SIP | 5060 di default (indicala se diversa) |
| Codec | G.722, G.711 µ-law (PCMU), G.711 A-law (PCMA) — in cima alla lista |
|---|---|
| Transport | TCP o TLS (TLS consigliata) |
| Cifratura media | SRTP consentito (non forzato) |
| DTMF | RFC 2833 / telephone-event |
| Porta SIP | 5060 con TCP, 5061 con TLS |
| Numero del chiamante | Passato così com’è: il numero di chi chiama, non quello del centralino |
| Trasferimenti | SIP REFER accettato dal trunk Vokly |
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.
Verso gli interni l’agente trasferisce con SIP REFER sulla chiamata in corso: il centralino deve accettare il REFER dal trunk Vokly. Se lo rifiuta, la chiamata resta all’agente e l’interno non squilla.
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. Poi imposta le opzioni del trunk elencate qui sotto.
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.
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.
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.
Nel trunk Vokly, scheda Options. Sono le opzioni che più spesso bloccano i trasferimenti o l’audio: controllale tutte, anche su un trunk già funzionante.
| Opzione | Valore | Perché |
|---|---|---|
| Allow carrier-side transfers (SIP REFER) | Attiva | Senza, il 3CX rifiuta i trasferimenti dell’agente verso gli interni. |
| Support Reinvite | Disattiva | La guida 3CX la consiglia spenta sui trunk. |
| Support Replaces | Disattiva | La guida 3CX la consiglia spenta sui trunk. |
| PBX delivers audio | Attiva | L’audio passa dal 3CX; la guida 3CX la consiglia sempre attiva. |
| Disable Video | Attiva | Vokly gestisce solo l’audio. |
| Include diversion header support | Attiva | Come nella configurazione di riferimento. |
| SRTP Mode | Disabled con TCP 5060 | Enabled solo se il trunk usa TLS 5061. |
| Interni raggiunti da Vokly: Send Busy | Sull’interno, non sul trunk | Per ogni stato dell’interno, «non risponde» e «occupato» devono rispondere occupato. Vedi sotto. |
Numero del chiamante su 3CX: il numero si imposta nel modello del trunk, non nelle opzioni. La voce «Caller ID Control» cambia solo i nomi visualizzati. Prima fai un backup. Poi: Admin → Advanced → Templates → Provider Templates → GenericSIPTrunk → Create Copy → Tune → «Outbound Caller ID Handling» → «Send caller ID in From header (CLIP No Screening)». Infine passa il trunk Vokly al nuovo modello e ricontrolla le opzioni della tabella. Il passo passo è in 3CX V20 passo passo.
Interni raggiunti da Vokly: sull’interno, per ogni stato, imposta «Send Busy» per «Unanswered Calls» e «Busy or not Registered». Tutta la regola è in Trasferimenti: occupato e non risponde.
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.
Controlla registrazione/autenticazione (username, password, host esatti), che il DID sia instradato al trunk giusto e che il firewall non blocchi la 5060.
Imposta DTMF su RFC 2833 (telephone-event) sul trunk; evita “in-band audio” o “SIP INFO” se non concordati.
Il centralino rifiuta il SIP REFER del trunk Vokly. Su 3CX: attiva «Allow carrier-side transfers (SIP REFER)» e lascia spenti «Support Reinvite» e «Support Replaces». Controlla anche che l’interno scritto in Vokly esista sul centralino.
Il centralino manda il proprio numero al posto di quello del chiamante: attiva il pass-through del Caller ID sul trunk Vokly. Su 3CX si imposta nel modello del trunk, con «Send caller ID in From header (CLIP No Screening)». Solo per 3CX V20: scarica il modello pronto e caricalo sul trunk Vokly come spiegato al punto 1 di 3CX V20 passo passo, dove c’è anche la copia a mano.
Abilita e priorizza G.722 e G.711 (PCMU/PCMA). Rimuovi codec non compatibili in cima alla lista per evitare transcodifiche inutili.
Il team fonia affianca VAR e installatori sull’integrazione e sul collaudo.
