Zoiper

Zoiper is a free third-party softphone for Windows, Mac, iOS and Android. You connect it to a SIP device on your PBX. Some Zoiper features, such as phonebook import, chat and push notifications, need a paid Zoiper licence, which isn’t part of your PBX service.

Tip

Your provider’s own Webphone is tightly linked to the PBX and has more features. Use Zoiper if you need a third-party app.

Before you start

1. Add a SIP device to the person’s User under Device configuration, and click Apply configuration.
2. Open Devices at the top of the PBX tab and select the device. Keep its SIP credentials open: Domain, Username and Password.

The Domain shows the server address, a colon and the port. Copy it exactly as shown, including the port.

If Transport protocol shows TLS, TLS encryption is on for your PBX. The port in the Domain is then different, and you must set the app to use TLS instead of TCP, with SRTP (shown as Media encryption).

For the Zoiper mobile app, the device’s settings also have a QR code under Zoiper settings. It works with the mobile app only; on a computer, enter the SIP credentials.

Caution

Use each SIP device in one app or phone only. Signing in to the same SIP device on two apps or phones causes registration and call problems.

Set up Zoiper on Windows or Mac

Note

Menus can change between versions. If a label is different, check the vendor’s own help.

1. Download Zoiper from zoiper.com for your operating system and install it with the standard settings.

2. Open Zoiper. Enter the Username in the first field and the Password in the second, and click Login.

   

3. In the hostname field, paste the Domain, including the colon and port. Click Next.

   

4. Skip the authentication and outbound proxy step.

5. When Zoiper tests the connection, choose SIP TCP.

If you use Zoiper 5.5.7 or later, check the codecs to avoid audio problems:

1. Open Accounts, select the account and click Advanced.
2. Under Audio codecs, remove any G.729 codecs from Selected codecs. The PBX supports Opus, G.722, G.711 a-law and G.711 mu-law.

Set up Zoiper on Android

1. Install Zoiper from Google Play and open it.
2. Under Account setup, enter the Username and Password and tap Login.
3. Paste the Domain into hostname or provider, including the port, and tap Next.
4. Tap Skip on the authentication and outbound proxy step.
5. Choose SIP TCP.

If you’ve used Zoiper before, open Settings, choose your account and enter the details under SIP Account instead.

For better reliability, open Settings › Network Settings and review the options there. Some need Zoiper Premium.

Set up Zoiper on iPhone

1. Install Zoiper from the App Store and open it.
2. Go to Settings › Accounts, tap + and accept the warning.
3. Enter the Username, Password and Domain (including the port) manually.
4. In your iPhone settings for Zoiper, allow notifications, background app refresh and mobile data.
5. In Zoiper, go to Settings › Incoming calls to turn on push notifications. This may need Zoiper Premium.

Note

iOS and Android stop apps running in the background, so Zoiper may miss incoming calls when it isn’t open. For reliable incoming calls, Zoiper needs its push service (Apple push notifications on iOS, Firebase Cloud Messaging on Android). See Zoiper’s own help on its push proxy.

Check it works

1. In PBX › Devices, the SIP device’s status changes from Offline to Online.
2. Make a test call and ask someone to call you, to check your headset and that calls ring.

If it stays offline, check the details and see Softphone errors. A device that tries to register with a wrong password is blocked, and the block lifts after 5 minutes. Fix the details, wait, then try again.

Load your PBX phonebook into Zoiper

This needs a Zoiper Premium licence and the latest version of Zoiper.

1. In the PBX, open Phonebooks and choose the phonebook. Click URLs, then XML Zoiper URL, and copy the link that opens. See Phonebooks.
2. In Zoiper, open Settings › Contacts.
3. Click Add, choose XML from the list, then click the smaller Add button.
4. Paste the link into the local/URL path field and leave the authentication type as Don’t use.
5. Click XML Contact Service 1 on the left to save.

The contacts appear in the Contacts tab on the Zoiper home screen.

Chat between Zoiper users

Zoiper’s chat needs Zoiper Premium, and only works between Zoiper users on your PBX.

1. In Settings, select the account, click Advanced and, under features, turn on subscribe and publish presence. Save.
2. Add each colleague as a Zoiper contact (calling their internal number is the quickest way), and choose your account for presence.
3. Open the contact to see their status and send a message. Each colleague must turn on presence too.

Related

• Devices
• Softphone errors