How to Install, Configure and Provision the 3CX client for Android
Zero Admin
With the new Dashboard
Bulletproof Security
With SSL certs and NGINX
Install on $150 Appliance
Intel MiniPC architecture
New, Intuitive Windows Client
More themes, more UC
More CRM Integrations
Scripting Interface to add your own
Improved Integrated Web Conferencing
iOS and Android apps included
Personal Click2Meet URLs

02. How to Install, Configure and Provision the 3CX Client for Android

Installing the 3CX Client for Android

On this topic

Installing the 3CX Client for Android


System Requirements

Installing the 3CX Client for Android


See also


Employee mobility has become an important element of a successful business. Regardless of where you are work can’t wait and because of this we have all become physically attached to our smartphones. This is where the 3CX client for Android comes in. The Android client allows you to make and receive office calls on your Android device from your office extension, for free. Its user-friendly interface allows you to transfer calls, create conference calls, view the status of colleagues or control your own status from wherever you are. There’s no need to give out your personal mobile number anymore either!

System Requirements

The 3CX client for Android is supported on the following Android versions:

  • Android 4.X and higher


Installing the 3CX Client for Android

  1. Go to Google Play Store, and search for 3CX.
  2. Select the latest version of 3CX. This version requires 3CX Phone System v14 or v15. Important: In order to update your 3CX client for Android from v12.5 and prior you will have to uninstall the old app and re-install the new version.
  3. Tap Install and Accept for the application rights. The 3CX client for Android will be downloaded and the installation procedure will begin.
  4. Once the installation is completed you will have to Agree with the Licence Agreement.
  5. A message will appear confirming that your 3CX client for Android has been installed. Follow the instructions provided in the configuration wizard.
  6. Open the configuration file attached to your 3CX Welcome Email. This email was sent to you when your extension was created. If you cannot find it, ask your administrator to resend it. Once configuration is complete, you will see the Available” status in the dial screen and On Hook” in the right upper corner. You can now start making calls.


Once the installation and configuration is completed, you can personalize your 3CX client by tapping on the “Settings”  in the “More” button . In this section, you can set your audio and video options, choose between WiFi and 3G connectivity or even change your theme. Let’s have a closer look at the options provided below:

  1. Accounts: From within the accounts you may select which account you want to use. Additionally you may edit, remove or add accounts, use “Audio Codes” and more. IMPORTANT: Do not modify these settings unless you are advised to do so by your administrator. Note: You can edit your account by tapping your Name on the upper left corner of the dial screen.
  2. Audio Options: From here you can specify your Audio options and devices. Usually the default settings are exactly what you need but in case you need to change something, here’s how:
  • Echo cancellation: When enabled, it will minimize any echo heard during calls
  • Silence Detection: When enabled, the 3CX client will conserve bandwidth by not sending data when detecting silence. This might impede quality when enabled.
  • Microphone Gain: If the other party cannot hear you clearly, you can increase your microphone gain to amplify the volume of your voice.
  • Microphone Source: In some devices the microphone might not work in the default “Advanced mode, in which case switching to “Basic mode” will enable it.
  • Audio subsystem: The default option is “OpenSL”. If you experience some audio issues, then please switch to Java.
  1. Advanced Settings
  • Local SIP Port: Default is empty. When using the default setting, 3CX will use a random port provided by the system to pass SIP traffic through. If you would like to change this contact your administrator.
  • Lock Wi-Fi: Keeps Wi-Fi awake when the screen is turned off in order for 3CX to receive calls in the background.
  • Enable 3G: Allows 3CX to use 3G connectivity to make calls when Wifi is not available.
  • Full Screen: Hides the Android statusbar to use more screen space.
  • Proximity Sensor: If your device is equipped with a proximity sensor, 3CX will switch off the display when you put the phone to your ear during a call.
  • Keypad Tone: When enabled, 3CX will play dial tones when dialing a number.
  • Use System Ringtone: When enabled, you can set a different ringtone to use for 3CX.
  • Ringtone: Select the ringtone that will play when you receive a call in 3CX.
  • Verbose Logging: Logs debugging information so a detailed log report is created for submission to our support team.
  • Send Log Report: Send a log report to 3CX Support to troubleshoot potential issues.
  1. About: Find out which version is being used.


  1. If your client is having difficulties connecting to your PBX or is not registering, you can select the option “Register” to automatically re-provision the 3CX Client.
  2. In case you cannot find the original Welcome Email and you want to retrieve information such as your voicemail number, pin or other useful information, please select the option “Request Welcome Email.” 
  3. The 3CX client uses your phone’s default language. If you want to change the language you will have to do so from your phone settings.

See also

You might also be interested in:

Ask a Question

Please only post questions in regards to the document you are currently reading.
Technical support or pre sales questions must be posted via the support or sales channels and such comments will be deleted. Thank you for understanding

