Differenze tra le versioni di "AdminGuide:BasicConcepts:Outbound lines/en"

Da Kalliope Wiki.
Jump to navigation Jump to search
(Aggiornamento come da nuova versione della pagina di origine)
 
(4 versioni intermedie di uno stesso utente non sono mostrate)
Riga 17: Riga 17:
The '''outbound identity''' is the extension number used to derive the CLID for outbound calls (according to the corresponding calling number manipulation table). The '''Outbound Identity''' can be explicitly set for failover actions, while it is automatically assigned for call smade from a SIP account or for transferred/forwarded calls:
The '''outbound identity''' is the extension number used to derive the CLID for outbound calls (according to the corresponding calling number manipulation table). The '''Outbound Identity''' can be explicitly set for failover actions, while it is automatically assigned for call smade from a SIP account or for transferred/forwarded calls:


; Calls made by a SIP account
* ''' Calls made by a SIP account'''
: The outbound identity is set to the extension linked to the SIP Account.
: The '''outbound identity''' is set to the extension linked to the SIP Account.
; Calls forwarded by a device (telephone-driven call forwarding)
* '''Calls forwarded by a device''' (telephone-driven call forwarding)
: Same as above.
: Same as above.
; Calls forwarded using the KalliopePBX (unconditional) call forwarding service
* '''Calls forwarded using the KalliopePBX (unconditional) call forwarding service'''
: The outbound identity is set to the forwarding extension number.
: The outbound identity is set to the forwarding extension number.
; Transferred calls (using KalliopePBX star-codes or telephone functions)
* '''Transferred calls''' (using KalliopePBX star-codes or telephone functions)
: The outbound identity is set equal to the transferring extension number.
: The outbound identity is set equal to the transferring extension number.


Riga 33: Riga 33:
Except when explicitly set by a failover action, the choice of outbound routing class is automatically derived from the '''outbound identity'''.
Except when explicitly set by a failover action, the choice of outbound routing class is automatically derived from the '''outbound identity'''.


<div class="mw-translate-fuzzy">
== Configuration ==
; Calls made by a SIP account
Lines can be configured in the VoIP Gateways and Domains panel.  
: The outbound identity is set to the extension linked to the SIP Account.
[[File:Linee in uscita.png|miniatura]]
; Calls forwarded by a device (telephone-driven call forwarding)
The "Gateways and VoIP Domains" screen collects the configuration of all input/output lines from the PBX.
: Same as above.
; Calls forwarded using the KalliopePBX (unconditional) call forwarding service
: The outbound identity is set to the forwarding extension number.
; Transferred calls (using KalliopePBX star-codes or telephone functions)
: The outbound identity is set equal to the transferring extension number.
</div>


KalliopePBX supporta sia gateway fisici (che interconnettono la rete telefonica interna a linee analogiche, ISDN o GSM) che terminazioni e trunk VoIP, in entrambi i casi sfruttando il protocollo standard SIP.
KalliopePBX supports both physical gateways (which interconnect the internal telephone network to analog, ASDN, or GSM lines) and VoIP terminations and trunks, using the standard SIP protocol.


Possono essere configurati più gateway e più terminazioni o trunk VoIP contemporaneamente. Tramite questa schermata è possibile effettuare le seguenti operazioni:
It is also possible to configure multiple gateways and VoIP terminations or trunks simultaneously. Through this page you can:
* [[AdminGuide:BasicConcepts:Outbound lines:Dominio_VoIP|Aggiungere un dominio VoIP (o modificarne uno esistente)]]
* [[AdminGuide:BasicConcepts:Outbound_lines:Dominio_VoIP/en|add a VoIP domain or edit an existing one]];
* [[AdminGuide:BasicConcepts:Outbound lines:Gateway| Aggiungere un gateway fisico (o modificarne uno esistente)]]
* [[AdminGuide:BasicConcepts:Outbound_lines:Gateway/en|add a physical gateway or edit an existing one]];
* [[AdminGuide:BasicConcepts:Outbound lines:Terminazione_VoIP|Aggiungere una terminazione VoIP (o modificarne uno esistente)]]
* [[AdminGuide:BasicConcepts:Outbound_lines:Terminazione_VoIP/en|add a VoIP termination or edit an existing one]];
* [[AdminGuide:BasicConcepts:Outbound lines:Trunk VoIP|Aggiungere un trunk VoIP (o modificarne uno esistente)]]
* [[AdminGuide:BasicConcepts:Outbound_lines:Trunk_VoIP/en|add a VoIP trunk or edit an existing one]].


La differenza tra '''terminazione VoIP''' e '''trunk''' è data dal fatto che nel primo caso, ad ogni account di registrazione/autenticazione corrisponde un unico numero telefonico, mentre nel secondo caso si ha che a fronte di una unica credenziale di autenticazione, è possibile utilizzare un arco di numeri che solitamente condividono un radicale comune.  
The difference between '''VoIP terminations''' and '''trunks''' is due to the fact that with the former every registration/authentication account corresponds to a single phone number, while with the latter it is possible to use a range of numbers with the same authentication credentials, which usually share a common root.  


