← Integrazione SIP Guida tecnica · 3CX V20

3CX V20 passo passo

Sequenza di configurazione del trunk Vokly su 3CX, nell’ordine in cui conviene farla.

Provato su

Valida e provata solo su 3CX V20 (versione 20.0.9.995, edizione con reparti): le altre versioni di 3CX non sono provate, compreso il modello da scaricare al punto 1. Il trunk Vokly va prima creato come nella guida (Voice & Chat → Add Trunk → Generic SIP Trunk, con i parametri del documento di Vokly). Nell’edizione FREE/SMB alcune pagine sono diverse. Le regole che valgono con ogni centralino sono in Requisiti per ogni centralino.

Sei passi

  1. 1

    Numero di chi chiama: il modello «CLIP No Screening»

    Il modello del trunk decide come il 3CX scrive il numero di chi chiama verso Vokly: deve stare nella parte utente del From. Due strade, stesso risultato. Prima fai un backup della configurazione del 3CX.

    Strada A: importa il modello pronto (solo 3CX V20). Scarica AI-Agent-Caller-ID-Passthrough.pv.xml, poi: Admin → Advanced → Templates → Provider Templates → Import → scegli il file. Nell’elenco compare come «AI-Agent-Caller-ID-Passthrough». Sono due operazioni distinte: prima l’importazione, poi, selezionato il modello, «Switch existing SIP trunk to use this new template» scegliendo solo il trunk Vokly (mai quello del gestore). Il modello imposta come il 3CX scrive il From e l’indirizzo del server; non contiene credenziali né numeri. Dopo lo switch controlla nel trunk Vokly che Registrar/Server sia compilato con l’indirizzo fornito da Vokly, che Type of authentication sia «Do not require - IP based» e che Authentication ID e password siano quelli del documento: il 3CX non si registra, ma quando Vokly chiede la password alla chiamata la manda.

    Strada B: fai la copia a mano. Admin → Advanced → Templates → Provider Templates → GenericSIPTrunk → Create Copy → Tune → «Outbound Caller ID Handling» → «Send caller ID in From header (CLIP No Screening)». Poi usa «Switch 1 existing SIP trunk to use this new template» per passarci il trunk Vokly.

    In tutte e due le strade il 3CX avvisa che sovrascrive le impostazioni del trunk («overwrite trunk configuration settings»): dopo il cambio ricontrolla il REFER e le opzioni del punto 2. Il trunk che usa un modello si vede nella colonna «Information» di Voice & Chat.

    Nelle opzioni del trunk la voce «Caller ID Control» cambia solo i nomi visualizzati: da sola non basta. Non modificare a mano il file del modello.

  2. 2

    Opzioni del trunk Vokly

    Nel trunk Vokly, scheda Options:

    • Trasporto: TCP (porta 5060). Con TCP, SRTP Mode su Disabled.
    • Allow carrier-side transfers (SIP REFER): attiva. Va attivata sul trunk Vokly, non su quello del gestore.
    • PBX delivers audio: attiva.
    • Disable Video: attiva.
    • Include diversion header support: attiva.
    • Support Reinvite e Support Replaces: spente.
  3. 3

    Numero pubblico verso Vokly: CID Rule

    La V20 non ha più le «Inbound rules» né la destinazione «numero esterno» per un numero pubblico. Il metodo che funziona è una CID Rule: Admin → Advanced → CID Rules. Crea una regola sul trunk del gestore con Caller ID * e «Route to» External. Come destinazione scrivi 9+ seguito dal numero Vokly, per esempio 9+390200000000. Il perché del 9 è nel punto 4.

    Le CID Rules vengono valutate prima delle assegnazioni dei numeri e della «Default route» del trunk.

  4. 4

    Regola in uscita usata dalla deviazione

    Crea una regola in uscita con questi valori: prefisso 9, «Calls from extension(s)» = All, nessun reparto, route sul trunk Vokly, Strip 1 cifra. Il 3CX toglie il 9 e Vokly riceve il numero in formato internazionale, per esempio +390200000000. Il 9 non lo vede né lo compone nessuno.

    Se la regola ha un reparto (per esempio «Default»), l’Activity log scrive TargetNotFound: le deviazioni non appartengono al reparto degli interni.

    Sul +: con la destinazione +390200000000 senza il 9, il 3CX ha risposto TargetNotFound anche con una regola identica. La causa non è stata determinata. Non dipende dal numero principale del trunk Vokly. Il metodo con il 9 funziona.

  5. 5

    Interni raggiunti da Vokly: Send Busy

    Users → interno → Call Forwarding. Per ogni stato (Available, Away, Do Not Disturb e gli stati personalizzati che hai creato) imposta «Unanswered Calls» e «Busy or not Registered» su «Forward external calls to» → Send Busy. Il «No Answer Timeout» è nello stesso blocco: 15-20 secondi. Perché serve: Trasferimenti: occupato e non risponde.

  6. 6

    Dove guardare se qualcosa non va

    Call History: Reports → Call History, colonna «Call Activity Details»: mostra il percorso della chiamata.

    Activity log: non è una voce di menu. Si apre all’indirizzo https://<fqdn>:5001/#/office/dashboard/activity-log, dove al posto di <fqdn> metti l’indirizzo del tuo centralino. Dalla dashboard di Admin è nel riquadro Troubleshooting. Il pulsante Settings imposta il Logging Level: Off, Low, Medium, Verbose.

    L’«Event Log» del menu contiene eventi di sistema, non le chiamate.

    Se la chiamata non arriva: La chiamata non arriva: diagnosi.

Serve una mano con un centralino specifico?

Il team fonia affianca VAR e installatori sull’integrazione e sul collaudo.

Scrivi al supporto tecnico → Torna all’Integrazione SIP →