Zoiper 5
From VoIP.ms Wiki
| [draft revision] | [draft revision] |
(→Common Errors) |
(→Common Errors) |
||
| Line 113: | Line 113: | ||
=== No transport mode found === | === 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. | + | 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 | '''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'''. | + | those options as "Not found" in red. However, you can choose your desired selection and hit '''Skip''' and '''Create an account'''. |
[[File:Zoiper5 errormanual.PNG|thumb|none|450px|Click to enlarge]] | [[File:Zoiper5 errormanual.PNG|thumb|none|450px|Click to enlarge]] | ||
Revision as of 22:02, 26 June 2019
Contents |
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 Finish 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.
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.
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.
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.
- When prompted to manually configure an account choose yes and configure the account on the Zoiper account settings page.
- On this screen you can check the error response code and correct it. You can check the list of common SIP Response codes for this.
