Differenze tra le versioni di "AdminGuide:Service:Paging/en"

Da Kalliope Wiki.
Jump to navigation Jump to search
(Creata pagina con "<languages /> == Paging service == * Introduced with Release: 4.3.1")
 
 
(37 versioni intermedie di 5 utenti non mostrate)
Riga 1: Riga 1:
<languages />
Return to [[AdminGuide:Service/en|AdminGuide:Service]]


<languages />
<div class="noautonum" style="float: right">__TOC__</div>
== Paging service ==
== Paging service ==
* Introduced with Release: 4.3.1  
* Introduced with firmware version 4.3.1
[[File:Paging.png|miniatura]]
 
== Description ==
The paging service lets a user send a live or prerecorded audio message to multiple destinations simultaneously, with the option of having devices answer automatically when they receive the message. This service is used to make informative or emergency announcements.
 
KalliopePBX lets you define an arbitrary number of "paging groups". Each one is independent from the others and is fully configurable when it comes to permissions, choice of destinations, mode of operation, and messages.
 
An extension can make a call to a code comprised of a paging service prefix (set when enabling the service in the numbering plan, by default *53) followed by the paging group number (set in the configuration page for the group). If authentication is necessary, KalliopePBX will play the "Password" audio file and the user will need to input a PIN (the one set in the group configuration or their personal one) followed by #. If authentication is successful the paging group will be activated according to its configuration, detailed in the following section.
 
== Configuration ==
 
Paging groups can be created and edited in the PBX -> Paging groups page.
<!--The configurable settings for each group are listed [[AdminGuide:GUI:OperatingMenu:Paging/en|here]].-->
 
The following table describes the configuration parameters of each group are:
{| class="wikitable"
! <div style = 'text-align: left> '''Parameter''' !! <div style = 'text-align: left> '''Description''' !! <div style = 'text-align: left> '''Value'''
|-
|Name ||Identifier assigned to the Paging group|| Alphanumeric
|-
|Number|| Selection of Paging Service|| Numeric
|-
|Caller ID||Display Name for calls to destination terminals|| Alphanumeric
|-
|'''Modality'''||Mode of operation of the Paging group||Live/Unattended
|-
|Audio file|| Audio file containing a prerecorded message that is played at the destination terminals of the group. It is used differently in the case of Live or Unattended mode
|-
|Repetitions number||Number of times the prerecorded message must be played before the PBX automatically ends the call (configurable only in "Unattended" mode)||Numeric (0 indicates that the message is to be played in a continuous loop)
|-
|Automatic response method||Header to be added to calls made to destination terminals in order to specify the automatic response request||Manual configuration/Call-Info/Header Alert-Info
|-
!colspan="3" |<div style = 'text-align: center> '''Account'''
|-
|Extension||Paging target terminals||
|-
|Account||SIP account associated with the extension||
|-
!colspan="3" | <div style = 'text-align: center> '''Access control'''
|-
|Extension||Caller extension ||"Any extension"/Extension
|-
|PIN type|| Authentication mode required ||None/Custom/ Authentication mode required.
|-
|Pin value|| ||Alphanumeric
|}
 
===Modality===
The operating mode of the paging groups: can be set as either '''"Live"''' or '''"Unattended"'''.
In Live mode the extension making the call to the paging group will remain on call as the sole speaker; at the end of the call, they will hang up, and the calls to all destinations will themselves end.
In Unattended mode the PBX hangs up the call made from the extension to the paging group and, after a few moments, proceeds to contact all destinations and play the message set under the "Audio file" item.


=== Descrizione Funzionale ===
The audio file will be used differently depending on whether the mode is set to '''"Live"''' or '''"Unattended"''':
Il servizio Paging permette di inviare un messaggio audio dal vivo o preregistrato a più destinazioni contemporaneamente, eventualmente specificando ai terminali di destinazione di rispondere in modo automatico. Questo servizio è comunemente utilizzato per effettuare annunci informativi o di emergenza.
* '''Live''': the message is played before the caller begins communication with the group. This can be used to mark the beginning of an announcement.
* '''Unattended''': the message is played to all destinations in the paging group. Depending on the following setting (Number of repetitions), the message can be played once or multiple times.


Il servizio Paging disponibile in KalliopePBX permette di definire un numero arbitrario di "Gruppi di paging". Ciascuno di essi è indipendente dagli altri, ed è completamente configurabile in termini di autorizzazioni, scelta delle destinazioni, della modalità operativa e dei messaggi da riprodurre.
In Unattended mode a second call to the group number will stop message playback regardless of the number of repetitions set.


Operativamente, un interno effettua una chiamata ad una selezione costituita da un prefisso associato al servizio Paging (definito insieme all'abilitazione del servizio stesso nel Piano di Numerazione, impostato per default a *53) seguito dal numero specifico del gruppo di Paging (definito nel pannello di configurazione del gruppo stesso). In caso sia necessaria autenticazione, il PBX riproduce un prompt vocale ("Password") all'utente, che deve inserire un PIN numerico, seguito dal tasto #. In caso di autenticazione avvenuta con successo (in base al PIN specificato nella configurazione del gruppo per quell'interno chiamante) viene avviato il gruppo di Paging, in accordo alla modalità configurata, come dettagliato nella sezione seguente.
'''N.B.:''': the second call does not need to be made from the extension that activated the service as long as it is enabled to use the service according to the rules described below.


=== Configurazione ===
Access control specifies the permissions necessary to use the service. You can specify one or more access rules of the form, specifying which extensions can use the service (one, more than one, or any) and if an activation PIN is required.


L'aggiunta o la modifica di un Gruppo di Paging viene effettuata dal pannello omonimo, raggiungibile dal menu "Applicazioni PBX". I parametri di configurazione di ciascun gruppo sono:
An example of '''''ACL''''' is:
* '''Nome''': un identificativo testuale assegnato al gruppo di Paging.
* '''Numero''': la selezione da concatenare al prefisso del servizio di Paging (che viene configurato all'interno del Piano di Numerazione).
* L''''identificativo chiamante''': questa verrà utilizzata come Display Name per le chiamate verso i terminali di destinazione.
* La '''modalità''' di funzionamento del gruppo di Paging: può essere scelta tra le due alternative "Live" e "Unattended".
** Live: l'interno chiamante che attiva la chiamata al gruppo di Paging rimane in chiamata come unico speaker attivo; al termine riaggancia e le chiamate a tutti i terminali di destinazione vengono a loro volta terminate.
** Unattended: la chiamata effettuata dall'interno al gruppo di Paging viene riagganciata dal PBX, che dopo alcuni istanti procede a contattare tutti i terminali di destinazione, riproducendo il messaggio preregistrato specificato alla voce "File audio"
* '''File audio''': file audio contenente un messaggio preregistrato che viene riprodotto ai terminali di destinazione del gruppo. Viene utilizzato in modo differente nel caso di modalità Live o Unattended:
** Live: questo messaggio viene riprodotto prima di mettere in comunicazione il chiamante con i terminali di destinazione. L'uso tipico può essere quello di un avviso sonoro per indicare l'inizio di una comunicazione
** Unattended: questo è il messaggio che viene riprodotto a tutte le destinazioni del gruppo di Paging. In base al valore del successivo parametro (Numero di ripetizioni), il messaggio può essere riprodotto una o più volte ciclicamente.
* '''Numero di ripetizioni''': questo parametro è configurabile solo nella modalità "Unattended" e specifica il numero di volte che il messaggio preregistrato deve essere riprodotto prima che il PBX termini automaticamente la chiamata. Il valore 0 indica che il messaggio deve essere riprodotto in ciclo continuo; nella modalità "Unattended", indipendentemente dal numero di ripetizioni impostate, una seconda chiamata al numero del gruppo effettua l'arresto della riproduzione del messaggio. Nota: non è necessario che la seconda chiamata sia effettuata dallo stesso interno che ha attivato il servizio, purché sia uno di quelli abilitati, secondo le regole descritte sotto.
* '''Metodo di risposta automatica''': questo parametro specifica quale eventuale Header aggiungere alle chiamate effettuate verso i terminali di destinazione, al fine di specificare la richiesta di risposta automatica. La scelta dello specifico Header da utilizzare dipende dai terminali utilizzati come destinazioni del gruppo, in quanto differenti terminali possono richiedere differenti modalità di notifica della richiesta di risposta automatica. L'opzione prevede tre alternative:
** Configurazione manuale: significa che il PBX non specifica alcun Header aggiuntivo, e la configurazione per effettuare la risposta automatica deve quindi essere effettuata in modo statico sui terminali di destinazione. Il caso d'uso tipico è quello dei dispositivi dedicati alla diffusione.
** Header Call-Info: viene aggiunto l'header "Call-Info: <sip:127.0.0.1>;answer-after=0"
** Header Alert-Info: viene aggiunto l'header "Alert-Info: <http://127.0.0.1>;info=alert-autoanswer;delay=0"
* '''Account''': elenco dei terminali di destinazione del Paging. NOTA: le destinazioni sono i singoli account SIP, per cui in caso di interni con più di un account SIP associato, può essere scelto a quali di questi inoltrare la chiamata.
* '''Controllo di accesso''': specifica le autorizzazioni per l'attivazione del servizio. E' possibile indicare una o più regole di accesso, nella forma:
** Interno: l'interno chiamante, oppure "Qualsiasi interno"
** Tipo di PIN: la modalità di autenticazione richiesta. I valori possibili sono:
*** Nessuno: non è richiesto PIN. Gli interni con tale tipo di autenticazione attivano il servizio senza dover inserire alcun PIN.
*** Personalizzato: è richiesto uno specifico PIN configurato nella colonna seguente (Valore del PIN). Tale PIN potrebbe quindi essere unico per tutti gli interni abilitati, o essere differenziato per singolo interno.
*** PIN dei servizi dell'interno: è richiesta l'autenticazione utilizzando il PIN dei servizi proprio di ciascun interno abilitato.
Un esempio di ACL potrebbe essere:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Interno !! Tipo di PIN !! Valore del PIN
! Extension !! Type of PIN !! Value of PIN
|-
|-
| 101 (Interno 101) || Nessuno ||   
| 101 (Extension 101) || None ||   
|-
|-
| 102 (Interno 102) || PIN dei servizi dell'interno ||   
| 102 (Extension 102) || Extension service PIN ||   
|-
|-
| Qualsiasi || Personalizzato || 123123
| Any || Custom || 123123
|-
|-
|}
|}
In questo caso, l'interno 101 è abilitato all'attivazione del servizio (ed anche disattivazione, nel caso di Modalità "Unattended") senza necessità di specificare alcun PIN. L'interno 102 è abilitato previa autenticazione con il proprio PIN dei servizi, mentre tutti gli altri interni sono abilitati previa autenticazione con il PIN 123123,
In this example, extension 101 can activate the service (or deactivate it if it is set to "Unattended") without needing to input any PIN. Extension 102 can use the service after dialing their service PIN, while all other extensions need to dial 123123.




