# Come collegare un Interno Sip Trunk a Bookli

{% stepper %}
{% step %}

### Requisiti Preliminari

Per collegare Bookli a un sistema telefonico SIP, assicurati di disporre di:

* Un telefono IP o un softphone (es. Zoiper, Linphone) per i test.
* Un PBX (es. Asterisk, FreePBX, 3CX) o un provider SIP.
* Credenziali SIP:
  * Username (interno/account SIP)
  * Password
  * Dominio o SIP Realm (es. sip.providerdemo.net)
* Numero di telefono o interno SIP (es. +39011222333 o 200)
* IP pubblico e porta SIP del PBX o provider (generalmente 5060).
  {% endstep %}

{% step %}

### Attivazione dell’Integrazione SIP in Bookli

* Accedi al tuo account Bookli.
* Vai su **Impostazioni → Integrazione SIP**.
* Verifica che l’integrazione risulti **Attiva**.

**Parametri generici:**

* Dominio SIP: `bookli.tuodominio.com`
* Indirizzo IP: `123.123.123.123`
* Porta: `5060`
  {% endstep %}

{% step %}

### Creazione di un Carrier SIP

Vai su **Impostazioni → Carrier SIP → Nuovo Carrier SIP** e compila i campi come segue.

#### Campi Principali

* **Nome Carrier** → Nome identificativo del provider (es. "Provider Demo", "PBX Interno").
* **E164 Leading Plus** → Abilita solo se il provider richiede numerazione internazionale (+39).
* **Richiede Registrazione** → Abilita se è necessario autenticarsi con username/password.

#### Configurazione Registrazione SIP

* **Username Registrazione** → Username fornito dal provider o PBX.
* **Password Registrazione** → Password associata.
* **SIP Realm** → Dominio SIP del provider (es. sip.providerdemo.net).
* **From User** → Interno o numero di telefono identificativo (es. 200).
* **From Domain** → Compila solo se richiesto dal provider.
* **Usa TLS / IP Pubblico nel Contact** → Attiva solo se richiesto dal provider.

#### Numero di Telefono

* **Numero di Telefono** → Numero SIP o interno da cui ricevi chiamate (es. +39011222333 o 200).

#### Gateway

* **Indirizzo IP** → IP pubblico del PBX o del provider (es. 198.51.100.25).
* **Porta** → Generalmente `5060`.
* **Netmask** → Lascia `32`.
* **Chiamate in entrata / uscita** → Abilita entrambe se il trunk supporta traffico bidirezionale.
  {% endstep %}

{% step %}

### Esempi di Configurazione

🔹 **Esempio con Asterisk**

* Nome Carrier: Asterisk Test
* Username: user100
* Password: \*\*\*\*\*\*\*\*
* SIP Realm: sip.asteriskdemo.net
* From User: 100
* Numero di Telefono: 100
* Gateway IP: 203.0.113.10
* Porta: 5060

🔹 **Esempio con 3CX**

* Nome Carrier: 3CX Test
* Username: demo3cx01
* Password: \*\*\*\*\*\*\*\*
* SIP Realm: pbx.3cxdemo.com
* From User: 300
* Numero di Telefono: 300
* Gateway IP: 203.0.113.20
* Porta: 5060
  {% endstep %}

{% step %}

### Verifica della Configurazione

Dopo il salvataggio del Carrier:

* Accedi a **Carrier SIP** e verifica che lo stato sia **Registrato**.
* Esegui una chiamata di test da un telefono IP o softphone connesso al PBX.
* Verifica:
  * La riuscita della chiamata in uscita.
  * La ricezione delle chiamate in entrata.
    {% endstep %}

{% step %}

### Risoluzione dei Problemi

* **Errore di registrazione (401/403 Unauthorized)** → Controlla credenziali (username, password, SIP realm).
* **Chiamate in uscita fallite** → Verifica IP e porta del gateway, controlla se la porta 5060 UDP è aperta.
* **Audio assente** → Controlla NAT e regole firewall, assicurati che le porte RTP siano configurate correttamente.
* **Problemi con la numerazione** → Prova ad attivare o disattivare l'opzione **E164 Leading Plus** a seconda delle specifiche del provider.
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bookli.ai/integrazioni/come-collegare-un-interno-sip-trunk-a-bookli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.