Difference between revisions of "Call Flow"

From Kolmisoft Wiki
Jump to navigationJump to search
(New page: Call Flow is set of rules how call should behave when it is trying to reach some device. It can be reached by pressing on Image:icon_call_flow.png '''Call Flow''' link in device detai...)
 
 
(36 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Call Flow is set of rules how call should behave when it is trying to reach some device.
<div align="center"><BIG><BIG><BIG><BIG>[[Image:warning.png|30px]]'''IMPORTANT - this feature is a part of the [[PBX_Functions_Addon | PBX Functions Addon]]'''</BIG></BIG></BIG></BIG></div>
<br><br>


It can be reached by pressing on [[Image:icon_call_flow.png]] '''Call Flow''' link in device details:
= Description =


Call Flow is set of rules on how a call should behave when it is trying to reach a device. From MOR X4 PBX addon is required for Call Flow functionality.
<br><br>
A call has several States as:
* '''Before Call'''  – call has not reached device.
* '''Call''' – call to device is in progress.
* '''Answered''' – call was answered.
* '''No Answer''' – call was not answered and ended after timeout.
* '''Busy''' – callee was busy.
* '''Failed''' – call to device failed.
<br><br>
The possible actions are:
* '''Empty'''
* '''Forward'''
* '''Voicemail'''
* '''Fax detect''' (only for the Before Call state)
<br><br>
=Usage=
Go to '''SETTINGS –> Users –> Devices'''
<br><br>
[[Image:devices_path.png]]
<br><br>
Call Flow can be reached by clicking [[Image:icon_call_flow.png]] '''Call Flow''' link in Devices list or Details:
<br><br>
[[Image:devices_list.png]]
<br><br>
When you reach Call Flow window, you are able to manage actions for states: Before Call, No Answer, Busy and Failed.
<br><br>
[[Image:call_flow1.png]]
[[Image:call_flow1.png]]
<br><br>
== Actions ==
=== Empty ===
Empty – means no action should be taken. It is the default in most cases.
<br><br>
=== Forward ===
'''Forward to'''
Call can be forwarded to Local device or External number:
<br><br>
[[Image:call_flow_forward.png]]
<br><br>
'''Device Timeout''' is only available in the '''No Answer''' state. It decides for how long a device should ring before the system decides that it is unreachable (when to activate the No Answer state).
The system owner (admin) can select any device he likes. If a user edits his devices' Call Flow, he can only select his own devices.
Using the "forward" action it is easy to implement:
* '''Unconditional forward''' – when forward is used in the Before Call state.
* '''Forward on no answer/busy/failed''' – when forward is used in No Answer, Busy or Failed states.
<br><br>
'''CallerID options'''
The following options are available to manage CallerID for a forwarded call:
* '''From device''' - puts CallerID from the Device that is forwarding the call.
* '''Same as comes - unchanged''' - leaves the CallerID as it comes from the original caller.
* '''Same as comes - with Diversion''' - leaves the CallerID as it comes from the original caller and additionally adds SIP header Diversion from the initial URI (SIP To).
* '''From DID''' - selects a CallerID from available DIDs.
* '''Custom''' - enters any CallerID.
<br><br>
=== Forwarding example ===
Let's make a chain of forwards: when someone calls to a device (extension) and until the device timeout there is no answer the call is forwarded to another device, if there is still no answer then forwared to the next extension.
<br><br>
[[file:callflow1.png]]
<br><br>
In ''Forward to'' select the second extension. Then go to Devices main page and make the same call flow to that second extension just in ''Forward to'' select the third extension:
<br><br>
[[File:Callflow2.png]]
<br><br>
the parameters of ringing before forwarding can be changed in <code>/etc/asterisk/indications.conf</code> in this line of an appropriate nation's block:
<code>ringing tone 440+480Hz 1 sec. on ,2 sec. off</code>
''on'' - length of tone<br>
''off'' - length of pause between two tones.
<br><br>
=== Voicemail ===
<br>
[[Image:call_flow_vm.png]]
<br><br>
The ''Voicemail Action'' sends the Call directly to the [[Voicemail]]. The Action can be set on ''Before Call'', ''No Answer'', ''Busy'' and/or ''Failed'' states of Callflow.
<br><br>
'''Voicemail Action options:'''
<br>
* '''Skip intro message''' - when checked, skips the intro message ''"Please leave your message after the tone"''. This is useful when Users have their own custom Voicemail intro messages set up (unavailable in a ''Before Call'' state).
* '''Use Time Periods''' - when checked several [[IVR_system#Time_Periods|Time Periods]] can be applied to the Voicemail action. For example, if there is a Time Period ''Workdays'' (Monday to Friday from 08:00 till 17:00) the Call will be sent to Voicemail only when current time is within this time interval.
<br>
'''Notes:'''
* Time Period's time zone depends on the Device Owner.
* The first suitable Time Period is chosen in the order the Time Periods are selected.
* When none of the selected Time Periods is suitable, the Call is not sent to Voicemail.
<br><br>
=== Fax detect ===
This action can be set ONLY in the Before Call state and only if a Fax device is enabled in Settings:
<br><br>
[[Image:call_flow_fax.png]]
<br><br>
You can select only a FAX device to route the call if a Fax is detected. MOR will use fax detection when this action is set.
If a fax is detected, it routes calls to the set fax device. Otherwise, they go to the basic device.
'''NOTE: [[Fax over VoIP]] is not reliable and this setting should be used only for testing.'''<br>
'''NOTE: Do not add Devices with Fax Detect to Ring group. Ring group will not work correctly in this case.'''
<br><br>
=Change Forward action by Call (Feature Codes)=
Starting from MOR X6 it is possible to change Forward action by calling to special extensions. You just have to dial extension as it is listed (ie.: *72) and then if additional number is needed to complete the action, it will be asked by IVR:
*<nowiki>*72</nowiki> '''Call Forward All Activate''' - User will be prompted to enter a number where Calls should be forwarded unconditionally. Call state '''Before''' will be set with External number.
*<nowiki>*73</nowiki> '''Call Forward All Deactivate''' - Disables unconditional forward.
*<nowiki>*</nowiki>52 '''Call Forward No Answer/Unavailable Activate''' - User will be prompted to enter a number where Calls should be forwarded when Device or Callee is unreachable. Call state '''No Answer''' will be set with External number.
*<nowiki>*53</nowiki> '''Call Forward No Answer/Unavailable Deactivate''' - Disables No Answer forward.
*<nowiki>*90</nowiki> '''Call Forward Busy Activate''' - User will be prompted to enter a number where Calls should be forwarded when Device is busy. Call state '''Busy''' will be set with External number.
*<nowiki>*91</nowiki> '''Call Forward Busy Deactivate''' - Disables Busy forward.
CallerID can be managed by [http://wiki.kolmisoft.com/index.php/Configuration_from_GUI#Various Call Forwarding CallerID setting]
Note that in all cases External number is set. If you want to forward to Device then enter DID when you are prompted to enter forwarding number and assigned that DID to Device. All changes made by calling to these extensions are visible in Device Call Flow page and can be changed manually when needed.
<br>
==Add custom extensions==
It is possible to access forwarding functions by custom extensions. To do so, modify '''/etc/asterisk/[[extensions_mor_custom.conf]]''' file in each Asterisk server and add such lines for extensions which you want to change:
[mor_local]
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},52) ; Call Forward No Answer/Unavailable Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},53) ; Call Forward No Answer/Unavailable Deactivate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},72) ; Call Forward All Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},73) ; Call Forward All Dectivate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},90) ; Call Forward Busy Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},91) ; Call Forward Busy Deactivate
Here '''XX''' needs to be replaced by own extensions, for example if you want to assign 'Call Forward All Activate' to extension *11, then it should look like this:
exten => *11,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},72) ; Call Forward All Activate
Asterisk dialplan reload each time file is modified:
asterisk -rx 'dialplan reload'


