====== SwitchVox ======

===== Telephony Integration =====

A note for configuration parameters:

  * If you see a variable, for example on this document: ''<dv-ext-num>''. 
  * This variable is used in multiple places, so it's important to make note of them.
  * The variables on the SwtichVox configuration is up to the PBX technician to pick the best option to follow the rest of their PBX configuration.
  * Then the DuVoice technician will need to know the information so that they can add the same parameters to the DuVoice server for integration.

==== SwitchVox Configuration ====

Overview:

  - First, need to program an extension that DuVoice can register to.
  - Then DuVoice will need to be set up as a SIP provider.
  - That will allow for configuration voicemail to point to DuVoice as the SIP provider.
  - Finally we'll go over setting up an extension as a mailbox.

=== Configure SIP Extension for DuVoice ===

Creating and configuring a SIP extension for DuVoice to register to.

  - Click the 'Setup' drop down menu. 
  - Click the 'Manage' option. 
  - Click the 'Create Extension' button.
  - Select: Extension Type = **SIP phone or SIP adapter for Analog Phone (ATA)**
  - Select: Extension Template = **default** 
  - Create extension with the following information:
    - Extension = ''<dv-ext-num>'' 
    - First name = ''DuVoice''
    - Last name = ''Port'' 
    - Password = ''<dv-ext-pass>''
    - Numeric PIN = ''<dv-ext-pin>'' 
  - Click 'save SIP Extension' button.

Example screenshot:

{{:images:integration:switchvox:switchvox01.png?direct&600|}}

  - Click on the 'Phone settings' tab.
  - Then click on the 'Common Settings' sub-tab. 
  - Set the following information:
    - 'Phone password' = ''<dv-ext-pass>''

Example screenshot:

{{:images:integration:switchvox:switchvox02.png?direct&600|}}

=== Configure DuVoice as SIP provider ===

  - Click on the 'Setup' drop down menu. 
  - Click on the 'VOIP Provider' sub-menu option. 
  - Create SIP Provider, configure these settings: 
    - 'SIP Provider Name' = ''DuVoice''
    - 'Your Account ID' = ''<dv-ext-num>''
    - 'Your Password' = ''<dv-ext-pass>''
    - 'Hostname/IP Address' = ''<dv-server-ip>''
    - 'Callback Extension' = ''<dv-ext-num>''
  - Click 'Save SIP Provider'.

Example screenshot:

{{:images:integration:switchvox:switchvox03.png?direct&600|}}

=== Voicemail Configuration ===

  - Click on the 'Tools' dropdown. 
  - Then under the 'PBX features' sub-menu click 'Voicemail'. 
  - Then goto 'External Voicemail' and configure these settings: 
    - 'Use External Voicemail System' = **Enabled**
    - 'SIP Provider' = ''DuVoice'' 
  - Click on the 'Save External Voicemail Settings' button.

Example screenshot:

{{:images:integration:switchvox:switchvox04.png?direct&600|}}

=== Extension Setup ===

How to set up an extension as mailbox.

  - 'Setup' drop down
  - 'Manage' option
  - 'Create Extension' button 
  - Extension Type = **SIP phone or SIP adapter for Analog Phone (ATA)**
  - Extension Template = **default**
  - Create extension:
    - Extension = ''<mb-num>'' 
    - First name = ''<mb-fn>'' 
    - Last name = ''<mb-ln>''
    - Password = ''<mb-pass>''
    - Numeric PIN = ''<mb-pin>'' 
  - Click 'save SIP Extension' button

==== DuVoice Configuration ====

=== Installation Wizard ===

  - First, select 'asterisk based pbx'.
  - Then select the 'switchvox' option.

=== Telephony Settings ===

Launch DV2000 Manager application:

  - Click on the 'Telephony' drop down menu.
  - Click on the 'Settings' option.
  - Navigate to 'PBX Tab' and configure the following:
    - Address = ''<switchvox-ip>''
    - Realm = ''asterisk''
    - Register accounts using = **Local IP address**

Example screenshot:

{{:images:integration:switchvox:switchvox05.png?direct&600|}}

Then go to the 'Lines' tab and configure the following:

For first line only:

  * Register = **checked**
  * Extension = ''<dv-ext-num>''
  * Account = ''<dv-ext-num>''
  * Password = ''<dv-ext-pass>''

For rest of the lines:

  * Register = **unchecked**
  * Extension = ''<dv-ext-num>''

Example screenshot:

{{:images:integration:switchvox:switchvox06.png?direct&600|}}

Go to 'options' tab:
 
  - Under 'other' section.
    - 'accept calls from self' = **checked**
  - Hit 'ok' button.

Example screenshot:

{{:images:integration:switchvox:switchvox07.png?direct&600|}}