Configure

Enterprise Telephony > Common > Call Transfers > Call Transfer Whitelist

Enabling Forward Whitelist

To use forward whitelist, it must be enabled and allowed whitelist extensions must be defined.

Location: Terminal Profile Settings, Terminal Boot Settings

User Settings

Enable forward/divert/transfer whitelist	truefalse
Key: profile.setting.forward.whitelist.enabled Description: When this feature is enabled, all forwarding/diverting/transfering actions will be blocked if the target extension is not present in the whitelist (provided by the setting key "profile.setting.forward.whitelist") Constraint: true\|false Related settings: Voice mail (profile.setting.voicemailuri) Divert button enabled (profile.setting.callstatus.divert.enabled) Held auto forward timer (profile.setting.held.autoforward.timer) Held auto forward timer (per line) (profile.setting.held.autoforward.XXXX.timer) Held auto forward target (profile.setting.held.autoforward.target) Held auto forward target (per line) (profile.setting.held.autoforward.XXXX.target) Shared lines forwarding (profile.setting.forward.sharedlines) Shared lines DND forwarding (profile.setting.dnd.forward.sharedlines) Forward all extensions (profile.setting.forwardall.extensions) Show Forward button in Room for local lines (profile.setting.room.line.showforward) Show DND Forward button in Room for local lines (profile.setting.room.line.showdndforward) Show Forward button in Room for DDI lines (profile.setting.room.ddiline.showforward) Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Global forward when DND (profile.setting.dnd.global.forward) Enable transfer whitelist (profile.setting.transfer.whitelist.enabled) Forward whitelist wildcard (profile.setting.forward.wildcard) separate transfer and forward whitelists (profile.setting.transfer.whitelist.separated)

Location: Terminal Profile Settings, Terminal Boot Settings

User Settings

Allowed extensions for diverting/forwarding/dispatching
Key: profile.setting.forward.whitelist Description: When the setting "profile.setting.forward.whitelist.enabled" is set to true, all actions that is trying to forward/transfer/divert/dispatch a call to a target not present in the list will be disallowed. Voice-messaging extension and other configurable forward extensions will not be added automatically to that list, you must add it manually. If the setting key "profile.setting.dialingrule.onforward" is enabled, when the dialing rule is applied to the forward target, the turret will check if the target match an extension of the list before or after the dial plan. If it matches one of them, the forward will be allowed. If a domain is specified (i.e. john.doe@sfb.local), the forward target has to match the complete URI (extension + domain). The whitelist can contain extensions with wildcard defined with the setting "profile.setting.forward.wildcard". Constraint: List of extensions separated by semicolons. Example: 1102;81302;8006;12..; Where dot '.' is a wildcard Related settings: Held auto forward target (profile.setting.held.autoforward.target) Held auto forward target (per line) (profile.setting.held.autoforward.XXXX.target) DND forwarding backup delay (application.dnd.fwd.backup.delay) Show Forward button in Room for local lines (profile.setting.room.line.showforward) Show DND Forward button in Room for local lines (profile.setting.room.line.showdndforward) Show Forward button in Room for DDI lines (profile.setting.room.ddiline.showforward) Enable forward/divert/transfer whitelist (profile.setting.forward.whitelist.enabled) Enable dial plan application on a forward rule's target (profile.setting.dialplan.onforward) Global forward when DND (profile.setting.dnd.global.forward) Dial plan - Activate dial rule on forward (profile.setting.dialingrule.onforward) Enable transfer whitelist (profile.setting.transfer.whitelist.enabled) Forward whitelist wildcard (profile.setting.forward.wildcard) separate transfer and forward whitelists (profile.setting.transfer.whitelist.separated) allowed extensions for transfer (profile.setting.transfer.whitelist)

Differentiate Transfering actions from Forwarding actions

Transfer actions can be differentiate from forward actions. Transfer whitelist must be enabled.

Location: Terminal Profile Settings, Terminal Boot Settings

User Settings

Enable transfer whitelist	truefalse
Key: profile.setting.transfer.whitelist.enabled Description: When this feature and ''profile.setting.forward.whitelist.enabled' are enabled, all transfering actions will be blocked if the target extension is not present in the whitelist (provided by the setting key "profile.setting.forward.whitelist") Constraint: true\|false Related settings: Enable forward/divert/transfer whitelist (profile.setting.forward.whitelist.enabled) Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Forward whitelist wildcard (profile.setting.forward.wildcard) separate transfer and forward whitelists (profile.setting.transfer.whitelist.separated) allowed extensions for transfer (profile.setting.transfer.whitelist)

