★ Importante, con qualunque centralino: il numero del chiamante
Il centralino deve passare a Vokly il numero di chi chiama, non il proprio numero o il fisso del cliente (opzione di pass-through del Caller ID sul trunk Vokly). Senza, ogni chiamata arriva con lo stesso numero e nei Logs Chiamate non si distingue più chi ha chiamato. Su 3CX si imposta nel modello del trunk: GenericSIPTrunk → Create Copy → Tune → «Send caller ID in From header (CLIP No Screening)» (backup prima). → 3CX V20 passo passo
→ Guida completa all'integrazione SIP
★ Trunk SIP verso Vokly — l'unico step critico della fonia
Per il tecnico della fonia il lavoro vero è uno: instradare il numero del cliente verso Vokly con un trunk SIP che funzioni perfettamente. Le fasi: (1) raccogli i parametri (indirizzo SIP + credenziali dati da Vokly all'attivazione; comunica a Vokly l'indirizzo pubblico del PBX) → (2) crea il trunk con autenticazione digest → (3) codec e DTMF → (4) instrada il DID → (5) failover → (6) collaudo con chiamata reale.
→ Guida completa all'integrazione SIP (fasi, parametri, PBX, troubleshooting)
Parametri del trunk in breve
Indirizzo SIP e credenziali (username/password) li fornisce Vokly all'attivazione — non generarli tu. Lato PBX imposta: codec G.722 + G.711 (PCMU/PCMA) in cima, transport TCP (porta 5060) o TLS (porta 5061, consigliata), DTMF RFC 2833, SRTP consentito, numero del chiamante passato così com'è, SIP REFER accettato dal trunk. Comunica a Vokly l'FQDN/IP pubblico del centralino per l'audio di ritorno.
Failover: il centralino non deve MAI perdere una chiamata
Configura sul PBX la regola “trunk down / unreachable”: se Vokly non è raggiungibile (guasto, manutenzione), la chiamata devia automaticamente alla reception o alla destinazione originale. È la rete di sicurezza che rende l'integrazione a prova di down.
Trasferimento a operatore: target in Vokly, route sul PBX
Il numero/interno/gruppo di trasferimento si imposta in Vokly; l'agente inoltra la chiamata quando serve. Sul centralino verifica che l'instradamento verso quel target sia permesso e che il trunk Vokly accetti il SIP REFER: è così che l'agente passa la chiamata agli interni. Su 3CX: Allow carrier-side transfers (SIP REFER) attiva, Support Reinvite e Support Replaces spente.
→ Tutte le opzioni del trunk 3CX
Requisiti per ogni centralino
Le regole che valgono con qualunque centralino: TCP 5060 o TLS 5061, numero di chi chiama nella parte utente del From, numero chiamato in formato internazionale, REFER, credenziali.
→ Requisiti per ogni centralino
3CX V20 passo passo
Trunk Vokly su 3CX V20: modello CLIP No Screening, opzioni del trunk, CID Rule per il numero pubblico, regola in uscita con prefisso 9, Send Busy, dove guardare. Provato su 3CX V20 versione 20.0.9.995.
→ 3CX V20 passo passo
Trasferimenti: occupato e non risponde
Se l'interno non risponde e il centralino non risponde «occupato», la chiamata può cadere. Con «occupato» l'agente riprende la chiamata. La regola da impostare sugli interni, in tutti gli stati di presenza.
→ Trasferimenti: occupato e non risponde
La chiamata non arriva: diagnosi
Ordine dei controlli e sintomi frequenti: chiamata rifiutata senza traccia, trasporto UDP, credenziali, CID Rule nascosta, TargetNotFound su 3CX. Per ogni sintomo: causa probabile e cosa controllare.
→ La chiamata non arriva: diagnosi
Collaudo telefonico reale prima del go-live
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, pubblica il numero.
Voce a senso unico o eco → NAT / RTP
Quasi sempre è NAT o RTP: apri il range RTP verso Vokly, verifica il NAT traversal del PBX e disattiva un SIP ALG del firewall troppo aggressivo che altera i pacchetti.
Le chiamate non arrivano all'AI
Controlla registrazione e autenticazione (username, password, host esatti), che il DID sia instradato al trunk giusto e che il firewall non blocchi la porta SIP (5060). In dubbio, rileggi i parametri forniti da Vokly.
Lato assistente — Collega il calendario dedicato, non il predefinito
Se il cliente usa gli appuntamenti: le prenotazioni finiscono nel calendario che selezioni al collegamento. Scegli il calendario specifico dell'ufficio — lasciare quello di default/personale è l'errore n.1, gli eventi atterrano nell'agenda sbagliata senza dare errore.
Lato assistente — Knowledge Base coi contenuti reali
L'agente risponde attingendo alla Knowledge Base: caricaci orari, sedi, procedure e FAQ effettive dell'ente. KB vuota = risposte vaghe (l'agente non inventa). Testi brevi e mirati funzionano meglio dei documentoni lunghi.