Difference between revisions of "Call Flow"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 1: Line 1:
= Definition =  
= Description =  


Call Flow is set of rules on how a call should behave when it is trying to reach a device.
Call Flow is set of rules on how a call should behave when it is trying to reach a device.
 
<br><br>
Call Flow can be reached by clicking [[Image:icon_call_flow.png]] '''Call Flow''' link in device details:
A call has several States as:
 
[[Image:call_flow1.png]]
 
A call has several states that can be seen from this image:


* '''Before Call'''  – call has not reached device.
* '''Before Call'''  – call has not reached device.
Line 15: Line 11:
* '''Busy''' – callee was busy.
* '''Busy''' – callee was busy.
* '''Failed''' – call to device failed.
* '''Failed''' – call to device failed.
 
<br><br>
 
= Actions =
 
We can take actions for several call states: Before Call, No Answer, Busy and Failed.
 
The possible actions are:
The possible actions are:


Line 27: Line 18:
* '''Voicemail'''
* '''Voicemail'''
* '''Fax detect''' (only for the Before Call state)
* '''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]]
<br><br>
== Actions ==


 
=== Empty ===
== Empty ==


Empty – means no action should be taken. It is the default in most cases.
Empty – means no action should be taken. It is the default in most cases.
<br><br>
=== Forward ===


 
'''Forward to'''
 
== Forward ==


Call can be forwarded to Local device or External number:
Call can be forwarded to Local device or External number:
 
<br><br>
[[Image:call_flow_forward.png]]
[[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).
'''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).


Line 52: Line 56:
* '''Unconditional forward''' – when forward is used in the Before Call state.
* '''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.
* '''Forward on no answer/busy/failed''' – when forward is used in No Answer, Busy or Failed states.
 
<br><br>
 
'''CallerID options'''
 
=== CallerID options ===




Line 64: Line 66:
* '''From DID''' - selects a CallerID from available DIDs.
* '''From DID''' - selects a CallerID from available DIDs.
* '''Custom''' - enters any CallerID.
* '''Custom''' - enters any CallerID.
 
<br><br>
 
=== Forwarding example ===
=== 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.  
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]]
[[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:
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]]
[[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:
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:


Line 87: Line 84:
''on'' - length of tone<br>
''on'' - length of tone<br>
''off'' - length of pause between two tones.
''off'' - length of pause between two tones.
 
<br><br>
== Voicemail ==
=== Voicemail ===
 
<br><br>
[[Image:call_flow_vm.png]]
[[Image:call_flow_vm.png]]
 
<br><br>
This action sends the call directly to voicemail. It's simple. Put in Before Call, and if a call never reaches a device, it will go directly to voicemail.
This action sends the call directly to voicemail. It's simple. Put in Before Call, and if a call never reaches a device, it will go directly to voicemail.


You can put it in the No Answer/Busy/Failed state to achieve a different functionality.
You can put it in the No Answer/Busy/Failed state to achieve a different functionality.
 
<br><br>
 
=== Fax detect ===
 
== Fax detect ==


This action can be set ONLY in the Before Call state and only if a Fax device is enabled in Settings:
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]]
[[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.  
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.  


Line 110: Line 104:


'''NOTE: [[Fax over VoIP]] is not reliable and this setting should be used only for testing.'''
'''NOTE: [[Fax over VoIP]] is not reliable and this setting should be used only for testing.'''
<br><br>
=See also=
* [[Devices]]

Revision as of 14:30, 28 July 2013

Description

Call Flow is set of rules on how a call should behave when it is trying to reach a device.

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 for the device that is forwarding the call.
  • Same as comes - unchanged - leaves the CallerID as it comes from the original caller.
  • 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

This action sends the call directly to voicemail. It's simple. Put in Before Call, and if a call never reaches a device, it will go directly to voicemail.

You can put it in the No Answer/Busy/Failed state to achieve a different functionality.

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.

See also