'''NOTA:''' Per poter creare una terminazione VoIP o un trunk è necessario prima creare un '''dominio VoIP''' a cui associarlo.
'''N.B.:''' to create a VoIP termination or trunk, it is necessary to first create a VoIP domain to link it to.


Nella tabella seguente sono descritte le colonne della lista delle linee di uscita.
The following table shows the columns in the list of outbound lines.
{| class="wikitable"
{| class="wikitable"
|-
|-
! Colonna !! Descrizione !! Valore
! Column !! Description !! Value
|-
|-
| '''Abilitato''' || Indica se la linea di uscita risulta abilitata o no ||  [[File:Abilitato.png|sinistra]] Abilitato <br><br> [[File:Non_abilitato.png|sinistra]] Non abilitato
| '''Enabled''' || Shows whether the outbound line is enabled or disabled. ||  [[File:Abilitato.png|sinistra]] Enabled <br><br> [[File:Non_abilitato.png|sinistra]] Disabled
|-
|-
| '''Nome''' || Il nome simbolico assegnato alla linea || -
| '''Name''' || The name assigned to the line. || -
|-
|-
| '''Identificativo''' || Identificativo univoco assegnato alla linea. Nel caso di trunk o terminazioni VoIP è lo username di autenticazione || -
| '''Identifier''' || Unique identifier assigned to the line. For VoIP terminations or trunks, this is the username for authentication. || -
|-
|-
| '''Tipo''' || Se non si tratta di un gateway fisico indica il tipo di linea || Trunk <br><br> Terminazione VoIP
| '''Type''' || If it is not a physical gateway, this specifies the type of line. || Trunk <br><br> VoIP terminal
|-
|-
| '''Stato''' || Nel caso di gateway fisici con registrazione in ingresso disabilitata lo stato raggiungibile / non raggiungibile indica se il peer risponde o meno ai messaggi SIP OPTIONS. Se la registrazione è abilitata indica invece se la registrazione da parte del gateway è stata  completata con successo.<br>
| '''State''' || For physical gateways with inbound registration disabled, the reachable/unreachable state shows whether or not the peer responds to SIP OPTIONS messages. If registration is enabled, it shows whether or not registration was completed successfully on the part of the gateway.<br>
Nel caso di domini VoIP lo stato raggiungibile / non raggiungibile indica se il peer risponde o meno ai messaggi SIP OPTIONS.<br>
For VoIP domains, the reachable/unreachable state shows whether or not the peer responds to SIP OPTIONS messages.<br>
Nel caso di trunk e terminazioni VoIP con abilitata registrazione remota lo stato raggiungibile / non raggiungibile indica se la registrazione ha avuto successo. Se la registrazione remota è disabilitata viene visualizzato lo stato Statico. <br><br>
For VoIP terminations and trunks with remote registration enabled, the reachable/unreachable state shows whether or not the registration was successful. If remote registration is disabled, the static state is shown.<br>
Lo stato in sospeso compare solo se un elemento è stato aggiunto ma la configurazione non è stata ancora applicata<br>
The suspended state will only be shown if an element has been added but not yet configured.<br>
|| [[File:ledVerde.png|sinistra]] Raggiungibile <br><br> [[File:ledRosso.png|sinistra]] Non raggiungibile <br><br> [[File:ledGrigio.png|sinistra]] In sospeso <br><br> [[File:ledAzzurro.png|sinistra]] Statico
|| [[File:ledVerde.png|sinistra]] Reachable <br><br> [[File:ledRosso.png|sinistra]] Unreachable <br><br> [[File:ledGrigio.png|sinistra]] Suspended <br><br> [[File:ledAzzurro.png|sinistra]] Static
|-
|-
| '''RTT''' || Round-Trip Time di un pacchetto SIP tra centralino e gateway o tra centralino e dominio/server VoIP dell’operatore
| '''RTT''' || Round-Trip Time of a SIP packet between PBX and gateway or PBX and VoIP domain/server of the operator.
  || Valore espresso in ms
  || Value in ms
|-
|-
| '''Mostra''' || Visibile se NON è acquisito il [[Interfaccia generale|lock]]. Cliccando sul simbolo si possono visualizzare in sola lettura le impostazioni della linea  || [[File:Lente.png|sinistra]]
| '''Show''' || Visible if [[AdminGuide:GUI/en|lock]] has NOT been acquired. Clicking the icon will show the line settings in read-only mode. || [[File:Lente.png|sinistra]]
|-
|-
| '''Modifica''' || Visibile solo se acquisito il [[Interfaccia generale|lock]]. Cliccando sul simbolo si entra nella pagina di modifica della linea || [[File:Matita.png|sinistra]]  
| '''Edit''' || Visible only if [[AdminGuide:GUI/en|lock]] has been acquired. Clicking the icon will open the line modification page. || [[File:Matita.png|sinistra]]  
|-
|-
| '''Elimina''' || Visibile solo se acquisito il [[Interfaccia generale|lock]]. Cliccando sul simbolo si elimina la linea  || [[File:Cestino.png|sinistra]]
| '''Delete''' || Visible only if [[AdminGuide:GUI/en|lock]] has been acquired. Clicking the icon will delete the line. || [[File:Cestino.png|sinistra]]
|}
|}

