| 53.5. Easy configuration guide | ||
|---|---|---|
 | Chapter 53. CTIVO - Virtual Office |  |
| 53.5. Easy configuration guide | ||
|---|---|---|
| | Chapter 53. CTIVO - Virtual Office | |
This Chapter will be show 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. |
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-PROT: PLAIN,SSL VO: YES VO-CHANNELS: 1 VO-PS-NUM: SYS VO-CB-NUM: SYS VO-CB-CGO: SYS -------------------------------------------------------------------------------
VO-CHANNELS 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:i39423523523it is also possible to specify the Callback calling number.
[15:29:40] ABILIS_CPX:s user:test vo-cb-cgo:016546346Now 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:021898989 user:test seq:1COMMAND EXECUTED [15:42:46] ABILIS_CPX:a ctivo numbers user-num:34778787878 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 021898989 |test | A2 34778787878 |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: 021898989 VO-CONTACT: SEQ VO-CONTACT-NUM1: 021898989 VO-CONTACT-NUM2: 34778787878 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-SMS: 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 --------------------
If the phone associated to Abilisphone should be called in VoIP mode before in GSM mode just set VO-CONTACT-AP-VOIP to yes.
[15:52:54] ABILIS_CPX:s pref user:test vo-contact-ap-voip: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?
Remember to add the CTIR routings as explained in previous section.
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
2.0.11
--------------------------------------------------------------------------------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. Abilisphone diags are provided by the command: "debug res:Ctivo lsn:20".
The user may be contacted via the current user number if vo-concact 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:021898989COMMAND 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:021898989COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:34778787878COMMAND 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:021898989COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:34778787878COMMAND EXECUTED [09:08:14] ABILIS_CPX:s pref user:test vo-contact-num3:COMMAND EXECUTED
also note that if the number is configured as an abilisphone the virtual office will provide diagnostics of the call to the abilisphone and if the vo-ap-voip-contact is on then the user will be contacted via VoIP and in case of failure via the CTIR routings.
To configure SMS callback, the Ctisms resource must be running and active. Add the resource ctisms to the Abilis system with the following command.
[09:08:14] ABILIS_CPX:a res:ctismsThe CTISMS 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:ctismssave confCOMMAND EXECUTED [15:20:51] ABILIS_CPX:warm start
![[Caution]](../images/caution.png) | Caution |
|---|---|
After adding the CTISMS active Abilis to make the resource running. Use the command save conf and restart Abilis (i.e. with warm start command) |
Then add the routing from ctisms to virtual office:
[15:23:19] IMBOURNE:d ctisms in----+-------+-----+------------------------+-------------------------+--------- PR: |ACT: |POI: |CG: |TEXT: |LIFETIME: |RULE: |DEST:|DFT-RCPT: |HEADER: ----+-------+-----+--------------------------------------------------+--------- 0 NO * * 21600 MAIL SMTP SYS REMOVE ------------------------------------------------------------------------------- [15:26:50] ABILIS_CPX:a ctisms in pr:1 act:yes dest:ctivo text:ctivoCOMMAND EXECUTED [15:26:56] ABILIS_CPX:d ctisms in- Not Saved (SAVE CONF), Not Refreshed (INIT) --------------------------------- ----+-------+-----+------------------------+-------------------------+--------- PR: |ACT: |POI: |CG: |TEXT: |LIFETIME: |RULE: |DEST:|DFT-RCPT: |HEADER: ----+-------+-----+--------------------------------------------------+--------- 0 YES * * 21600 MAIL SMTP SYS REMOVE ------------------------------------------------------------------------------- 1 YES * * CTIVO 70 PREFIX CTIVO REMOVE ------------------------------------------------------------------------------- [15:45:14] ABILIS_CPX:init res:ctismsCOMMAND EXECUTED
In CTIVO resource configure the destination number for the SMS. In example:
[15:27:19] ABILIS_CPX:s p ctivo ap-sms-num:3201234567COMMAND EXECUTED [15:27:48] ABILIS_CPX:init res:ctivoCOMMAND EXECUTED
Finally the callback must be active in the preference of the user.
[15:28:33] ABILIS_CPX:s pref user:test vo-ap-cb:yes vo-ap-cb-sms:yes
COMMAND EXECUTEDAdd 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 |
|---|---|
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) |
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
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 is to rejected in case of busy destination. Simply a call waiting occurs and the destination listen to the proper tone.
The precedence call works only if the priority of the virtual user is higher then 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 EXECUTEDRequirements:
Incoming calls comes 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 optimisation
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-NUMBER: * SIP-ADDRBOOK-NUM: SIP-NUMBER SIP-CG-NUM: AUTO SIP-FWD-CG-NUM: CALLER 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-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-NUMBER: 33333 SIP-ADDRBOOK-NUM: SIP-NUMBER SIP-CG-NUM: AUTO SIP-FWD-CG-NUM: CALLER 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-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 routings:
[18:51:48] ABILIS_CPX:d ctir
Last change: 09/05/2015 18:37:18 CET
---+-----+-----------------+---------+--------------------+--------------------
PR |[DESCR]
|TYPE |POI/SR [SR] |POO/DS |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]
*toA NONE # CtiVo 11111 *
NO ANY NO Dft * *
64000 Sys * * Sys Sys * *
-------------------------------------------------------------------------------
1 [routing_verso_centrale_servizi]
*toS NONE # CtiSip 33333 *
LIMITED ANY NO Dft * *
64000 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]
*toS NONE # CtiSip 33333 00212345678
NO ANY NO Dft * *
64000 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]
*toS NONE # CtiSip * *
NO ANY NO Dft * *
64000 Sys * * Sys Sys * PBX0
-------------------------------------------------------------------------------
[18:51:53] ABILIS_CPX:| |  | |
| 53.4. CTIVO logs |  | Chapter 54. ACNT - Accounting resource |