54.5. Easy configuration guide

This Chapter will be shown how to easily configure the virtual office in most common cases.

[Warning]Warning

Only allowed users may access the web interface, check HTTP driver for details.

[Tip]Tip

Interesting chapter: Chapter 78, Abilisphone - End user manual.

54.5.1. Abilisphone

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:yes

COMMAND 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 EXECUTED

It's also possible to specify the Callback calling number:

[15:29:40] ABILIS_CPX:s user:test vo-cb-cgo:016546346

COMMAND EXECUTED

Now 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:1

COMMAND EXECUTED

[15:42:46] ABILIS_CPX:a ctivo numbers user-num:3477878787 user:test seq:2 ap:yes

COMMAND 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:seq

COMMAND 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?

Figure 54.3. Web interface to change CTIVO preferences

Web interface to change CTIVO preferences

[Important]Important

Remember to add the CTIR routings as explained in the previous section.

54.5.1.1. Abilisphone registry

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.

54.5.1.2. Configuring virtual office internal routings

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:cur

COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-cur-user-num:3221898989

COMMAND EXECUTED

The user may alternatively contacted via a sequence of numbers.

[09:08:14] ABILIS_CPX:s pref user:test vo-contact:seq
COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-contact-num1:3221898989

COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:3477878787 

COMMAND 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:fork
COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-contact-num1:3221898989

COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-contact-num2:3477878787

COMMAND EXECUTED

[09:08:14] ABILIS_CPX:s pref user:test vo-contact-num3:

COMMAND EXECUTED
[Note]Note

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.

54.5.1.3. Configuring conference

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 EXECUTED

The CTIMIX resource may already exist in the system, but may not yet be active.

[09:10:00] ABILIS_CPX:s act res:ctimix

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:save conf

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:warm start
[Caution]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]Important

The CTIMIX resource requires the SOFT-PBX licence.

54.5.1.4. Configuring recording

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 EXECUTED

The CTIVR resource may already exist in the system, but may not yet be active.

[09:10:00] ABILIS_CPX:s act res:ctivr

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:save conf

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:warm start
[Caution]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:yes

COMMAND EXECUTED

[09:10:00] ABILIS_CPX:s pref user:test on-demand-vr-rcpt:test@domain.it

COMMAND EXECUTED
[Note]Note

The CTIVR requires a separate licence in CPX and needs also SoftPBX and SMTP licence to activate SMTP (for sending emails).

54.5.1.5. Configuring call waiting

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 EXECUTED

Once 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.

54.5.1.6. Configuring the precedence call

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 EXECUTED

When 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

54.5.2. Remote phone operator

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-peer

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:pbx0 sip-host:10.0.0.88 sip-udp-locport:5062 sip-srcadd:10.0.0.62

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:pbx0 sip-rem-user:11111 sip-rem-pass:11111

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:pbx0 sip-maxses-bid:0 sip-maxses-in:8 sip-maxses-out:8

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:d user:pbx0

Parameter:          | 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-peer

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:station sip-host:10.0.0.50 sip-srcadd:10.0.0.62 sip-number:33333

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:station sip-maxses-bid:0 sip-maxses-in:0 sip-maxses-out:8

COMMAND EXECUTED

[18:48:36] ABILIS_CPX:s user:station vo-channels:8

COMMAND EXECUTED


[18:42:30] ABILIS_CPX:d user:station

Parameter:          | 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:yes

COMMAND EXECUTED

[18:48:42] ABILIS_CPX:a ctivo numbers user-num:33333 user:station cur:yes

COMMAND EXECUTED

[18:48:42] ABILIS_CPX:d ctivo numbers

Total: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                
--------------------------------------------------------------------------------