Zoiper 5

From VoIP.ms Wiki

[draft revision]

[draft revision]

Revision as of 21:33, 26 June 2019 (view source) Roy (Talk | contribs) (→Network settings) ← Older edit		Revision as of 21:36, 26 June 2019 (view source) Roy (Talk | contribs) (→Encryption TLS) Newer edit →
Line 78:		Line 78:
	'''2.''' Now that your account/sub-account has this setting enabled, your device only needs to send '''TLS''' and '''SRTP'''.		'''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 [http://wiki.voip.ms/article/Choosing_Server 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.
-		+
-		+
-		+
-		+
-		+
-		+
-		+
-	[[File:Zoiper5 regtime.PNG|thumb|none|450px|Click to enlarge]]	+
-		+
-		+
-	* On the advanced settings you can set the ''' Registry expiration setting'''. By default Zoiper has it on '''TCP 600s''', you can set it '''for UDP 60s''' or '''custom''' and set it for 180 or 300 seconds. The recommended value is 300 seconds (5 minutes).	+
-		+
-		+
-	[[File:Zoiper5 aucodec.PNG|thumb|none|450px|Click to enlarge]]	+
-		+
-		+
-	* Scroll down to '''Audio Codecs.''', the ones on the right are the codecs available, leave only as selected codecs, u-Law and GSM and G.729(if available with the version). Set the rest to the left side.	+
-		+
-		+
-	* Click on the '''X''' in the left corner to leave the settings, you'll be prompted to save them, accept the change.	+
-		+
-		+
-	* Your Zoiper should be ready to make calls	+
	==Common Errors==		==Common Errors==

---

Revision as of 21:36, 26 June 2019

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 3 Common Errors

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

Common Errors

• If there was a typo in your password or if there's a DNS issue Zoiper might show the account type options in red. In this case, you can click on the skip button

• 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.