By default, the whitelist is the same for the transfer and forward actions. To use separate whitelists, separation of whitelist must be enabled and allowed extensions for transfer must be defined.

Location: Terminal Profile Settings

User Settings

separate transfer and forward whitelists	truefalse
Key: profile.setting.transfer.whitelist.separated Description: When set to false, the transfer functionality will use the forward whitelist as its whitelist. (profile.setting.forward.whitelist) When set to true, it will use the transfer whitelist. (profile.setting.transfer.whitelist) Related settings: Enable forward/divert/transfer whitelist (profile.setting.forward.whitelist.enabled) Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Enable transfer whitelist (profile.setting.transfer.whitelist.enabled) allowed extensions for transfer (profile.setting.transfer.whitelist)

Location: Terminal Profile Settings

User Settings

allowed extensions for transfer
Key: profile.setting.transfer.whitelist Description: When the setting "profile.setting.transfer.whitelist.enabled" and "profile.setting.transfer.whitelist.separated" are set to true, all actions that is trying to transfer a call to a target not present in the list will be disallowed. The whitelist can contain extensions with wildcard defined with the setting "profile.setting.forward.wildcard". Constraint: List of extensions separated by semicolons. Example: 1102;81302;8006;12..; Where dot '.' is a wildcard Related settings: Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Enable transfer whitelist (profile.setting.transfer.whitelist.enabled) Forward whitelist wildcard (profile.setting.forward.wildcard) separate transfer and forward whitelists (profile.setting.transfer.whitelist.separated)

Forward Wildcard

Forward whitelist can contain wildcards. By default, wildcard is '.' character but it can be changed by another character.

Location: Terminal Profile Settings, Terminal Boot Settings

User Settings

Forward whitelist wildcard
Key: profile.setting.forward.wildcard Description: Defines wildcard to be applied to forward whitelist Constraint: By default, the forward whitelist defined with the setting "profile.setting.forward.whitelist" can contain dot wildcard: 11.. where '.' is a character. This setting allows to replace default wildcard with any other character string. Blank this setting for not to use any wildcard. Related settings: Enable forward/divert/transfer whitelist (profile.setting.forward.whitelist.enabled) Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Enable transfer whitelist (profile.setting.transfer.whitelist.enabled) allowed extensions for transfer (profile.setting.transfer.whitelist)

Enable dial plan on forward rule's target

Location: Terminal Boot Settings, Terminal Profile Settings

Dial Plan

Enable dial plan application on a forward rule's target	truefalse
Key: profile.setting.dialplan.onforward Description: When setting up a forwarding rule, either a global forward with the forward access button or a partial forward from the DDI Line edition in the room panel; defines if the dial plan is applied. Note: This setting requires the dial plan to be enabled and configured (see profile.setting.dialplan.enabled) Constraint: true\|false Related settings: Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist) Enable dial plan application (profile.setting.dialplan.enabled)

Location: Terminal Profile Settings

Dial Plan

Dial plan - Activate dial rule on forward	truefalse
Key: profile.setting.dialingrule.onforward Description: When setting up a forwarding rule, either a global forward with the forward access button or a partial forward from the DDI Line edition in the room panel; defines if the dial plan is applied. Note: This setting requires the dial plan to be enabled and configured (see profile.setting.dialingrule.enabled) Constraint: true\|false Related settings: Dial plan - Internal extension length (profile.setting.dialingrule.internalnumberlength) Dial plan - International phone number length (profile.setting.dialingrule.internationalnumberlength) Dial plan - National outbound call prefix (profile.setting.dialingrule.outgoingprefix) Dial plan - International outbound call prefix (profile.setting.dialingrule.internationaloutgoingprefix) Dial plan - Activate dial rule (profile.setting.dialingrule.enabled) Dial plan - Active from dialpad (profile.setting.dialingrule.fromdialpad) Dial plan - International outbound use outboud call prefix (profile.setting.dialingrule.addoutgoingoninternational) Add prefix when creating shortcuts from history (profile.setting.calllogs.addprefixtoshortcuts) Allowed extensions for diverting/forwarding/dispatching (profile.setting.forward.whitelist)

ImportantNote_Icon

When 'Enable dial plan application on a forward rule's target'/'Activate legacy dial rule on forward' and 'Enable forward whitelist' are both enabled, turret checks if the target is matching an extension in the whitelist before and after applying the dial plan to it.

If at least one (with or without dial plan) is matching, the forward will be allowed.