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

Versione attuale delle 08:32, 20 apr 2022

Altre lingue:

English
italiano

Description

This service lets one or more users (secretaries) intercept calls to another extension (boss). Only the secretaries (and, optionally, other bosses in a customizable group) will be able to directly contact a boss on their extension. The secretaries have the task of answering calls, checking whether the boss is available, and, if necessary, forwarding them to the boss.

The secretaries have the task of answering calls, checking whether the boss is available, and, if necessary, forwarding them to the boss.

The service can be enabled or disabled on a group level (for all secretaries) or just for one. In practice, a boss enabling the service will usually enable it for all secretaries, while individual secretaries can choose to enter or exit the service. Even if the boss has not enabled the service, a secretary can do so for their own extension.

The boss/secretary service can be enabled by dialing the corresponding codes. The service can be enabled on a group level with the activation code (by default *521) followed by the extension number of the boss. KalliopePBX will confirm the activation by playing the "Saved" audio file. The service can be enabled for a specific secretary by adding to the global code * followed by the extension number of the secretary. KalliopePBX will confirm the activation by playing the "Saved" audio file.

Similarly, the service can be disabled by dialing the deactivation code (by default *520) followed by the extension number of the boss. KalliopePBX will confirm the activation by playing the "Saved" audio file. The service can be disabled for a specific secretary by adding to the global code * followed by the extension number of the secretary. KalliopePBX will confirm the activation by playing the "Saved" audio file.

There is also a code to invert the state of the service (by default *52). Similarly to activation/deactivation, the code must be followed by the extension number of the boss to act on a group level, while the state of the service can be inverted for an individual secretary by adding to the global code * followed by the extension number of the secretary. In both cases, KalliopePBX will confirm the activation by playing the "Saved" audio file.

These codes can only be used from a phone linked to an extension that belongs to the boss/secretary group.

Configuration

The service can be globally enabled and the service codes can be changed in the PBX -> Numbering plan page.

The configuration of the Director-Secretary groups is done in the panel Director-Secretary Groups. The parameters to be configured for the groups are as follows:

Parameter	Description	Value
-
Enabled	Lets you disable a boss/secretary filter without losing its configuration.	Yes / No
Name	Boss/secretary group identifier.	Alphanumeric
Allow calls from other bosses	If this option is enabled, extensions labeled as bosses in other groups will be able to call the boss directly without passing through the filter.	Yes / No
Select boss	The extension whose calls will be intercepted by the secretaries.	Extension
Add secretary	The list of extensions that will intercept the calls to the boss.	Extension

Failovers

Here failover actions are defined in case one of the overflow causes occurs for calls diverted to secretaries. The additional failover action "Forward to Director" is provided for this service.

Failovers
Parameter	Description	Value
Extension	Failover action on calls from extensions (including remote extensions).
External	Failover action on calls from external numbers.
Transfer	Failover action on call transfers.
Timeout (sec.)	Interval of time at the end of which the configured failover action will be executed if the call is not answered (no secretary picks up the call in time).	Numeric
No answer	The call is considered unanswered after the specified time has passed.	Forward to the boss / Hang up / Custom selection / Ask for selection / External number / Extension / Group / Queue / Checktime / IVR / Voicemail / MeetMe room
Busy	All secretary extensions are busy. The extension is considered busy if the configured Busy Level has been reached, or if the terminal sends a 486 Busy Here SIP Response.
Not available	All secretary extensions are unavailable. The extension is considered busy if the terminal is not registered or not reachable at an IP level, or if the terminal sends a 480 Temporarily Unavailable SIP Response.

Interoperability

When enabling/disabling the service from the phone, it can be useful to have a key (with Busy Lamp Field) that lets you verify the state of the service.

For monitoring, KalliopePBX sends SIP NOTIFY messages to communicate changes of state. The phone must send a SIP SUBSCRIBE message to request this information.

This operation is normally executed by configuring a BLF-type function key.