Versione attuale delle 15:31, 19 set 2022

Altre lingue:

Return to AdminGuide:BasicConcepts

Outbound and inbound lines

"Outbound and inbound lines" are all the SIP lines through which the PBX can make and receive calls to and from external numbers, i.e. not an internal service or extension (local SIP account).

Calls to external numbers

Calls to external numbers are not forwarded directly to the outbound lines, but are presented to the outbound routing engine. This engine decides whether the calling user/entity is authorized to perform the call (based on the destination number) and which outbound lines can be used.

Calls can reach the outbound routing engine from the numbering plan or directly as a failover action of a previous destination (e.g. an incoming call to an extension can be forwarded to an external number in case of no answer). In both cases, the requested outbound call has two associated parameters: the outbound identity and the outbound routing class.

Outbound identity

The outbound identity is the extension number used to derive the CLID for outbound calls (according to the corresponding calling number manipulation table). The Outbound Identity can be explicitly set for failover actions, while it is automatically assigned for call smade from a SIP account or for transferred/forwarded calls:

  • Calls made by a SIP account
The outbound identity is set to the extension linked to the SIP Account.
  • Calls forwarded by a device (telephone-driven call forwarding)
Same as above.
  • Calls forwarded using the KalliopePBX (unconditional) call forwarding service
The outbound identity is set to the forwarding extension number.
  • Transferred calls (using KalliopePBX star-codes or telephone functions)
The outbound identity is set equal to the transferring extension number.

In all these cases, if the caller requests to present itself as anonymous (according to the different CLIR supported methods), the outbound identity retains the extension number throughout all the lifetime of the call, and the actual calling number restriction is performed when placing the call to the outbound line (or to the destination SIP accounts for local calls).

Outbound routing class

The outbound routing class defines the actual handling of the call, i.e. whether or not it is allowed, and if so the sequence of outbound lines to be used to perform the call.

Except when explicitly set by a failover action, the choice of outbound routing class is automatically derived from the outbound identity.

Configuration

Lines can be configured in the VoIP Gateways and Domains panel.

Linee in uscita.png

The "Gateways and VoIP Domains" screen collects the configuration of all input/output lines from the PBX.

KalliopePBX supports both physical gateways (which interconnect the internal telephone network to analog, ASDN, or GSM lines) and VoIP terminations and trunks, using the standard SIP protocol.

It is also possible to configure multiple gateways and VoIP terminations or trunks simultaneously. Through this page you can:

The difference between VoIP terminations and trunks is due to the fact that with the former every registration/authentication account corresponds to a single phone number, while with the latter it is possible to use a range of numbers with the same authentication credentials, which usually share a common root.

N.B.: to create a VoIP termination or trunk, it is necessary to first create a VoIP domain to link it to.

The following table shows the columns in the list of outbound lines.

Column Description Value
Enabled Shows whether the outbound line is enabled or disabled.
Abilitato.png
Enabled

Non abilitato.png
Disabled
Name The name assigned to the line. -
Identifier Unique identifier assigned to the line. For VoIP terminations or trunks, this is the username for authentication. -
Type If it is not a physical gateway, this specifies the type of line. Trunk

VoIP terminal
State For physical gateways with inbound registration disabled, the reachable/unreachable state shows whether or not the peer responds to SIP OPTIONS messages. If registration is enabled, it shows whether or not registration was completed successfully on the part of the gateway.

For VoIP domains, the reachable/unreachable state shows whether or not the peer responds to SIP OPTIONS messages.
For VoIP terminations and trunks with remote registration enabled, the reachable/unreachable state shows whether or not the registration was successful. If remote registration is disabled, the static state is shown.
The suspended state will only be shown if an element has been added but not yet configured.

LedVerde.png
Reachable

LedRosso.png
Unreachable

LedGrigio.png
Suspended

LedAzzurro.png
Static
RTT Round-Trip Time of a SIP packet between PBX and gateway or PBX and VoIP domain/server of the operator. Value in ms
Show Visible if lock has NOT been acquired. Clicking the icon will show the line settings in read-only mode.
Lente.png
Edit Visible only if lock has been acquired. Clicking the icon will open the line modification page.
Matita.png
Delete Visible only if lock has been acquired. Clicking the icon will delete the line.
Cestino.png