Call has several states which are visible from this image:
=See also=


* '''Before Call''' - call has not reached device
* [[Devices]]
* '''Call''' – call to device is in progress
* '''Answered''' – call was answered
* '''No Answer''' – call was not answered and ended after timeout
* '''Busy''' – callee was busy
* '''Failed''' – call to device failed

Latest revision as of 09:49, 19 August 2024

Warning.pngIMPORTANT - this feature is a part of the PBX Functions Addon



Description

Call Flow is set of rules on how a call should behave when it is trying to reach a device. From MOR X4 PBX addon is required for Call Flow functionality.

A call has several States as:

  • Before Call – call has not reached device.
  • Call – call to device is in progress.
  • Answered – call was answered.
  • No Answer – call was not answered and ended after timeout.
  • Busy – callee was busy.
  • Failed – call to device failed.



The possible actions are:

  • Empty
  • Forward
  • Voicemail
  • Fax detect (only for the Before Call state)



Usage

Go to SETTINGS –> Users –> Devices

Devices path.png

Call Flow can be reached by clicking Icon call flow.png Call Flow link in Devices list or Details:

Devices list.png

When you reach Call Flow window, you are able to manage actions for states: Before Call, No Answer, Busy and Failed.

Call flow1.png

Actions

Empty

Empty – means no action should be taken. It is the default in most cases.

Forward

Forward to

Call can be forwarded to Local device or External number:

Call flow forward.png

Device Timeout is only available in the No Answer state. It decides for how long a device should ring before the system decides that it is unreachable (when to activate the No Answer state).

