Zoiper 5

From VoIP.ms Wiki

Revision as of 22:15, 26 June 2019

Configuration Detail

Setting up Zoiper with your SIP/IAX credentials

1. Start Zoiper 5 Softphone.

2. On the welcome screen fill the Username and Password then click on Login

• Username: 100000 (replace with your main VoIP.ms account number or sub-account name)
• Password: ********* (replace with your main SIP or sub-account password)
  

Click to enlarge

3. On the host screen, fill the Hostname or Provider with any of our servers. i.e. toronto.voip.ms then click on Next.

Note: Bear in mind to use the same VoIP server your VoIP number is using. 
You can check what VoIP server is your VoIP number using, from your VoIP.ms customer portal 
at DID Numbers>> Manage DIDs, under POP column. 
You can choose any server you want, as long as the one in your portal and the one in this field matches, 
otherwise, incoming calls won't ring.

Click to enlarge

4. The Authentication step is optional, you can skip it.

Click to enlarge

5. In this screen you can select the protocol that your SIP account will use:

• SIP TLS
• SIP TCP
• SIP UDP
• IAX UDP

Select the one you prefer according to your network's settings, i.e. SIP TCP then click on the Finish button.

Click to enlarge

Note: If you choose TLS please refer to section 2.2.1 for some extra adjustments, only if they are needed. When choosing TLS, Zoiper should adjust these parameters automatically.

Done, at this point your VoIP.ms SIP account should be marked with a green tick arrow next to its name. This means your softphone is ready to start placing calls. In case of error, refer to section 3.2 for more info.

Click to enlarge

Extra settings

Audio codecs

In order to use only the supported codecs by VoIP.ms please go to Settings (gear icon next to account's name)>> Accounts>> Your account>> Advanced and scroll down the page to Audio Codecs section. You can hover over any codec and move it to the other column or change the order. We suggest keeping audio codecs G729, G711 mu-law and GSM in Selected Codecs column and in this order.

Click to enlarge

Network settings

In order to have your softphone running all the time, proceed with the following steps:

1. Go to Settings>> Accounts>> Your account>> Advanced and scroll down the page to Network Related and apply the following changes:

• Registration expire mode: Custom
  
• Registration expiry: 300
  
• NAT keep alive time-out: Custom
  
• Keep alive custom interval: 30
  

Click to enlarge

Encryption TLS

In order to use TLS along with Zoiper 5 please follow these steps:

1. Make sure your Main account or sub-account has "Encrypted SIP Traffic" enabled. Bear in mind, if this setting is enabled and your device sends UDP/TCP or RTP you will be rejected with error code 488. Enable this setting for the Main Account at Main Menu>> Account settings>> Advanced tab.

Click to enlarge

For a sub-account enable it at Sub accounts>> Manage sub-accounts by clicking on the orange icon with a pen and finally click at "Advanced Options (Click here to display)"

Click to enlarge

2. Now that your account/sub-account has this setting enabled, your device only needs to send TLS and SRTP.

To enable TLS go to Settings>> Accounts>> Your Account>> Advanced and at SIP Credentials section type:

• Domain: atlanta1.voip.ms:5061 (Use the same server your phone number is at, you can check it out from your customer portal at Manage DIDs section, under POP column)
• Username: Your account's number or sub-account name
• Password: Your SIP/IAX password

Note: When using TLS is very important to specify the number of the server, in case the server you have chosen, doesn't use the number "1", you need to add it. Adding any of the SIP ports 5061/5081/42873 is also required.

Click to enlarge

Now scroll down the page to Network Related section and set Transport to TLS

Click to enlarge

To enable SRTP scroll down the page and at Encryption section set SRTP Key Negotiation to SDES

Click to enlarge

Your account should be shown as registered and when you place a call you will see a closed green padlock, which means the call is now secure.

Click to enlarge

You can also check if Zoiper is fully registered and using SIP-TLS protocol from your customer portal at Home page, Main menu>> Portal Home for each account/sub account registered or at Sub Accounts>> Manage Sub accounts tab to see all of your Sub Accounts registration status.

A green padlock will appears on the right of "Registered" in green. If you don’t see the padlock, you need to revalidate some configuration.

Common Errors

No transport mode found

If there was a typo in your password or if there's a network DNS issue, Zoiper might show the account type options in red. You can select the protocol and hit Skip button even though, they're all red and finally, at Create an account.

Note: Sometimes even when the username, password and server's name were typed fine, Zoiper will show all 
those options as "Not found" in red. However, you can choose your desired selection and hit Skip and Create an account.

Click to enlarge

SIP error codes

In case of any issue an error code number will be shown at Settings>> Accounts>> Your account section. You can check the error response code and correct it. You can check the list of common SIP Response codes for this.

Click to enlarge

403 error

This is the most common error you can get and it's related to wrong information in your username and/or password. Please make sure you have the right credentials and no blank spaces are in your username or password.