Zoiper 5

From VoIP.ms Wiki

Contents 1 Configuration Detail 1.1 Setting up Zoiper with your SIP/IAX credentials 2 Extra settings 2.1 Audio codecs 2.2 Network settings 2.2.1 Encryption TLS 2.3 SMS SIP Account 2.3.1 Receiving SMS 2.3.2 Sending SMS 3 Common Errors 3.1 No transport mode found 3.2 SIP error codes 3.2.1 403 error

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)
  

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.

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

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 Next button.

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.

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 by using the gray arrow buttons. We suggest keeping audio codecs G729, G711 mu-law and GSM in Selected Codecs column and in this order.

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
  

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.

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)"

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.

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

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

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.

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.

SMS SIP Account

Zoiper is able to send and receive SMS using the SIP MESSAGE header. In order to use this feature along with Zoiper, there are some settings you need to adjust from your customer portal and your VoIP.ms number must support SMS service.

Bear in mind this feature is in BETA phase and we can't guarantee will work all the time.

Note: If your SIP device is offline, undelivered SMS will be trying to reach it during the next 24 hours after 
they were received. After this time, they won't be delivered in your SIP device BUT they won't be lost. 
You can check all your SMS from your customer portal at DID Numbers>> SMS Message Center at anytime. 

Receiving SMS

You can use your Main Account or a Sub-account, from your customer portal enable the following:

1. Go to DID Numbers>> Manage DIDs section and click at Edit DID (orange icon with a pen), at the bottom of this section you will find Short Message Service (SMS) section. Make sure the following are enabled and ticked:

• Short Message Service (SMS): Enabled
  
• SMS SIP Account BETA: Choose the Main Account or Sub-account you are currently using and are already set up in Zoiper.
  

At this point, you should be able to receive incoming SMS in Zoiper, they will show up under the Message icon in Zoiper.

Sending SMS

You can use your Main Account or a Sub-account, from your customer portal enable the following:

1. Your Main Account or Sub-account is using the phone number with SMS service enabled as its own caller ID number. You can check this for your Main Account at Main Menu>> Account settings>> General tab and for a Sub-account at Sub accounts>> Manage Sub accounts by clicking at Edit Sub-Account (orange icon with a pen).

2. If the phone number is properly set in your customer portal, you will be able to send SMS using Zoiper from the Message tab and by typing the destination number using 10 digits. You can also type in the TO field the name of any of your contacts to send the SMS directly.

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. Finally click 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.

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.

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.