The system owner (admin) can select any device he likes. If a user edits his devices' Call Flow, he can only select his own devices.


Using the "forward" action it is easy to implement:

  • Unconditional forward – when forward is used in the Before Call state.
  • Forward on no answer/busy/failed – when forward is used in No Answer, Busy or Failed states.



CallerID options


The following options are available to manage CallerID for a forwarded call:

  • From device - puts CallerID from the Device that is forwarding the call.
  • Same as comes - unchanged - leaves the CallerID as it comes from the original caller.
  • Same as comes - with Diversion - leaves the CallerID as it comes from the original caller and additionally adds SIP header Diversion from the initial URI (SIP To).
  • From DID - selects a CallerID from available DIDs.
  • Custom - enters any CallerID.



Forwarding example

Let's make a chain of forwards: when someone calls to a device (extension) and until the device timeout there is no answer the call is forwarded to another device, if there is still no answer then forwared to the next extension.

Callflow1.png

In Forward to select the second extension. Then go to Devices main page and make the same call flow to that second extension just in Forward to select the third extension:

Callflow2.png

the parameters of ringing before forwarding can be changed in /etc/asterisk/indications.conf in this line of an appropriate nation's block:

ringing tone 440+480Hz 1 sec. on ,2 sec. off

on - length of tone
off - length of pause between two tones.

Voicemail


Call flow vm.png

The Voicemail Action sends the Call directly to the Voicemail. The Action can be set on Before Call, No Answer, Busy and/or Failed states of Callflow.

Voicemail Action options:

  • Skip intro message - when checked, skips the intro message "Please leave your message after the tone". This is useful when Users have their own custom Voicemail intro messages set up (unavailable in a Before Call state).
  • Use Time Periods - when checked several Time Periods can be applied to the Voicemail action. For example, if there is a Time Period Workdays (Monday to Friday from 08:00 till 17:00) the Call will be sent to Voicemail only when current time is within this time interval.


Notes:

  • Time Period's time zone depends on the Device Owner.
  • The first suitable Time Period is chosen in the order the Time Periods are selected.
  • When none of the selected Time Periods is suitable, the Call is not sent to Voicemail.




Fax detect

This action can be set ONLY in the Before Call state and only if a Fax device is enabled in Settings:

Call flow fax.png

You can select only a FAX device to route the call if a Fax is detected. MOR will use fax detection when this action is set.

If a fax is detected, it routes calls to the set fax device. Otherwise, they go to the basic device.

NOTE: Fax over VoIP is not reliable and this setting should be used only for testing.
NOTE: Do not add Devices with Fax Detect to Ring group. Ring group will not work correctly in this case.

Change Forward action by Call (Feature Codes)

Starting from MOR X6 it is possible to change Forward action by calling to special extensions. You just have to dial extension as it is listed (ie.: *72) and then if additional number is needed to complete the action, it will be asked by IVR:

  • *72 Call Forward All Activate - User will be prompted to enter a number where Calls should be forwarded unconditionally. Call state Before will be set with External number.
  • *73 Call Forward All Deactivate - Disables unconditional forward.
  • *52 Call Forward No Answer/Unavailable Activate - User will be prompted to enter a number where Calls should be forwarded when Device or Callee is unreachable. Call state No Answer will be set with External number.
  • *53 Call Forward No Answer/Unavailable Deactivate - Disables No Answer forward.
  • *90 Call Forward Busy Activate - User will be prompted to enter a number where Calls should be forwarded when Device is busy. Call state Busy will be set with External number.
  • *91 Call Forward Busy Deactivate - Disables Busy forward.

CallerID can be managed by Call Forwarding CallerID setting

Note that in all cases External number is set. If you want to forward to Device then enter DID when you are prompted to enter forwarding number and assigned that DID to Device. All changes made by calling to these extensions are visible in Device Call Flow page and can be changed manually when needed.


Add custom extensions

It is possible to access forwarding functions by custom extensions. To do so, modify /etc/asterisk/extensions_mor_custom.conf file in each Asterisk server and add such lines for extensions which you want to change:

[mor_local]
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},52) ; Call Forward No Answer/Unavailable Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},53) ; Call Forward No Answer/Unavailable Deactivate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},72) ; Call Forward All Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},73) ; Call Forward All Dectivate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},90) ; Call Forward Busy Activate
exten => XX,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},91) ; Call Forward Busy Deactivate

Here XX needs to be replaced by own extensions, for example if you want to assign 'Call Forward All Activate' to extension *11, then it should look like this:

exten => *11,1,AGI(mor_feature_codes,${CDR(ACCOUNTCODE)},72) ; Call Forward All Activate

Asterisk dialplan reload each time file is modified:

asterisk -rx 'dialplan reload'

See also