| 56.5. Easy configuration guide | ||
|---|---|---|
 | Chapter 56. CTIVO - Virtual Office |  |
| 56.5. Easy configuration guide | ||
|---|---|---|
| | Chapter 56. CTIVO - Virtual Office | |
This Chapter will be shown how to easily configure the virtual office in most common cases.
![[Warning]](../images/warning.png) | Warning |
|---|---|
Only allowed users may access the web interface, check HTTP driver for details. |
![[Tip]](../images/tip.png) | Tip |
|---|---|
Interesting chapter: Chapter 80, Abilisphone - End user manual. |
To configure an Abilisphone the first step is to add the virtual office user:
[15:21:23] ABILIS_CPX:a user:test pwd:test act:yes vo:yes http:yesCOMMAND EXECUTED [15:29:36] ABILIS_CPX:d user:test- Not Saved (SAVE CONF) ------------------------------------------------------- Parameter: | Value: --------------------+---------------------------------------------------------- USER: test REAL-NAME: test ID: 12 <Read Only> PWD: ACT: YES GROUP: CTIP: # CLUS: # ADDRBOOK-SYNC: SYS ADDRBOOK-NUMBER: AUTO ADDRBOOK-OUTDIAL: NONE ADDRBOOK-PUB-ENABLED: SYS OPC-ROLE: USER OPC-VIEW: * OPC-HIDE-NUMBERS: NO OPC-MONITOR: NONE OPC-PRIVACY: NO CHAT: NO CHAT-USER: SYS CHAT-PWD: SYS HTTP: YES HTTP-HOME-URL: HTTP-PROT: PLAIN,SSL VO: YES VO-CHANNELS: 1 VO-PS-NUM: SYS VO-CB-NUM: SYS VO-CB-CGO: SYS -------------------------------------------------------------------------------
VO-CHANNELS parameter is set to one means that
just one user channel is allowed per time.
VO-PS-NUM and VO-CB-NUM have
to be set with postselection and callback numbers (or set it in the
port):
[15:29:40] ABILIS_CPX:s user:test vo-ps-num:i393454534534 vo-cb-num:i39423523523
COMMAND EXECUTEDIt's also possible to specify the Callback calling number:
[15:29:40] ABILIS_CPX:s user:test vo-cb-cgo:016546346
COMMAND EXECUTEDNow let's set the CTIVO numbers, let's image that such user is reachable via internal number 522:
[15:38:00] ABILIS_CPX:a ctivo numbers net-num:522 user:test
COMMAND EXECUTED
The CTIVO must then call in sequence the PSTN number and a mobile phone number associated to the Abilisphone.
[15:38:00] ABILIS_CPX:a ctivo numbers user-num:3221898989 user:test seq:1COMMAND EXECUTED [15:42:46] ABILIS_CPX:a ctivo numbers user-num:3477878787 user:test seq:2 ap:yesCOMMAND EXECUTED [15:50:48] ABILIS_CPX:d ctivo numbers- Not Saved (SAVE CONF) ------------------------------------------------------- Total:9/4000 Net-numbers:3 User-numbers:6 --------------------------+----------------------------+----------------------- NET-NUM: | USER-NUM: |USER: * = CUR |* = Current | | A = AbilisPhone | | n = Contact order | --------------------------+----------------------------+----------------------- . . . |* 1 3221898989 |test | A2 3477878787 |test * 522 | |test
The next step is to set the user preferences.
[15:52:54] ABILIS_CPX:s pref user:test vo-contact:seqCOMMAND EXECUTED [15:52:59] ABILIS_CPX:d pref user:test- Not Saved (SAVE CONF) ------------------------------------------------------- Parameter: | Value: --------------------+---------------------------------------------------------- USER: test ID: 15 <Read Only> LAST-CHANGE: 09/06/2015 15:52:59 CET <Read Only> PWD: *** -------------------- VO-CLIP: TRANSP VO-ACTION: ADVANCED (No rules) VO-CF-RULE: ALWAYS VO-CF-TOUT: 15 VO-CF-DLY: 10 VO-CF-FORK-TYPE: STD VO-CF-CDO: # VO-CF-CGO: * VO-VM: NO VO-VM-RULE: NOANS,OTHERS VO-VM-TOUT: 15 VO-PC-OFFER: 4 VO-PC-ACCEPT: 4 VO-CALL-WAITING: NO VO-CUR-NET-NUM: 522 VO-CUR-USER-NUM: 3221898989 VO-CONTACT: SEQ VO-CONTACT-NUM1: 3221898989 VO-CONTACT-NUM2: 3477878787 VO-CONTACT-NUM3: VO-CONTACT-SEQ-TOUT: 30 VO-CONTACT-FORK-TOUT: 6 VO-AP-VOIP: YES VO-AP-VOIP-CONTACT: NO VO-AP-VOIP-CODERS: SYS VO-AP-CELL: YES VO-AP-PS: YES VO-AP-PS-SHORT: YES VO-AP-PS-DATA: YES VO-AP-CB: NO VO-AP-CB-BLIND: YES VO-AP-DATA-MOBILE: YES VO-AP-WIFI: YES VO-AP-SOS-CALLS: NO VO-AP-CHAT: NO VO-AP-CHAT-TLS: SYS VO-AP-CHAT-ROSTER: ALL VO-AP-CHAT-CHECK: SYS VO-AP-BOOT: YES VO-AP-CALL-MODE: AUTO VO-AP-ADDRBOOK-SRC: CTISYS VO-AP-ENC: NO VO-MAIL-FAIL: NO VO-MAIL-FWD: NO VO-MAIL-SEIZED: NO -------------------- ...
If the phone associated to Abilisphone should be called in VoIP
mode before in GSM mode just set VO-AP-VOIP-CONTACT
to yes.
[15:52:54] ABILIS_CPX:s pref user:test vo-ap-voip-contact:yes
COMMAND EXECUTED
The configuration of the user preference about CTIVO may be done via web interface.
Connect to http://<Abilis
IP>/sys/user/cti_pref_display.htm?
![[Important]](../images/important.png) | Important |
|---|---|
Remember to add the CTIR routings as explained in the previous section. |
| Tip |
|---|---|
Interesting chapter: Chapter 80, Abilisphone - End user manual. |
To be sure an Abilisphone is logged in the Abilis use the CTIVO registry
[16:03:48] IMBOURNE:d ctivo registry
--------------------------------------------------------------------------------
User Host AGE EXPIRY
App Version
--------------------------------------------------------------------------------
test 005.090.078.044:1760 18 22
iOS 2.9.4 (59)
--------------------------------------------------------------------------------The table shows the user's name, the host, the time from latest registration and the remaining time before expiration of the registration.
Also the App Version is provided for further
debugging. The Abilisphone diagnostics are provided by the command:
debug res:Ctivo lsn:20.
The user may be contacted via the current user number if
VO-CONTACT is CUR
(current).
[09:08:14] ABILIS_CPX:s pref user:test vo-contact:curCOMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-cur-user-num:3221898989COMMAND EXECUTED
The user may alternatively contacted via a sequence of numbers.
[09:08:14] ABILIS_CPX:s pref user:test vo-contact:seqCOMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num1:3221898989COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:3477878787COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num3:COMMAND EXECUTED
Or via a Fork:
[09:08:14] ABILIS_CPX:s pref user:test vo-contact:forkCOMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num1:3221898989COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:3477878787COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num3:COMMAND EXECUTED
![[Note]](../images/note.png) | Note |
|---|---|
If the number is configured as an Abilisphone the virtual
office will provide diagnostics of the call to the Abilisphone and
if the |
With two calls active/parked the conference button
will be enabled, just click it. If action succeeds the conference will
start, otherwise the two calls will stay as they are. This action can
be repeated more times, i.e. once conference has been created the
AbilisPhone user may make another call and click conference button
again.
Add the resource CTIMIX to the Abilis system with the following command.
[09:08:14] ABILIS_CPX:a res:ctimix
COMMAND EXECUTEDThe CTIMIX resource may already exist in the system, but may not yet be active.
[09:10:00] ABILIS_CPX:COMMAND EXECUTED [15:20:51] ABILIS_CPX:s act res:ctimixsave confCOMMAND EXECUTED [15:20:51] ABILIS_CPX:warm start
![[Caution]](../images/caution.png) | Caution |
|---|---|
After adding the CTIMIX active Abilis to make the resource running. Use the command save conf and restart Abilis (i.e. With warm start command) |
| Important |
|---|---|
The CTIMIX resource requires the SOFT-PBX licence. |
| Tip |
|---|---|
Interesting chapters: Section 54.3, “CTIMIX - Conference”. |
The record button 
will be enabled if you
have an active call. Once the recording is captured, the voice mail is
sent via email.
Add the resource CTIVR to the Abilis system with the following command.
[09:08:14] ABILIS_CPX:a res:ctivr
COMMAND EXECUTEDThe CTIVR resource may already exist in the system, but may not yet be active.
[09:10:00] ABILIS_CPX:COMMAND EXECUTED [15:20:51] ABILIS_CPX:s act res:ctivrsave confCOMMAND EXECUTED [15:20:51] ABILIS_CPX:warm start
| Caution |
|---|---|
After adding the CTIVR active Abilis to make the resource running. Use the command save conf and restart Abilis (i.e. With warm start command) |
Once the CTIVR is running and active the user must be configured to receive the mail of the recorded call.
[09:10:00] ABILIS_CPX:s pref user:test on-demand-vr:yesCOMMAND EXECUTED [09:10:00] ABILIS_CPX:s pref user:test on-demand-vr-rcpt:test@domain.itCOMMAND EXECUTED
| Note |
|---|---|
The CTIVR requires a separate licence in CPX and needs also SoftPBX and SMTP licence to activate SMTP (for sending emails). |
| Tip |
|---|---|
Interesting chapters: |
In the common case when the virtual user is busy in a call a further incoming call is rejected.
If the user preference VO-CALL-WAITING is set
to yes, then the user receives a tone during the
current call to inform him that a new incoming call is in
progress.
[09:10:00] ABILIS_CPX:s pref user:test vo-call-waiting:yes
COMMAND EXECUTEDOnce the user receives such tone he may:
Switching the current call to the newer getting held the current one.
Accepting the newer and closing the current one.
Rejecting the newer call and keeping on the current one.
The virtual user may request a precedence call (in Abilisphone there is a proper button to do it).
A precedence call isn't rejected in case of busy destination. Simply a call waiting occurs and the destination listens to the proper tone.
The precedence call works only if the priority of the virtual user is higher than the destination.
Priority values are from 4 (lower one) to 0 (higher one).
To set virtual user priority when performing the call precedence
set the preference VO-PC-OFFER to a value from 0 to
4.
[09:10:00] ABILIS_CPX:s pref user:test vo-pc-offer:0
COMMAND EXECUTEDWhen the virtual user is the destination of the call the
comparison occurs against the preference
VO-PC-ACCEPT.
[09:10:34] ABILIS_CPX:s pref user:test vo-pc-accept:4
COMMAND EXECUTED | Tip |
|---|---|
Interesting chapter: Section 63.4.1.1, “Setting priorities for precedence call”. |
Requirements:
Incoming calls come from a SIP PBX in the customer with called number 11111.
The call is routed to a service station via SIP.
The call is controlled via DTMF and the services station may perform a second call and transfer.
The call to services station must be in G.729A.
The Abilis must manage up to 8 calls to services station.
After the transfer is completed Abilis must have a SIP call path optimization.
If the call to services station fails via SIP it must be attempted via the PBX that will relay the call to the PSTN number 00212345678.
First step is to configure the SIP PBX:
[18:48:36] ABILIS_CPX:a user:pbx0 pwd:pbx0 act:yes sip:yes sip-type:remote-peerCOMMAND EXECUTED [18:48:36] ABILIS_CPX:s user:pbx0 sip-host:10.0.0.88 sip-udp-locport:5062 sip-srcadd:10.0.0.62COMMAND EXECUTED [18:48:36] ABILIS_CPX:s user:pbx0 sip-rem-user:11111 sip-rem-pass:11111COMMAND EXECUTED [18:48:36] ABILIS_CPX:s user:pbx0 sip-maxses-bid:0 sip-maxses-in:8 sip-maxses-out:8COMMAND EXECUTED [18:48:36] ABILIS_CPX:d user:pbx0Parameter: | Value: --------------------+---------------------------------------------------------- USER: PBX0 REAL-NAME: PBX0 ID: 4 <Read Only> PWD: *** ACT: YES GROUP: CTIP: # CLUS: # ADDRBOOK-SYNC: SYS ADDRBOOK-NUMBER: AUTO ADDRBOOK-OUTDIAL: NONE ADDRBOOK-PUB-ENABLED: SYS OPC-ROLE: USER OPC-VIEW: * OPC-HIDE-NUMBERS: NO OPC-MONITOR: NONE OPC-PRIVACY: NO CHAT: NO CHAT-USER: SYS CHAT-PWD: SYS SIP: YES SIP-TYPE: REMOTE-PEER SIP-DOMAIN: SIP-HOST: 010.000.000.088 SIP-TCP-REMPORT: 5060 SIP-UDP-REMPORT: 5060 sip-udp-locport: 5062 SIP-SRCADD: 010.000.000.062 SIP-PROT: UDP SIP-IP-PERMIT: * SIP-MAXSES-BID: 0 SIP-MAXSES-IN: 8 SIP-MAXSES-OUT: 8 SIP-BUSY-INUSE: NO SIP-NUMBER: * SIP-ADDRBOOK-NUM: SIP-NUMBER SIP-CG-NUM: AUTO SIP-FWD-CG-NUM: CALLER SIP-DISPLAY-NAME: SYS SIP-CTIP-TYPE: SYS SIP-RG-IN: SYS SIP-ROUTE-BY-SD: YES SIP-PROVIDE-SG: NO SIP-CLIP-RULE: SYS SIP-BUSY-NOCHAN: NO SIP-LCS-GROUP: NONE SIP-CPO-RTP: SYS SIP-CPO-SIGNALLING: SYS SIP-RCC-DISABLE: SYS SIP-SS: NO SIP-SS-PICKUP: NO SIP-SS-PRES-CG: YES SIP-SS-CF-DND: YES SIP-SS-VM: YES SIP-AUTH: SYS SIP-CHAN-FREQ: SYS SIP-REMOTE-NAT: NO SIP-LOCAL-NAT: NO SIP-EXTERNAL-IP: SYS SIP-KEEPALIVE: ENABLED SIP-DTMF-MODE: SYS SIP-DISC-AUDIO: SYS SIP-BC-TRANSP: UDI SIP-T38: SYS SIP-T38-G711: SYS SIP-T38-PACKING: SYS SIP-T38-REDUND: SYS SIP-T38-REDUND-PCK: SYS SIP-UA: SYS SIP-UA-PERMIT: * SIP-REM-USER: 11111 SIP-REM-PASS: ******** SIP-REM-AUTH: SYS SIP-REM-AUTH-USER: AUTO (11111) SIP-REM-REG: YES -------------------------------------------------------------------------------
Next step is adding user for the service station:
[18:48:36] ABILIS_CPX:a user:station pwd:station act:yes sip:yes sip-type:local-peerCOMMAND EXECUTED [18:48:36] ABILIS_CPX:sCOMMAND EXECUTED [18:48:36] ABILIS_CPX:user:station sip-host:10.0.0.50 sip-srcadd:10.0.0.62 sip-number:33333COMMAND EXECUTED [18:48:36] ABILIS_CPX:s user:station sip-maxses-bid:0 sip-maxses-in:0 sip-maxses-out:8s user:station vo-channels:8COMMAND EXECUTED [18:42:30] ABILIS_CPX:d user:stationParameter: | Value: --------------------+---------------------------------------------------------- USER: station REAL-NAME: station ID: 5 <Read Only> PWD: *** ACT: YES GROUP: CTIP: # CLUS: # ADDRBOOK-SYNC: SYS ADDRBOOK-NUMBER: AUTO ADDRBOOK-OUTDIAL: NONE ADDRBOOK-PUB-ENABLED: SYS OPC-ROLE: USER OPC-VIEW: * OPC-HIDE-NUMBERS: NO OPC-MONITOR: NONE OPC-PRIVACY: NO CHAT: NO CHAT-USER: SYS CHAT-PWD: SYS SIP: YES SIP-TYPE: LOCAL-PEER SIP-DOMAIN: SYS SIP-HOST: 010.000.000.050 SIP-TCP-REMPORT: 5060 SIP-UDP-REMPORT: 5060 sip-udp-locport: SYS SIP-SRCADD: 010.000.000.062 SIP-PROT: UDP SIP-IP-PERMIT: * SIP-MAXSES-BID: 0 SIP-MAXSES-IN: 0 SIP-MAXSES-OUT: 8 SIP-BUSY-INUSE: NO SIP-NUMBER: 33333 SIP-ADDRBOOK-NUM: SIP-NUMBER SIP-CG-NUM: AUTO SIP-FWD-CG-NUM: CALLER SIP-DISPLAY-NAME: SYS SIP-CTIP-TYPE: SYS SIP-RG-IN: SYS SIP-ROUTE-BY-SD: NO SIP-PROVIDE-SG: NO SIP-CLIP-RULE: SYS SIP-BUSY-NOCHAN: NO SIP-LCS-GROUP: NONE SIP-CPO-RTP: SYS SIP-CPO-SIGNALLING: SYS SIP-RCC-DISABLE: SYS SIP-SS: NO SIP-SS-PICKUP: NO SIP-SS-PRES-CG: YES SIP-SS-CF-DND: YES SIP-SS-VM: YES SIP-AUTH: SYS SIP-CHAN-FREQ: SYS SIP-REMOTE-NAT: NO SIP-LOCAL-NAT: NO SIP-EXTERNAL-IP: SYS SIP-KEEPALIVE: ENABLED SIP-DTMF-MODE: SYS SIP-DISC-AUDIO: SYS SIP-BC-TRANSP: UDI SIP-T38: SYS SIP-T38-G711: SYS SIP-T38-PACKING: SYS SIP-T38-REDUND: SYS SIP-T38-REDUND-PCK: SYS SIP-UA: SYS SIP-UA-PERMIT: * SIP-REM-USER: SIP-REM-PASS: SIP-REM-AUTH: SYS SIP-REM-AUTH-USER: AUTO () SIP-REM-REG: NO VO: YES VO-CHANNELS: 8 VO-PS-NUM: SYS VO-CB-NUM: SYS VO-CB-CGO: SYS -------------------------------------------------------------------------------
Then the CTIVO numbers table has to include net and user numbers for the virtual user:
[18:48:42] ABILIS_CPX:a ctivo numbers net-num:11111 user:station cur:yesCOMMAND EXECUTED [18:48:42] ABILIS_CPX:a ctivo numbers user-num:33333 user:station cur:yesCOMMAND EXECUTED [18:48:42] ABILIS_CPX:d ctivo numbersTotal:2/4000 Net-numbers:1 User-numbers:1 --------------------------+----------------------------+----------------------- NET-NUM: | USER-NUM: |USER: * = CUR |* = Current | | A = AbilisPhone | | n = Contact order | --------------------------+----------------------------+----------------------- |* 33333 |station * 11111 | |station
Next step is to write the CTI routings:
[18:51:48] ABILIS_CPX:d ctir
Last change: 17/06/2015 10:01:34 CET
---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
|BCI |POI |SR |GI |OUT |CDI |CDO
ACT|NEXT |LAST |EEC |T301|CGI |CGO
EDT|SP |SC |DJ |MJ |FMDJ|FMMJ|SDI |SDO
|SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI |SGO
| |BCO |RGI |RGO
|FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG |OG |SG |DL |DH
|CODERS
|CODERSOUT
|TI1 .. TI5
--------------------------------------------------------------------------------
0 [routing_verso_ufficio_virtuale]
VOICE * # # Vo 11111 *
NO ANY NO Dft * *
64000 Sys Sys Sys Sys Sys * *
--------------------------------------------------------------------------------
1 [routing_verso_centrale_servizi]
VOICE ** # # Sip 33333 *
LIMITED ANY NO Dft * *
64000 Sys Sys Sys Sys Sys * *
8000 * * * NO Sys * *
* * *
Sys AUTO AUTO Sys SYS NO Sys Sys Sys Sys Sys
Sys
G.729A
--------------------------------------------------------------------------------
2 [routing_backup_verso_centrale_servizi_via_pbx0]
VOICE ** # # Sip 33333 00212345678
NO ANY NO Dft * *
64000 Sys Sys Sys Sys Sys * PBX0
8000 * * * NO Sys * *
* * *
Sys AUTO AUTO Sys SYS NO Sys Sys Sys Sys Sys
Sys
G.729A
--------------------------------------------------------------------------------
3 [routing_chiamate_da_centrale_servizi_verso_pbx0]
VOICE ** # # Sip * *
NO ANY NO Dft * *
64000 Sys Sys Sys Sys Sys * PBX0
--------------------------------------------------------------------------------
| Tip |
|---|---|
Interesting chapter: Section 49.5, “CTI Router Overview”. |
| |  | |
| 56.4. CTIVO diagnostics and statistics |  | Chapter 57. ACNT - Accounting resource |