The object that needs to be monitored is bs<boss_extension> to monitor the state of the service on a group level and bs<boss_extension>*<secretary_extension> to monitor the state of the service for a secretary in a specific group. The state of the service on a group level will be active when is is enabled for at least one secretary.

Other than monitoring the state the service, it is also possible to invert it by pressing the corresponding function key.

The key to control the service on a group level is usually enabled on the boss' phone, while the keys for specific extension are enabled on the secretary's phone.

The keys can be configured for all members of the group to accommodate specific requirements (e.g. the boss might wish to set the state of specific secretaries or let the secretaries set the state on a group level).

Examples

On SNOM

Through the web GUI, you can configure function keys with:

Account: select the account from the drop-down (if only one account is configured on the phone, it will be the first in the list)

Type: BLF

value: bs<boss_extension> / bs<boss_extension>*<secretary_extension>

Or you can directly edit the configuration file or the template:

<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<boss_extension>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>

or

<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<boss_extension>*<secretary_extension>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>

where %%id%% is the ID of the key to configure and %%line_id%% is the ID of the corresponding account (1 if the account is the only one on the phone).

Example:

<fkey idx="0" context="1" label="DirSeg 109" perm="">blf sip:bs109*105@192.168.23.112</fkey>

On YEALINK

Through the web GUI, you can configure DSS keys with:

Type BLF

Value: bs<boss_extension> / bs<boss_extension>*<secretary_extension>

Line: The line associated with the account (Line 1 if the account is the only one on the phone)

Or you can directly edit the configuration file or the template:

memorykey.%%id%%.line=%%line_id%%>

memorykey.%%id%%.value=bs<boss_extension> / bs<boss_extension>*<secretary_extension>

memorykey.%%id%%.type=16

where %%id%% is the ID of the key to configure

and %%line_id%% is the ID of the corresponding account (1 if the account is the only one on the phone).

Example:

memorykey.1.line = 1

memorykey.1.value = bs109*105

memorykey.1.type = 16

memorykey.1.pickup_value = %NULL%

@@ Riga 1: / Riga 1: @@
 <languages />
+Return to [[AdminGuide:Service/en|AdminGuide:Service]]
 <div class="noutonum" style="float: right">__TOC__</div>
