Login Requirements

Before logging in the first time, enter your Switchvox hostname or IP address, admin Username, and admin Password. Press Sign In to activate the App. Upon successful login, these credentials are stored so you can have direct login on subsequent runs.

If you cannot log in via the App, verify that the requirements above are met. Switchvox and your networking environment must support your use of the App.

You can restrict access to the App from your mobile device by setting up a pin code and, if your device allows, fingerprint access.

Login Screen

Open

Successful Login

If your login is successful, the App displays the SIP Extensions screen. It stores the hostname or IP address you used so you can login directly on subsequent logins.

(A sample screen is shown at the right.)

SIP Extensions Screen

Navigation Drawer

The navigation drawer is the primary means of moving around in the App. It is accessed from any page (after you log into a Switchvox) via a "hamburger menu" in the top left corner of the App. In the navigation drawer, you can see the URI of the Switchvox, view and change the App's Settings, Log Out of the App, or select a tool.

The Mobile App includes the following tool options:

• SIP Extensions (view-only, see status)

• Phone Assignments (view and make Assignments)  

• Current Calls (view and hangup)

• Blocked IPs (view and unblock)

• VOIP Providers (view-only, see status)

• ​Settings

• ​Logout

Navigation Drawer

SIP Extensions

Press SIP Extensions to display the list of extensions and their current statuses. Each cell contains: Extension, Caller ID, IP Address, User Agent, and registration State. The list can be sorted by any of those fields and organized in ascending or descending order. Press the search icon to search for a specific entry. The data can be refreshed using a pull-to-refresh action.

SIP Extensions Sort Screen

Phone Assignments

Press Phone Assignments to display a list of the current phone assignments on the Switchvox PBX. Both deskphone and softphone assignments are listed together. Phone assignments can be deleted, and softphone assignments can have their token refreshed or deleted. Each cell displays: Type, Extension, Caller ID, MAC address, and Model. The list can be sorted by any of these fields and organized in either ascending or descending order. The search feature allows you to search for a specific entry. The data can be refreshed using a pull-to-refresh action.
The QR Token at the bottom right on the screen can be used to allow phone-users to scan their configuration from the admin's phone.

Phone Assignments List Screen

Open

Adding a Phone Assignment

To assign a desktop Digium Phone or a Switchvox Softphone to a SIP Extension, press the “plus” button in the top right area of the screen. This displays all of the unassigned phones.  Each cell displays: Extension and Caller ID, along with a button to create a deskphone assignment and a button to create a softphone assignment. When you select a deskphone assignment, the App displays a new view in which you can either type or scan a barcode (with your device’s camera) for the MAC address, then save the assignment. When you select a softphone assignment, the App displays an optional field to enter the new assignment’s email address, then to save the assignment.

Add Phone Assignment Screen

Current Calls

Press Current Calls to display a list of all currently active calls on your Switchvox PBX. Each cell contains: Who the call is from, who the call is to, the current duration, state, Codec format, and which provider is being used. The list can be sorted by any of these fields and organized in ascending or descending order. You can hang up any active call. A search feature allows you to search for a specific entry. The data can be refreshed using a pull-to-refresh action.

Current Call Sort Screen

Blocked IPs

Press Blocked IPs to display a list of the currently blocked IPs on your Switchvox PBX. Each cell contains: the IP that is blocked, the services that are blocked, the reason the IP was blocked, and the date it was blocked. The list can be sorted by any of these fields and organized in ascending or descending order. You can unblock any blocked IP. A search capability allows you to search for a specific entry. The data can be refreshed using a pull-to-refresh action.

VOIP Providers

Press VoIP Providers to display the list of VoIP providers configured on the system and their current status. Each cell contains: Name, Type, Host (IP or Hostname), Account ID, Callback Extension, Latency, and State. The list can be sorted by any of these fields and organized in ascending or descending order. A search capability allows you to search for a specific entry. The data can be refreshed using a pull-to-refresh action.

VOIP Providers Sort Screen

Settings

Press Settings to display general information about the App’s configuration and some settings you can control. The account user currently logged in is listed under Account.

Restricting Access for the App on a Mobile Device

You can restrict access to the App from your mobile device by setting up a pin code and, if your device allows, fingerprint access. If fingerprint scanning is enabled, the pin code is required, as it allows a fallback for authentication. You can change your pin code, after verifying it.

Restricting Access Screen

Log out

Press Log Out to clear stored credentials (except for the previous hostname/IP address). This allows you to either login with a different user or change the server you are logged into.