ZoIPer for Android
From VoIP.ms Wiki
| [quality revision] | [quality revision] |
(→Audio codecs) |
(→408 error) |
||
| (31 intermediate revisions not shown) | |||
| Line 2: | Line 2: | ||
==Configuration Detail== | ==Configuration Detail== | ||
| + | |||
| + | ===Setting up Zoiper with your SIP/IAX credentials=== | ||
'''1.''' Start '''Zoiper IAX SIP VOIP Softphone''' App and click at '''Create an account.''' | '''1.''' Start '''Zoiper IAX SIP VOIP Softphone''' App and click at '''Create an account.''' | ||
| Line 11: | Line 13: | ||
'''2.''' On the welcome screen fill the '''Username''' and '''Password''' then click on '''Create an account''' | '''2.''' On the welcome screen fill the '''Username''' and '''Password''' then click on '''Create an account''' | ||
| - | * '''Username:''' 100000 (your VoIP.ms | + | * '''Username:''' 100000 (replace with your main VoIP.ms account number or sub-account name) |
| - | * '''Password:''' ********* ( | + | * '''Password:''' ********* (replace with your main SIP or sub-account password)<br/> |
| Line 18: | Line 20: | ||
| - | '''3.''' On the host screen, fill the '''Hostname or Provider''' with any of our [http://wiki.voip.ms/article/Choosing_Server servers]. | + | '''3.''' On the host screen, fill the '''Hostname or Provider''' with any of our [http://wiki.voip.ms/article/Choosing_Server 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. | '''Note:''' Bear in mind to use the same VoIP server your VoIP number is using. | ||
| - | You can check what VoIP server your VoIP number | + | You can check what VoIP server is your VoIP number using, from your VoIP.ms customer portal |
| - | at '''DID Numbers>> Manage DIDs''' | + | at '''DID Numbers>> Manage DIDs''', under '''POP''' column. |
| - | You can choose any server as long as the one in your portal and the one in this field matches, | + | 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. | + | otherwise, incoming calls won't ring. |
| Line 42: | Line 44: | ||
* IAX UDP | * IAX UDP | ||
| - | Select the one you prefer according to your network's settings, | + | 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 [https://wiki.voip.ms/w/index.php?title=ZoIPer_for_Android&stable=0&shownotice=1&fromsection=Configuration_Detail#TLS | + | '''Note:''' If you choose '''TLS''' please refer to section [https://wiki.voip.ms/w/index.php?title=ZoIPer_for_Android&stable=0&shownotice=1&fromsection=Configuration_Detail#TLS 2.2.1] for some extra adjustments, only if they are needed. When choosing TLS, Zoiper should adjust these parameters automatically. |
[[File:ZoiperApp_acctype.png|thumb|none|300px|Click to enlarge]] | [[File:ZoiperApp_acctype.png|thumb|none|300px|Click to enlarge]] | ||
| - | '''Done,''' at this point your VoIP.ms SIP account should be shown under Accounts section and marked on Green with a tick arrow next to it. This means your softphone is ready to start placing calls. In case of failure, you can check what error code you're getting from section [https://wiki.voip.ms/w/index.php?title=ZoIPer_for_Android&stable=0&shownotice=1&fromsection=Configuration_Detail#SIP_error_codes | + | '''Done,''' at this point your VoIP.ms SIP account should be shown under Accounts section and marked on Green with a tick arrow next to it. This means your softphone is ready to start placing calls. In case of failure, you can check what error code you're getting from section [https://wiki.voip.ms/w/index.php?title=ZoIPer_for_Android&stable=0&shownotice=1&fromsection=Configuration_Detail#SIP_error_codes 3.2] |
[[File:Zoiper acc ready.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper acc ready.png|thumb|none|300px|Click to enlarge]] | ||
| + | |||
| + | ==Extra settings== | ||
=== Audio codecs === | === Audio codecs === | ||
| - | In order to use only the supported codecs by VoIP.ms please go to Settings>> Accounts>> Your account | + | In order to use only the supported codecs by VoIP.ms please go to '''Settings>> Accounts>> Your account''' |
[[File:ZoiperApp_accsettings.png|thumb|none|300px|Click to enlarge]] | [[File:ZoiperApp_accsettings.png|thumb|none|300px|Click to enlarge]] | ||
| Line 67: | Line 71: | ||
In order to have your softphone running all the time, proceed with the following steps: | In order to have your softphone running all the time, proceed with the following steps: | ||
| - | 1. Go to Settings>> Connectivity and enable "Keep Alive WIFI" and "Run in Background" | + | '''1.''' Go to '''Settings>> Connectivity''' and enable '''"Keep Alive WIFI"''' and '''"Run in Background"''' |
[[File:Zoiper conectivity.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper conectivity.png|thumb|none|300px|Click to enlarge]] | ||
| - | 2. Go to Settings>> Accounts>> Your Account>> Network Settings and change "Registration Expiry Time" to 180 | + | '''2.''' Go to '''Settings>> Accounts>> Your Account>> Network Settings''' and change '''"Registration Expiry Time"''' to 180 |
[[File:Zoiper exp time.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper exp time.png|thumb|none|300px|Click to enlarge]] | ||
| Line 78: | Line 82: | ||
In order to use TLS along with Zoiper please follow these steps: | 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 you use UDP/TCP you will be rejected with error code 488. Enable this for the Main Account at '''Main Menu>> Account settings>> Advanced tab''' and for a sub-account at '''Sub accounts>> Manage sub-accounts''' and by clicking on the orange icon with a pen and click at "Advanced Options | + | '''1.''' Make sure your Main account or sub-account has '''"Encrypted SIP Traffic"''' enabled. Bear in mind, if this setting is enabled and you use UDP/TCP you will be rejected with error code 488. Enable this for the Main Account at '''Main Menu>> Account settings>> Advanced tab''' and for a sub-account at '''Sub accounts>> Manage sub-accounts''' and by clicking on the orange icon with a pen and finally click at '''"Advanced Options (Click here to display)"''' |
[[File:Mainacc encryp.png|thumb|none|300px|Click to enlarge]] | [[File:Mainacc encryp.png|thumb|none|300px|Click to enlarge]] | ||
| Line 84: | Line 88: | ||
[[File:Subacc encryp.png|thumb|none|300px|Click to enlarge]] | [[File:Subacc encryp.png|thumb|none|300px|Click to enlarge]] | ||
| - | 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'''. |
| - | Go to Settings>> Accounts>> Your account and type: | + | Go to '''Settings>> Accounts>> Your account''' and type: |
| - | *'''Host''': 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) | + | *'''Host''': 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 | *'''Username''': Your account's number or sub-account name | ||
*'''Password''': Your SIP/IAX password | *'''Password''': Your SIP/IAX password | ||
| - | '''Note:''' When using TLS is very important to specify the number of the server, in case the | + | '''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:Tls zoiper.png|thumb|none|300px|Click to enlarge]] | [[File:Tls zoiper.png|thumb|none|300px|Click to enlarge]] | ||
| Line 100: | Line 104: | ||
[[File:Zoiper tls.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper tls.png|thumb|none|300px|Click to enlarge]] | ||
| - | Finally, go back to your account settings and at "Encryption settings" enable '''SRTP''' | + | Finally, go back to your account settings and at '''"Encryption settings"''' enable '''SRTP''' |
[[File:Zoiper srtp.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper srtp.png|thumb|none|300px|Click to enlarge]] | ||
| Line 112: | Line 116: | ||
=== 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 '''Finish''' button even though, they're all red. | |
| + | '''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 '''Finish'''. | ||
[[File:ZoiperApp_accerror.png|thumb|none|300px|Click to enlarge]] | [[File:ZoiperApp_accerror.png|thumb|none|300px|Click to enlarge]] | ||
| - | |||
| - | |||
=== SIP error codes === | === SIP error codes === | ||
| - | In case your account has been marked on red an error code number will be shown at Settings>> Accounts section. You can check the error response code and correct it. You can check the list of common [https://wiki.voip.ms/article/SIP_Responses SIP Response codes] for this. | + | In case your account has been marked on red, an error code number will be shown at '''Settings>> Accounts''' section. You can check the error response code and correct it. You can check the list of common [https://wiki.voip.ms/article/SIP_Responses SIP Response codes] for this. |
| Line 128: | Line 132: | ||
[[category:softphones]] | [[category:softphones]] | ||
| - | === 403 error === | + | ==== 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. | 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. | ||
| - | === 408 error === | + | ==== 408 error ==== |
On some networks, you might get this error code that could disappear when you change to a different network. This could be due to some limitation on the local SIP ports for this network. As a workaround, you can try the following modifications to your settings. | On some networks, you might get this error code that could disappear when you change to a different network. This could be due to some limitation on the local SIP ports for this network. As a workaround, you can try the following modifications to your settings. | ||
| - | 1. Go to Settings>> Conectivity>> Listening Ports and untick "Random Port" for Local SIP port only and type 5080 in the | + | 1. Go to '''Settings>> Conectivity>> Listening Ports''' and untick '''"Random Port"''' for Local SIP port only and type 5080 in the '''Port''' field. |
[[File:Zoiper ports.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper ports.png|thumb|none|300px|Click to enlarge]] | ||
| - | 2. Go to Settings>> Accounts>> Your account and at "Host" add ''':5080''' to the server's name. | + | 2. Go to '''Settings>> Accounts>> Your account''' and at '''"Host"''' add ''':5080''' to the server's name. |
[[File:Zoiper SIP acc port.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper SIP acc port.png|thumb|none|300px|Click to enlarge]] | ||
| Line 146: | Line 150: | ||
If you're experiencing issues with outgoing calls using the new Zoiper's PUSH server. Please follow these steps: | If you're experiencing issues with outgoing calls using the new Zoiper's PUSH server. Please follow these steps: | ||
| - | 1. At Settings >> Connectivity: | + | 1. At '''Settings >> Connectivity:''' |
| - | * Check/Enable | + | * Check/Enable '''"Enable PUSH Proxy"''' option. |
| - | * Set "Proxy protocols" to SIP+RTP. | + | * Set '''"Proxy protocols"''' to '''SIP+RTP'''. |
| - | * Set "Push transport" to TCP (Default). | + | * Set '''"Push transport"''' to '''TCP''' (Default). |
[[File:Zoiper-PUSH.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper-PUSH.png|thumb|none|300px|Click to enlarge]] | ||
| - | 2. At Settings >> Accounts >> Your account | + | 2. At '''Settings >> Accounts >> Your account''' |
| - | * Set "Authentication user" with your Main or sub account name. (It's the same value you have for "Username") | + | * Set '''"Authentication user"''' with your Main or sub account name. (It's the same value you have for "Username") |
[[File:Zoiper-AuthID.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper-AuthID.png|thumb|none|300px|Click to enlarge]] | ||
| - | 3. At Settings>> Accounts>> Your account >> Network settings | + | 3. At '''Settings>> Accounts>> Your account >> Network settings''' |
| - | * Set "Transport Type" to TCP | + | * Set '''"Transport Type"''' to '''TCP''' |
[[File:Zoiper-transport.png|thumb|none|300px|Click to enlarge]] | [[File:Zoiper-transport.png|thumb|none|300px|Click to enlarge]] | ||
Revision as of 01:31, 26 June 2019
Contents |
Configuration Detail
Setting up Zoiper with your SIP/IAX credentials
1. Start Zoiper IAX SIP VOIP Softphone App and click at Create an account.
2. On the welcome screen fill the Username and Password then click on Create an account
- 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. Skip the Authentication step. AuthUserID and Outbound Proxy are not needed.
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 shown under Accounts section and marked on Green with a tick arrow next to it. This means your softphone is ready to start placing calls. In case of failure, you can check what error code you're getting from section 3.2
Extra settings
Audio codecs
In order to use only the supported codecs by VoIP.ms please go to Settings>> Accounts>> Your account
Scroll down to Audio Codec Settings., and just enable "uLaw" and "GSM". You can touch over the codec and move it to the top of the list in order to change the order. We suggest keeping "uLaw" at the top. In case, you have bought "g729" make this your first option and move it right to the top.
For best results, it is recommended to use WI-FI. But if using 4G/LTE and you experience poor sound quality, it has been reported that turning off ECHO CANCELLATION helps solve the issue.
Network settings
In order to have your softphone running all the time, proceed with the following steps:
1. Go to Settings>> Connectivity and enable "Keep Alive WIFI" and "Run in Background"
2. Go to Settings>> Accounts>> Your Account>> Network Settings and change "Registration Expiry Time" to 180
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 you use UDP/TCP you will be rejected with error code 488. Enable this for the Main Account at Main Menu>> Account settings>> Advanced tab and for a sub-account at Sub accounts>> Manage sub-accounts and 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.
Go to Settings>> Accounts>> Your account and type:
- Host: 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 and look for Network settings and change the "Transport mode" to TLS
Finally, go back to your account settings and at "Encryption settings" enable SRTP
Your account should be shown as registered and when you place a call you will see a closed padlock, which means the call is now secure.
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 Finish button even though, they're all red.
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 Finish.
SIP error codes
In case your account has been marked on red, an error code number will be shown at Settings>> Accounts 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.
408 error
On some networks, you might get this error code that could disappear when you change to a different network. This could be due to some limitation on the local SIP ports for this network. As a workaround, you can try the following modifications to your settings.
1. Go to Settings>> Conectivity>> Listening Ports and untick "Random Port" for Local SIP port only and type 5080 in the Port field.
2. Go to Settings>> Accounts>> Your account and at "Host" add :5080 to the server's name.
Zoiper PUSH service
If you're experiencing issues with outgoing calls using the new Zoiper's PUSH server. Please follow these steps:
1. At Settings >> Connectivity:
- Check/Enable "Enable PUSH Proxy" option.
- Set "Proxy protocols" to SIP+RTP.
- Set "Push transport" to TCP (Default).
2. At Settings >> Accounts >> Your account
- Set "Authentication user" with your Main or sub account name. (It's the same value you have for "Username")
3. At Settings>> Accounts>> Your account >> Network settings
- Set "Transport Type" to TCP
