Ultima revisione: 8 novembre 2026 (2026-11-08)

# Guida: FreePBX e Asterisk

> Trunk PJSIP con registrazione e regole in ingresso.

Sezione: Il numero · Pagina: https://docs.domitilla.ai/centralino-freepbx.php

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](https://docs.domitilla.ai/centralino.php).

## 2. FreePBX: crea il trunk

1. Apri **Connectivity › Trunks** e scegli **Add Trunk › Add SIP (chan_pjsip) Trunk**.
2. Nella scheda **General** dai un nome al trunk, per esempio «domitilla». Come **Outbound CallerID** scrivi l'«Utente» di Domitilla.
3. 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
4. Nella scheda **Advanced**, nel campo **From User**, scrivi di nuovo l'«Utente».
5. Nella scheda **Codecs** lascia attivi ulaw e alaw.
6. 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

1. Chiama il tuo numero da un cellulare nella fascia scelta, oppure premi il tasto del menu.
2. Controlla che risponda l'assistente dell'iniziativa giusta.
3. 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.

---
Mediacare Spa · Documentazione Domitilla · https://docs.domitilla.ai/llms.php