=== Interoperabilità con dispositivi di terze parti ===
=== Interoperability ===
La configurazione della modalità di risposta automatica è legata ai terminali utilizzati come destinazioni del Paging, in quanto differenti terminali possono richiedere differenti modalità di segnalazione della richiesta. Il servizio è stato testato con terminali SNOM (firmware 8.7.5.13) e Yealink (firmware v80) e richiede che la configurazione del telefono sia predisposta per l'accettazione delle richieste. Altri modelli sono in fase di testing ed eventuali nuovi Header necessari saranno aggiunti nel tempo, se necessari.  
The configuration of the automatic answer is tied to the terminals, as different devices might require different ways of signaling requests. The service has been tested with SNOM (firmware 8.7.5.13) and Yealink (firmware v80) terminals and requires the phone to be configured to accept requests. Other models are currently being tested and new headers will be added in the future if necessary.  


Nello specifico:
Specifically:
* nel caso di configurazione del gruppo di Paging senza invio di Header addizionali (e quindi di utilizzo di terminali dedicati agli annunci), deve essere abilitata sui telefoni l'opzione di risposta automatica. Questa impostazione può essere effettuata sia tramite provisioning che tramite la web GUI del singolo telefono. Come riferimento, le voci di configurazione dei terminali testati sono:
* If the paging group is configured not to send additional headers (and therefore uses terminals dedicated to making announcements), automatic answer must be enabled on all phones. This can be done either through provisioning or through the web GUI of each phone. The relevant settings for each tested phone are:
** SNOM: impostazione "Auto Answer" nel pannello "Account -> SIP" (http://wiki.snom.com/wiki/index.php/Settings/user_auto_connect)
** SNOM: "Auto Answer" setting in the "Account -> SIP" page; (http://wiki.snom.com/wiki/index.php/Settings/user_auto_connect)
** Yealink: impostazione "Auto Answer" nel pannello "Account -> Basic"
** Yealink: "Auto Answer" setting in the "Account -> Basic" page.
* nel caso di inserimento nel gruppo di terminali non dedicati, è necessario l'invio dell'Header per indicare la richiesta di risposta automatica. I terminali devono essere configurati per accettare l'indicazione fornita dall'Header, altrimenti questo viene ignorato ed è necessaria quindi la risposta manuale da parte di un utente:
* For non-dedicated terminals, it is necessary to send a header to request automatic answer. The terminals must be configured to accept the directions given by the header, otherwise it will be ignored and the user will need to answer manually.
** SNOM: è necessario modificare il valore della voce "Intercom Policy" all'interno del pannello "Advanced -> Behavior" (di default è disabiltata). Fare riferimento alla pagina http://wiki.snom.com/Settings/answer_after_policy per la relativa configurazione. Sono stati testati entrambi gli Header, con esito positivo. NOTA: alla risposta automatica, il telefono di default emette un tono di avviso; è possibile disattivare il tono agendo sull'opzione "Auto Connect Indication" (http://wiki.snom.com/Settings/auto_connect_indication)
** SNOM: edit the "Intercom Policy" setting in the "Advanced -> Behavior" page (disabled by default). See http://wiki.snom.com/Settings/answer_after_policy for the configuration. Both headers were tested with positive outcome. N.B.: upon automatic answer, the phone will, by default, emit an announcement tone; this can be disabled by editing the "Auto Connect Indication" setting (http://wiki.snom.com/Settings/auto_connect_indication).
** Yealink: l'abilitazione al rispetto degli Header di risposta automatica (e l'attivazione o meno della riproduzione del tono alla risposta automatica) viene effettuata dal pannello "Features -> Intercom"
** Yealink: automatic answer headers (and announcement tones) can be enabled or disabled in the "Features -> Intercom" page.
** Grandstream: l'abilitazione al rispetto degli Header di risposta automatica viene effettuata dal pannello "Accounts-> AccountX-> CallSettings-> Allow Auto Answer by Call-Info".  Deve quindi essere abilitata la richiesta tramite il campo Header Call-Info.
** Grandstream: automatic answer headers can be enabled in the "Accounts -> AccountX -> CallSettings -> Allow Auto Answer by Call-Info" page.  Header Call-Info requests are required.

Versione attuale delle 21:12, 25 set 2022

Altre lingue:

Return to AdminGuide:Service


Paging service

  • Introduced with firmware version 4.3.1
Paging.png

Description

The paging service lets a user send a live or prerecorded audio message to multiple destinations simultaneously, with the option of having devices answer automatically when they receive the message. This service is used to make informative or emergency announcements.

KalliopePBX lets you define an arbitrary number of "paging groups". Each one is independent from the others and is fully configurable when it comes to permissions, choice of destinations, mode of operation, and messages.

An extension can make a call to a code comprised of a paging service prefix (set when enabling the service in the numbering plan, by default *53) followed by the paging group number (set in the configuration page for the group). If authentication is necessary, KalliopePBX will play the "Password" audio file and the user will need to input a PIN (the one set in the group configuration or their personal one) followed by #. If authentication is successful the paging group will be activated according to its configuration, detailed in the following section.

Configuration

Paging groups can be created and edited in the PBX -> Paging groups page.

The following table describes the configuration parameters of each group are:

Parameter
Description
Value
Name Identifier assigned to the Paging group Alphanumeric
Number Selection of Paging Service Numeric
Caller ID Display Name for calls to destination terminals Alphanumeric
Modality Mode of operation of the Paging group Live/Unattended
Audio file Audio file containing a prerecorded message that is played at the destination terminals of the group. It is used differently in the case of Live or Unattended mode
Repetitions number Number of times the prerecorded message must be played before the PBX automatically ends the call (configurable only in "Unattended" mode) Numeric (0 indicates that the message is to be played in a continuous loop)
Automatic response method Header to be added to calls made to destination terminals in order to specify the automatic response request Manual configuration/Call-Info/Header Alert-Info
Account
Extension Paging target terminals
Account SIP account associated with the extension
Access control
Extension Caller extension "Any extension"/Extension
PIN type Authentication mode required None/Custom/ Authentication mode required.
Pin value Alphanumeric

Modality

The operating mode of the paging groups: can be set as either "Live" or "Unattended". In Live mode the extension making the call to the paging group will remain on call as the sole speaker; at the end of the call, they will hang up, and the calls to all destinations will themselves end. In Unattended mode the PBX hangs up the call made from the extension to the paging group and, after a few moments, proceeds to contact all destinations and play the message set under the "Audio file" item.

The audio file will be used differently depending on whether the mode is set to "Live" or "Unattended":

  • Live: the message is played before the caller begins communication with the group. This can be used to mark the beginning of an announcement.
  • Unattended: the message is played to all destinations in the paging group. Depending on the following setting (Number of repetitions), the message can be played once or multiple times.

In Unattended mode a second call to the group number will stop message playback regardless of the number of repetitions set.

N.B.:: the second call does not need to be made from the extension that activated the service as long as it is enabled to use the service according to the rules described below.

Access control specifies the permissions necessary to use the service. You can specify one or more access rules of the form, specifying which extensions can use the service (one, more than one, or any) and if an activation PIN is required.

An example of ACL is:

Extension Type of PIN Value of PIN
101 (Extension 101) None
102 (Extension 102) Extension service PIN
Any Custom 123123

In this example, extension 101 can activate the service (or deactivate it if it is set to "Unattended") without needing to input any PIN. Extension 102 can use the service after dialing their service PIN, while all other extensions need to dial 123123.


Interoperability

The configuration of the automatic answer is tied to the terminals, as different devices might require different ways of signaling requests. The service has been tested with SNOM (firmware 8.7.5.13) and Yealink (firmware v80) terminals and requires the phone to be configured to accept requests. Other models are currently being tested and new headers will be added in the future if necessary.

Specifically:

  • If the paging group is configured not to send additional headers (and therefore uses terminals dedicated to making announcements), automatic answer must be enabled on all phones. This can be done either through provisioning or through the web GUI of each phone. The relevant settings for each tested phone are:
  • For non-dedicated terminals, it is necessary to send a header to request automatic answer. The terminals must be configured to accept the directions given by the header, otherwise it will be ignored and the user will need to answer manually.
    • SNOM: edit the "Intercom Policy" setting in the "Advanced -> Behavior" page (disabled by default). See http://wiki.snom.com/Settings/answer_after_policy for the configuration. Both headers were tested with positive outcome. N.B.: upon automatic answer, the phone will, by default, emit an announcement tone; this can be disabled by editing the "Auto Connect Indication" setting (http://wiki.snom.com/Settings/auto_connect_indication).
    • Yealink: automatic answer headers (and announcement tones) can be enabled or disabled in the "Features -> Intercom" page.
    • Grandstream: automatic answer headers can be enabled in the "Accounts -> AccountX -> CallSettings -> Allow Auto Answer by Call-Info" page. Header Call-Info requests are required.
Estratto da "https://www.kalliope.com/wiki/index.php?title=AdminGuide:Service:Paging/en&oldid=17914"