iOS App

Installing the App

The Vodia iOS app can be found in the Apple App Store under the name "Vodia Phone". A link is available on the login screen for the PBX. The app required iOS 13 or higher to work properly. Currently only English and German is supported.

In order to install the App, the user needs a 2D barcode that contains the username, domain, address of the PBX and a token which is linked to the users password for the account. The barcode can be obtained in several ways:

  • In the domain view in the administrator web interface. Under the provisioning tab, there is a button called QR-Code which creates a pop-up with the code. If the user is in front of the screen, the camera a of the iOS device can take a photo of the screen for pairing.
  • The same is possible from the user portal. The code is available from the user menu, which will show up after clicking on the user icon on the top right corner of the interface.
  • The administrator can generate a page that contains the codes for multiple domains. In order to do that, switch into the domain administrator view and select "Download QR codes" in the list of extensions. This pages is intended for print out, so that the paper can be given to the user. 
  • The PBX can also send an email with the code to the user. However this method must be enabled first in the system security settings (Settings → Security → General), the name of the setting is "Include 2D barcode in user welcome email". Then in the domain list of extensions select the item "send welcome email to selected accounts".

The link that the PBX uses depends on the address that that administrator uses in the browser.

  • If the PBX runs on a publicly routable address ("public IP"), it will work with devices from any location that generally can reach servers in the internet. 
  • If the PBX runs in a private network, the phones can access the PBX only if they are in the same network. This typically works when WLAN is used; however when the user leaves the office, the App cannot access the PBX any more. Because the Apple push service will wake up the app independently where the user is located, and incoming call will ring the user, but the user will not be able to connect the call.

In either case it is necessary that the PBX has a valid X-509 certificate for the domain. You can use the automatic certificate generation through the LetsEncrypt service or import your own certificate. If you use Safari on the phone, you must be able to get to the login page of the PBX without certificate warning.

Uninstalling the App

To uninstall the app on the device, just uninstall it like any other app.

In order to remove the app from the PBX (for example when an employee leaves the company), the administrator needs to reset the password for the extension and delete the permanent registration for the app. This can also be done through the end item "unassigned the cell from selected accounts".

Using the App

Using the app is straightforward. Users can receive calls just like calls from other sources. For making calls, the user can use the dialed inside the app or use the iOS address book to dial a number; in that case the user has to select the Vodia PBX service for outbound calls for that address book entry.

In order to turn DND on or off, the user can click on the green circle (which indicated availability for calls) on the top right corner of the display.

To change settings, the user can click on the icon on the top left corner of the screen. Currently this can be used to scan another barcode and to view the account information from the last scan.

Home Tab

In the home tab, you can see the status of the other extensions in the domain. When pictures are loaded, the app will show them on the left side for each extension. There is a small circle below the image that shows if the extension is available (green), on do-not-disturb (red) or unavailable (grey). If the extension is in a call, there will be a red rectangle on the right side.

If you click on an extension, it will start a call to that extension. You need to confirm the call before the app starts to dial.

Dial Tab

If you want to manually enter a number, you can use the dial tab. In order to start the call, the user needs to press the green button. In order to dial a + at the beginning of a number, hold the 0 down for 1.5 seconds.

History Tab

The history shows the calls for the extension, sorted by date. Inbound calls use an arrow from the top right to the bottom left (away from the number shown), and outbound calls show an arrow in the other direction. If a call was missed, the arrow is in red. The user can swipe the entry away, which will delete it from the personal call history, but not from the domain call history. Clicking on an entry will trigger the dialing of the number. This must be confirmed by the user. If not confirmed, missed calls will be marked as read and will show up in regular color. The history list can be refreshed by pulling the list down; this should automatically happen after a call disconnects.

Voicemail Tab

The voicemail tab shows the voicemail messages for the user. To play back an entry, the user needs to click on the playback button on the left side of the entry. Clicking again will stop the playback. By clicking on the entry the user can call the number back, which must be confirmed.

The user can still call the mailbox by dialing the own account number. This is useful for example to record greetings or to change the PIN code.

In Call

When in a call, the user can use the following buttons in the call screen:

  • The speaker button can be used to change the audio device. 
  • The mute button is used to suspend and resume audio (e.g. in conference calls).
  • The dialed button opens a display that can be used to enter digits (0-9, * and #), for example to use a mailbox or auto attendant.