-== Descrizione ==
+== Description ==
-Questo servizio consente ad una o più utenze ('''segretarie''') di intercettare le chiamate dirette ad un altro interno ('''direttore'''). Solamente le segretarie (ed opzionalmente i direttori configurati in altri gruppi) potranno contattare direttamente il direttore sul proprio interno.
+This service lets one or more users ('''secretaries''') intercept calls to another extension ('''boss'''). Only the secretaries (and, optionally, other bosses in a customizable group) will be able to directly contact a boss on their extension.
+The secretaries have the task of answering calls, checking whether the boss is available, and, if necessary, forwarding them to the boss.
+The secretaries have the task of answering calls, checking whether the boss is available, and, if necessary, forwarding them to the boss.
+The service can be enabled or disabled on a group level (for all secretaries) or just for one. In practice, a boss enabling the service will usually enable it for all secretaries, while individual secretaries can choose to enter or exit the service. Even if the boss has not enabled the service, a secretary can do so for their own extension.
+The boss/secretary service can be enabled by dialing the corresponding codes. The service can be enabled on a group level with the activation code (by default '''*521''') followed by the extension number of the boss. KalliopePBX will confirm the activation by playing the "Saved" audio file. The service can be enabled for a specific secretary by adding to the global code * followed by the extension number of the secretary. KalliopePBX will confirm the activation by playing the "Saved" audio file.
+Similarly, the service can be disabled by dialing the deactivation code (by default '''*520''') followed by the extension number of the boss. KalliopePBX will confirm the activation by playing the "Saved" audio file. The service can be disabled for a specific secretary by adding to the global code * followed by the extension number of the secretary. KalliopePBX will confirm the activation by playing the "Saved" audio file.
+There is also a code to invert the state of the service (by default '''*52'''). Similarly to activation/deactivation, the code must be followed by the extension number of the boss to act on a group level, while the state of the service can be inverted for an individual secretary by adding to the global code * followed by the extension number of the secretary. In both cases, KalliopePBX will confirm the activation by playing the "Saved" audio file.
-Le segretarie avranno quindi il compito di rispondere alle chiamate dirette all’interno del direttore, verificare la disponibilità del direttore ed eventualmente trasferire la chiamata.
+These codes can only be used from a phone linked to an extension that belongs to the boss/secretary group.
-Il servizio può essere abilitato / disabilitato sia a livello di gruppo (su tutte le segretarie) che per la specifica segretaria. Nella pratica di solito il direttore quando attiva il servizio lo imposta per tutte le segretarie, mentre la singola segretaria può decidere di entrare o uscire dal servizio. Anche se il direttore non ha attivato il servizio, la segretaria può attivarlo per il proprio interno.
+== Configuration ==
-Operativamente l’attivazione/disattivazione del servizio Direttore-Segretaria può essere effettuata mediante digitazione di codici da telefono.
+The service can be globally enabled and the service codes can be changed in the PBX -> [[AdminGuide:Service:NumberingPlan/en|Numbering plan]] page.
-Il servizio viene attivato a livello di gruppo digitando il codice di attivazione (default '''*521''') seguito dall'interno del direttore. Il KalliopePBX conferma l’attivazione del servizio riproducendo il file audio “''Salvato''”. L’attivazione per la specifica segretaria viene invece effettuata aggiungendo al codice globale * seguito dall'interno della segretaria. Anche in questo caso il KalliopePBX conferma l’attivazione riproducendo il file audio “''Salvato''”.
-Analogamente la disattivazione a livello di gruppo avviene digitando il codice relativo (default '''*520''') seguito dall'interno del direttore. Il KalliopePBX conferma la disattivazione riproducendo il file audio “''Salvato''”. La disattivazione per la specifica segretaria viene invece effettuata aggiungendo al codice globale * seguito dall'interno della segretaria. Anche in questo caso il KalliopePBX conferma la disattivazione riproducendo il file audio “''Salvato''”.
+The configuration of the Director-Secretary groups is done in the panel '''Director-Secretary Groups'''.
+The parameters to be configured for the groups are as follows:
-Esiste anche un codice di commutazione dello stato del servizio (default '''*52*'''). Analogamente al caso di attivazione / disattivazione il codice deve essere seguito dall'interno del direttore per la commutazione dello stato del servizio per tutto il gruppo. La commutazione dello stato del servizio per la specifica segretaria viene invece effettuata aggiungendo al codice globale * seguito dall'interno della segretaria. In entrambi i casi il KalliopePBX conferma la commutazione riproducendo il file audio “''Salvato''”.
+{| class="wikitable"
+|-
+! <div style = 'text-align: left> '''Parameter''' !! <div style = 'text-align: left> '''Description''' !! <div style = 'text-align: left> '''Value'''
+|-
+|colspan="3"| <div style = 'text-align: center; color: transparent> -
+|-
+| Enabled || Lets you disable a boss/secretary filter without losing its configuration. || Yes / No
+|-
+| Name || Boss/secretary group identifier. || Alphanumeric
+|-
+| Allow calls from other bosses || If this option is enabled, extensions labeled as bosses in other groups will be able to call the boss directly without passing through the filter. || Yes / No
+|-
+| Select boss || The extension whose calls will be intercepted by the secretaries. || Extension
+|-
+| Add secretary || The list of extensions that will intercept the calls to the boss. || Extension
+|}
-Questi codici possono essere utilizzati esclusivamente da un dispositivo associato ad un interno che appartiene al Gruppo Direttore-Segretaria.
+===Failovers===
-== Configurazione ==
+Here failover actions are defined in case one of the overflow causes occurs for calls diverted to secretaries. The additional failover action "Forward to Director" is provided for this service.
-L'abilitazione globale del servizio e la scelta del codice di servizio associato viene effettuata nel pannello [[AdminGuide:GUI:OperatingMenu:NumberingPlan|PBX->Piano di numerazione]] ed eventualmente modificare il codice da utilizzare.
-La configurazione dei gruppi Direttori-Segretaria viene effettuata nel pannello [[AdminGuide:GUI:OperatingMenu:BossSecretaryFilter|Applicazioni PBX->Gruppi Direttore-Segretaria]]'''''.
+{| class="wikitable"
+!colspan="3"| <div style = 'text-align: left> '''Failovers'''
+|-
+! <div style = 'text-align: left> '''Parameter''' !! <div style = 'text-align: left> '''Description''' !! <div style = 'text-align: left> '''Value'''
+|-
+| Extension
+|colspan="2"| Failover action on calls from extensions (including remote extensions).
+|-
+| External
+|colspan="2"| Failover action on calls from external numbers.
+|-
+| Transfer
+|colspan="2"| Failover action on call transfers.
+|-
+| Timeout (sec.) || Interval of time at the end of which the configured failover action will be executed if the call is not answered (no secretary picks up the call in time). || Numeric
+|-
+| No answer || The call is considered unanswered after the specified time has passed. ||rowspan="3"| Forward to the boss / Hang up / Custom selection / Ask for selection / External number / Extension / Group / Queue / Checktime / IVR / Voicemail / MeetMe room
+|-
+| Busy || All secretary extensions are busy. The extension is considered busy if the configured Busy Level has been reached, or if the terminal sends a 486 Busy Here SIP Response.
+|-
+| Not available || All secretary extensions are unavailable. The extension is considered busy if the terminal is not registered or not reachable at an IP level, or if the terminal sends a 480 Temporarily Unavailable SIP Response.
+|-
+|}
-== Interoperabilità con dispositivi di terze parti ==
+== Interoperability ==
-Quando l’attivazione / disattivazione del servizio viene effettuata da telefono può essere molto utile avere a disposizione un tasto (con campo lampade) che consenta di verificare lo stato del servizio.
+When enabling/disabling the service from the phone, it can be useful to have a key (with Busy Lamp Field) that lets you verify the state of the service.
-Per quanto riguarda il monitoraggio, il KalliopePBX invia dei messaggi SIP NOTIFY per comunicare i cambi di stato del servizio. Il telefono dovrà inviare una SIP SUBSCRIBE per richiedere l’invio delle informazioni di stato.
+For monitoring, KalliopePBX sends SIP NOTIFY messages to communicate changes of state. The phone must send a SIP SUBSCRIBE message to request this information.
-Questa operazione è normalmente effettuata configurando un tasto funzione di tipo BLF.
+This operation is normally executed by configuring a BLF-type function key.
-L’oggetto da monitorare è <code>bs<interno_direttore></code> se vogliamo monitorare lo stato a livello di gruppo e <code>bs<interno_direttore>*<interno_segretaria></code> per monitorare lo stato del servizio per la segretaria sullo specifico gruppo. Lo stato a livello di gruppo risulta attivo nel caso in cui il servizio sia attivo per almeno una segretaria.
+The object that needs to be monitored is <code>bs<boss_extension></code> to monitor the state of the service on a group level and <code>bs<boss_extension>*<secretary_extension></code> to monitor the state of the service for a secretary in a specific group. The state of the service on a group level will be active when is is enabled for at least one secretary.
-Oltre a monitorare lo stato del servizio è possibile effettuarne la commutazione cliccando sul tasto funzione corrispondente.
+Other than monitoring the state the service, it is also possible to invert it by pressing the corresponding function key.
-Tipicamente il tasto con il controllo a livello di gruppo viene abilitato sul telefono del direttore mentre i tasti con il controllo specifico per interno sul telefono della segretaria corrispondente.
+The key to control the service on a group level is usually enabled on the boss' phone, while the keys for specific extension are enabled on the secretary's phone.
-In ogni caso i tasti sono configurabili su tutti i membri del gruppo per soddisfare esigenze specifiche (ad es. il direttore potrebbe richiedere di voler impostare lo stato del servizio delle specifiche segretarie oppure lo stato a livello di gruppo può essere impostato da una segretaria).
+The keys can be configured for all members of the group to accommodate specific requirements (e.g. the boss might wish to set the state of specific secretaries or let the secretaries set the state on a group level).
-=== Esempi di configurazione ===
+=== Examples ===
-==== Su SNOM ====
+==== On SNOM ====
-[[File:Snom_boss_secretary.png|miniatura]]
+[[File:Snom fork2mobile.png|miniatura]]
-* Operando tramite la web gui di configurazione configurare Function keys con
+* Through the web GUI, you can configure function keys with:
 <code>
-Account: ''selezionare dalla tendina l’account che stiamo utilizzando (se c’è un solo account configurato sul telefono è il primo della lista)''
+Account: ''select the account from the drop-down (if only one account is configured on the phone, it will be the first in the list)''
 Type: BLF
-value: bs<interno_direttore> / bs<interno_direttore>*<interno_segretaria>
+value: bs<boss_extension> / bs<boss_extension>*<secretary_extension>
 </code>
-* In alternativa modificando direttamente il file di configurazione o il template in questo modo:
+* Or you can directly edit the configuration file or the template:
 <code>
-<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<interno_direttore>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>
+<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<boss_extension>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>
 </code>
-oppure
+or
 <code>
-<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<interno_direttore>*<interno_segretaria>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>
+<fkey idx="%%id%%" context="%%line_id%%" label="" perm="">blf sip:bs<boss_extension>*<secretary_extension>@%%KPBX_IP_ADDRESS%%;user=phone</fkey>
 </code>
-Dove  ''%%id%%''  è l’identificativo del tasto da configurare
+where ''%%id%%'' is the ID of the key to configure and ''%%line_id%%'' is the ID of the corresponding account (1 if the account is the only one on the phone).
-E  ''%%line_id%%''  è l’identificativo dell’account associato (il valore è 1 se sul telefono è presente un solo account)
-Esempio:
+Example:
 <code><fkey idx="0" context="1" label="DirSeg 109" perm="">blf sip:bs109*105@192.168.23.112</fkey></code>
-==== Su YEALINK ====
+==== On YEALINK ====
 [[File:yealink_boss_secretary.png|miniatura]]
-* Operando tramite la web gui di configurazione configurare DSS Key con
+* Through the web GUI, you can configure DSS keys with:
 <code>
 Type BLF
-Value: bs<interno_direttore> / bs<interno_direttore>*<interno_segretaria>
+Value: bs<boss_extension> / bs<boss_extension>*<secretary_extension>
-Line: La linea associata all’account che stiamo utilizzando (Line 1 se sul telefono è presente un solo account)
+Line: The line associated with the account (Line 1 if the account is the only one on the phone)
 </code>
-* Oppure modificando direttamente il file di configurazione o il template in questo modo:
+* Or you can directly edit the configuration file or the template:
 <code>
 memorykey.%%id%%.line=%%line_id%%>
-memorykey.%%id%%.value=bs<interno_direttore> / bs<interno_direttore>*<interno_segretaria>
+memorykey.%%id%%.value=bs<boss_extension> / bs<boss_extension>*<secretary_extension>
 memorykey.%%id%%.type=16
@@ Riga 91: / Riga 140: @@
 </code>
-Dove ''%%id%%'' è l’identificativo del tasto da configurare
+where ''%%id%%'' is the ID of the key to configure
-e ''%%line_id%%'' è l’identificativo dell’account associato il valore è 1 se sul telefono è presente un solo account)
+and ''%%line_id%%'' is the ID of the corresponding account (1 if the account is the only one on the phone).
-Esempio:
+Example:
 <code>