Leave a Reply

  1. Hi,

    Im not IT based so sorry for crude question.
    Im finding it difficult to change my voicemail. Im away on holidays and want to leave instructions on the message.
    Went to voice mail
    Pressed the “note” button
    Pressed the record button
    Named the messege “holiday”
    OKd it

    Then nothing….
    Ive followed the steps and named the new recording but dont get a call back to record message as I believe Im meant to. the phone was set up by my IT manager who is also now away on Hols :) .

    Can you help?
    What am I doing wrong

    July 23, 2015 at 3:01 pm Reply
    • Charalambos Eleftheriou

      @Conrad, You can also change your voicemail using your phone. Just dial you Voicmail number (999 by default) and follow the prompts. Thanks

      July 23, 2015 at 3:05 pm
    • Biju

      Hi There

      My problem is when phone turn to standby mode extension is not working even I have turn on the option wifi lock “Always”. Can you please advise me to how to keep on the extension.


      October 1, 2015 at 11:01 am
    • Charalambos Eleftheriou

      @Biju, thanks for the question. From what i understand here is that 3CXPhone for Android is going into the background and becomes unregistered, is this correct? This is by design to save on battery consumption. Please configured Google Push Servers as documented here: and enable your extension for Push then re-send the welcome email to reprovision your phone client with again. Then when a call is received a notification will be sent to your phone waking up the client and enabling you to answer the call.

      October 1, 2015 at 4:29 pm
  2. paul bradley

    I have installed the app on an Android phone and created the users extension. I have sent the extension to the user and they have downloaded it. Everything is set correctly but I am still getting “Registration Failed: Invalid Password”. I went into the Web console and changed the password to another one, clicked apply. I then went into the phone itself and updated the password to the new one, but I continue to get the same error.
    Any help would be appreciated

    Also, I have tried to register with Wi-Fi on and off.

    Thank you,

    August 14, 2015 at 8:43 pm Reply
    • Charalambos Eleftheriou

      @Paul, Thanks for the question. Have you tried to remove and re-install 3CXPhone for Android on your device (Clearing the data also). Then once re-installed resend the welcome email again and provision with the attachment.

      August 17, 2015 at 4:21 pm
    • Alex

      hi, Eleftheriou!

      I try that troubleshouting some times, and nothing help to my phone.. What can be else?

      September 4, 2015 at 10:00 pm
  3. Hallo,
    Ich habe ein Problem.Ich kann nicht mein Smartphone mit 3CX Phone v14 konfigurieren Ich habe keine email mit Befestigung bekommen. Was kan ich machen? Danke

    September 21, 2015 at 12:43 pm Reply
    • Charalambos Eleftheriou

      @Dumitru, Danke für die Frage.Fragen Sie Ihren 3CX IP-TelefonsystemadministratorIhnen die Willkommens-Mail erneut zu senden und zu prüfen, ob die E-Mail wird nicht in Ihr E-Mail- Spam-Ordner gehen.

      September 21, 2015 at 12:47 pm
  4. Patrick M

    I am running 3cx PBX v14 and have phones and trunks working fine. The 3CXPhone14 app fails to register saying client is not compatible with current version of Phone System. Version 14 of Phone System is required. That’s what I’m on! WTH?

    September 22, 2015 at 9:24 pm Reply
    • Charalambos Eleftheriou

      @Patrick, thanks for the question. If seems as though your 3CXPhone has not updated correctly. Please uninstall 3CXPhone for Windows and also manually delete the folder 3CXPhone for Windows found under %Appdata%. To access the folder, open a Windows explorer window and in the address bar type %appData% and press enter. Then re install 3CXPhone v14 and use the config file from the welcome email to provision.

      September 23, 2015 at 10:48 am
  5. peter chan

    we are using v12, installed android client, can make voice all, but the status at left top corner still “not connected”. Already set firewall allow all connection and checked main ports can be telnet (80,443,5000,5060,5061,5090). Could you help? Thanks in advance.

    September 29, 2015 at 10:56 am Reply
    • Charalambos Eleftheriou

      @Peter, thanks for the question. If you are using ports 5000 and 5001 for your webserver, check port Tcp 5001 on the firewall and make sure that it’s open too. See this guide for more details:

      September 29, 2015 at 12:37 pm
  6. Dev

    I have done as suggested but when i try and open the configuration document sent by my administrator, the phone says it can’t open the file as it doesn’t have the correct viewer. I am using a HTC one.

    October 15, 2015 at 5:45 pm Reply
    • Charalambos Eleftheriou

      @Dev, thanks for the question. Download and install a program called es-file explorer from the Google play store. Open the config file using this program and then you will be able to choose your 3CXPhone.

      October 15, 2015 at 5:56 pm
  7. Phillip


    I have 3CX Phone app V. 14.0.47 installed on Android 5.0.2 Phone: Software version VS9803AA LG G2. When I click on the config file that was downloaded from welcome email, I get an error message: Provisioning Error. Provisioning file can not be read or is not in an expected format. Contact support Please advise. Thank you.

    November 13, 2015 at 9:46 pm Reply
    • Charalambos Eleftheriou

      @Phillip, thanks for the question. Download and install Es-file explorer on your Android device from the Google play store. locate the config file you have download with the Es-file explorer app, click the config file and you will be able to select your 3CXPhone for Android to open it with.

      November 13, 2015 at 9:53 pm
  8. Jed simpson

    Hi when I click on accounts it takes me to a blank page with no add account option and the bottom of the screen. I am using a Samsung galaxy 6 edge but a work mate has the the same phone and 3cx 14 installed and doesn’t have this problem. Any ideas what is wrong? Cheers jed.

    April 10, 2016 at 2:12 pm Reply
    • Charalambos Eleftheriou

      @Jed, Download and install ES File explorer from the Google Play store, then open the downloaded config file in this app and choose 3CXPhone when prompted to choose an app to open it with.

      April 11, 2016 at 9:09 am
  9. Dimitris Tselios


    I am using a 3CX v12 Softphone for android and a 3CX v12 Windows softphone on my laptop. Both sofphones are configured as “out-of-LAN”. When a call comes to my extension from a ring group I have the following issue. When my mobile is up and running the call rings once on my laptop and then it goes to voice recorder. This implies that the rule I have set “send call to my voice mail when no answer if I am avialble” is executed. When my mobile is closed the call rings on my lpatop as it should be for 30 seconds. When my mobile is up and running, if I press the 3CX phone icon once then the call rings ALSO on my mobile and my laptop for 30 seconds. Ideally I would like to be able to receive push notifications to my mobile ONLY when my presence is “out of office”. If this is not possible then the call coming from ring group should ring to be lalptop no matter what is the status of the mobile phone. Any ideas ?

    June 16, 2016 at 6:33 pm Reply
    • Charalambos Eleftheriou

      @Dimitris, It is not possible to receive push to the mobile only when statuses are set. In addition statuses set on an extension are ignored when calls are received into a ring group that the extension is a member, except for a couple of specific settings. Also as v12 is no longer supported i suggest you upgrade to v14 to take advantage of the new and improved mobile clients. Please see this guide for the details on how to do this:

      June 16, 2016 at 6:55 pm
  10. Mike

    Hi, I am using 3CX V14 and have installed the 3CX Phone for Android. The 3CX phone is registered with PBX, I receive calls when the specified extension is used, but the 3CX phone is DISCONNECTED. It keeps trying to connect, but it can not. How do I connect it?

    Thank you.

    July 1, 2016 at 3:51 am Reply
  11. Robyn

    I have tried installing the app on an android phone, it keeps saying registration failed. We have uninstalled and re installed the app, re run the config file, as well as a brand new one, and nothing seems to be working. Is there something that I have missed in the installation?

    October 25, 2016 at 8:25 pm Reply
    • Charalambos Eleftheriou

      @Robyn, check that you have the required firewall ports open if you are trying to connect from outside the network.

      October 29, 2016 at 12:19 pm
  12. Stephane

    I configured the push via google successfully. Phone confirms that push is enabled. But once the screen goes off I don’t receive any calls. I need to go into the app to receive calls.



    November 23, 2016 at 3:23 pm Reply
    • Stephane

      Forgot to mention that I’m having this issue on Android 6.0.1

      November 23, 2016 at 3:24 pm
    • Then push is simply not enabled or working. Otherwise you will see. Exit the app and select Exit enabling push. And try again.

      November 24, 2016 at 10:11 am
  13. James


    My issue with 3CX android mobile is that it connects to PBX (On hook) however it does not connect to Queue, the availability status keeps trying to connect and disconnect. Not sure what’s causing that.

    December 20, 2016 at 1:01 am Reply
    • You have a connection issue with the presence server. Do you see the contacts? Check the HTTP and HTTPS ports are open and port forwarded on the pbx side.

      December 20, 2016 at 4:02 pm
  14. maria proctor

    Hi I have installed the 3cx on my Android phone and I can make calls to my head office. I can hear them, but they cannot hear me. Any tips?

    January 4, 2017 at 8:00 am Reply
  15. Mohammad

    One of my android client inside office tries to connect to public IP instead of local IP, so I should remove the tick beside “Disallow use of extension outside the LAN” in extension options. Other clients are working fine inside the LAN even without Internet connection.

    January 8, 2017 at 5:10 pm Reply
    • Wissam

      hello Mohammed
      how can I make an internal calls without internet connection??? when there’s no internet ,3cx clients keep showing registering ,not registered…. in this case I cannot call anybody in my network. till I have the internet connection

      January 11, 2017 at 1:35 pm
    • Yes you can – only if the internal phones are on the same lan.
      But if the client is remote, then of course you need internet.
      If the client is not registered then not only the internet went down, but also your connection to the lan (assuming you are in the same lan as the pbx).

      January 16, 2017 at 3:42 pm
  16. Wissam

    I just have a question please
    how can I make an internal calls without internet connection??? when there’s no internet ,3cx client keep showing registering and available…. in this case I cannot call anybody in my network. till I have the internet connection

    can you please help me out to solve this problem

    Thanks in advance

    January 11, 2017 at 10:29 am Reply
    • where are you located when you want to make an internal call? Are you in the same lan as the server?

      January 16, 2017 at 3:43 pm