Guida: FreePBX e Asterisk

Ultima revisione: 8 novembre 2026

Un centralino FreePBX, o un Asterisk configurato a mano, si collega a un'iniziativa di Domitilla con un trunk PJSIP che si registra con i dati del pannello. Dopo scegli tu quali chiamate far arrivare all'assistente, per esempio quelle di un numero o quelle fuori orario.

Prima di cominciare

Apri Chiamate in entrata › Come risponde › Il numero di telefono, sull'iniziativa giusta, e la sezione «Collega il tuo centralino o un softphone». Ti servono Utente, Password (premi «mostra») e Server.

Il collegamento usa SIP su UDP, porta 5060, con l'audio in G.711: a-law (alaw) o µ-law (ulaw).

1. Autorizza l'indirizzo del centralino

Nel campo «Indirizzi del tuo centralino» scrivi l'indirizzo IP pubblico con cui il centralino esce su internet, oppure un nome DNS dinamico, e premi «Salva gli indirizzi». Entro 5 minuti la porta si apre. Gli indirizzi privati (192.168…, 10…) non vanno bene. Dettagli in Il tuo centralino.

2. FreePBX: crea il trunk

Apri Connectivity › Trunks e scegli Add Trunk › Add SIP (chan_pjsip) Trunk.
Nella scheda General dai un nome al trunk, per esempio «domitilla». Come Outbound CallerID scrivi l'«Utente» di Domitilla.
Nella scheda pjsip Settings, sotto General:
- Username: l'«Utente»
- Secret: la «Password»
- Authentication: Outbound
- Registration: Send
- SIP Server: il «Server»
- SIP Server Port: 5060
- Transport: quello UDP
Nella scheda Advanced, nel campo From User, scrivi di nuovo l'«Utente».
Nella scheda Codecs lascia attivi ulaw e alaw.
Salva e premi Apply Config.

Lo stato della registrazione lo vedi in Reports › Asterisk Info, oppure da riga di comando con asterisk -rx "pjsip show registrations".

Da sapere

Domitilla riconosce il collegamento dall'utente nel campo From. Per questo From User e Outbound CallerID devono essere l'«Utente»: se il centralino ci mette il numero del cliente, la chiamata viene rifiutata. Di conseguenza l'assistente non vede il numero del cliente: in «Quando serve una persona» scegli che chieda sempre il numero per la richiamata.

3. FreePBX: una rotta in uscita verso Domitilla

In Connectivity › Outbound Routes crea una rotta, per esempio «verso-domitilla»:

Nella scheda Dial Patterns indica un numero o un prefisso che non usi per altro, per esempio un numero breve dedicato.
In Trunk Sequence for Matched Routes scegli solo il trunk Domitilla.

Il numero che arriva a Domitilla non conta: qualsiasi numero composto su quel collegamento riceve la risposta dell'assistente dell'iniziativa. Prova da un interno: componi il numero e deve rispondere l'assistente.

4. FreePBX: decidi quali chiamate passare

Per usare quel numero come destinazione, crea in Applications › Misc Destinations una destinazione che compone il numero della rotta. Poi sceglila dove ti serve:

Tutte le chiamate di un numero: in Connectivity › Inbound Routes, come destinazione della rotta in ingresso.
Solo fuori orario: in Applications › Time Conditions, come destinazione quando la condizione oraria non è soddisfatta, e la condizione come destinazione della rotta in ingresso.
Un tasto del menu vocale: in Applications › IVR, come destinazione di un tasto.

Ricordati di premere Apply Config dopo ogni modifica.

Asterisk senza FreePBX

Se configuri Asterisk a mano con PJSIP, il collegamento è una registrazione in uscita con autenticazione. Uno schema di partenza per pjsip.conf, da adattare al tuo impianto (sostituisci UTENTE, PASSWORD e SERVER con i dati del pannello):

[domitilla-auth]
type=auth
auth_type=userpass
username=UTENTE
password=PASSWORD

[domitilla]
type=registration
outbound_auth=domitilla-auth
server_uri=sip:SERVER:5060
client_uri=sip:UTENTE@SERVER:5060

[domitilla]
type=aor
contact=sip:SERVER:5060

[domitilla]
type=endpoint
transport=transport-udp
disallow=all
allow=alaw,ulaw
outbound_auth=domitilla-auth
aors=domitilla
from_user=UTENTE

Il nome del trasporto (transport-udp nell'esempio) deve essere quello UDP già definito nel tuo pjsip.conf. Nel dialplan mandi la chiamata con Dial(PJSIP/numero@domitilla), dove il numero può essere uno qualsiasi. Dopo le modifiche: pjsip reload e dialplan reload dalla console di Asterisk. Per tutte le opzioni fai riferimento alla documentazione ufficiale di Asterisk.

Prova

Chiama il tuo numero da un cellulare nella fascia scelta, oppure premi il tasto del menu.
Controlla che risponda l'assistente dell'iniziativa giusta.
Chiedi di essere richiamato e verifica che la richiesta compaia in Chiamate in entrata › Da richiamare.

Se qualcosa non va

Cosa vedi	Cosa controllare
La registrazione non va a buon fine	Indirizzo pubblico salvato nel pannello da almeno 5 minuti, utente e password senza spazi, UDP 5060 libera in uscita.
Registrato, ma le chiamate vengono rifiutate	From User e Outbound CallerID devono essere l'«Utente» di Domitilla.
Risponde ma non si sente	Codec del trunk: alaw o ulaw. Controlla anche le impostazioni NAT del centralino.

Se il passaggio a una persona è acceso, l'assistente chiama il numero indicato in Domitilla, un fisso o un cellulare italiano, e non un interno del centralino. Per dubbi scrivici da Account › Scrivici indicando «FreePBX» o «Asterisk» e l'iniziativa.

Non trovi quello che cerchi? Scrivici dall'area clienti, in Scrivici, oppure a info@domitilla.ai.