Commit bc7fe8cf authored by Sebastien Duthil's avatar Sebastien Duthil Committed by Etienne Lessard

remove obsolete ccss doc

parent 8c5b1a78
......@@ -2,17 +2,15 @@
Call Completion
***************
.. XXX how should we name this feature ? CCSS ? Call Completion Supplementary Service ? Automatic recall ?
The call completion feature in XiVO allow for a caller to be automatically called back when a called party has
become available.
To illustrate, let's say Alice attemps to call Bob. Bob is currently on a phone call with Carol,
though, so Bob rejects the call from Alice, and Alice hears a message saying that Bob is busy. Alice
then dial \*40 to request call completion. Once Bob has finished his phone call, Alice will be
automatically called back. When she answers, Bob will be called on her behalf.
.. XXX ok, this is inspired from the CCSS doc on asterisk wiki... how should we underline this fact ?
The call completion feature (or CCSS, for Call Completion Supplementary Service) in XiVO allows for
a caller to be automatically called back when a called party has become available.
#. To illustrate, let's say Alice attemps to call Bob.
#. Bob is currently on a phone call with Carol, though, so Bob rejects the call from Alice, and
Alice hears a message saying that Bob is busy.
#. Alice then dials \*40 to request call completion.
#. Once Bob has finished his phone call, Alice will be automatically called back.
#. When she answers, Bob will be called on her behalf.
This feature has been introduced in XiVO in version 14.17.
......@@ -38,8 +36,6 @@ Let's now illustrate the no answer scenario:
#. When Bob's phone becomes busy and then is no longer busy, Alice is automatically called back.
#. When she answers, Bob will be called on her behalf.
.. XXX on utilise pas les meme temps de verbe dans cette illustration vs celle de l'intro
The important thing to note here is step #4. Bob's phone needs to become busy and then no longer
busy for Alice to be called back. This means that if Bob was away when Alice called him, but when he
came back he did not received nor placed any call, then Alice will not be called back.
......@@ -51,7 +47,7 @@ in the following scenario:
#. Alice attemps to call Bob.
#. Bob is currently on a phone call, so he doesn't answer the call from Alice.
#. Bob finish his call a few seconds later.
#. Alice then dial \*40 to request call completion (Bob is not busy anymore).
#. Alice then dials \*40 to request call completion (Bob is not busy anymore).
Then, for Alice to be called back, Bob needs to become busy and then not busy.
......@@ -62,25 +58,25 @@ When call completion is active, it can be cancelled by dialing the \*40 extensio
Some timers governs the use of call completion. These are:
* offer timer: the time the caller has to request call completion. Default to 30 seconds.
* offer timer: the time the caller has to request call completion. Defaults to 30 (seconds).
* busy available timer: when call completion on busy subscriber is requested, if this timer expires
before the called party becomes available, then the call completion attempt will be cancelled.
Default to 900 seconds.
Defaults to 900 (seconds).
* no response available timer: similar to the "busy available timer", but when call completion on no
response is requested. Default to 900 seconds.
response is requested. Defaults to 900 (seconds).
* recall timer: when the caller who requested call completion is called back, how long the original
caller's phone ring before giving up. Default to 30.
caller's phone rings before giving up. Defaults to 30 (seconds).
Special Scenarios
-----------------
When the caller is called back in the context of call completion, XiVO attempt to call the callee
When the caller is called back in the context of call completion, XiVO attempts to call the callee
in a way similar to directly calling the user.
This means that if, for example, the callee has enabled the do not disturb functionality, then the
call completion call back will ultimately fail to reach the callee. The behaviour is similar if the
user has an unconditonal forward, a schedule, a call right or a preprocess subroutine,
This means that if, for example, the callee has enabled the `Do Not Disturb` functionality, then the
call completion callback will ultimately fail to reach the callee. The behaviour is similar if the
user has an unconditional call forwarding, a schedule, a call permission or a preprocess subroutine,
etc.
In the following scenario:
......@@ -93,39 +89,24 @@ In the following scenario:
#. Alice then dial \*40 to request call completion.
The call completion request will monitor the first phone that was called, i.e. it will monitor Bob's
phone. When Bob becomes not busy, the call completion callback will try to call Bob's on behalf of Alice.
phone. When Bob becomes not busy, the call completion callback will try to call Bob's on behalf of
Alice.
Limitations
-----------
Call completion can only be used with SIP lines. It can't be used with SCCP lines.
It can't be used with outgoing calls and incoming calls, except if these calls are passing through a
customized trunk of type Local.
It can't be used with groups or queues.
* Call completion can only be used with SIP lines. It can't be used with SCCP lines.
* It can't be used with outgoing calls and incoming calls, except if these calls are passing through
a customized trunk of type Local.
* It can't be used with groups or queues.
* The call completion feature can't be enabled only for a few users; either all users have access to
it, or none.
Configuration
=============
The call completion feature is by default disabled.
To be able to use it, you must enable the call completion general setting and the call completion
extension. The call completation feature can't be enabled only for a few users; either all users
have access to it, or none.
Currently, enabling the call completion general setting is done via the following commands::
sudo -u postgres psql -c "UPDATE call_completion SET enabled = TRUE" asterisk
asterisk -rx "sip reload"
If you then want to disable it, use these commands::
sudo -u postgres psql -c "UPDATE call_completion SET enabled = FALSE" asterisk
asterisk -rx "sip reload"
The call completion extension is enabled via the :menuselection:`Services --> IPBX --> IPBX
services --> Extensions` page, in the :guilabel:`General` tab.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment