With 3CX Barge Messages, you can inform your caller that their phone call is getting recorded, or you can recite lengthy regulatory compliance information. When the agent selects the desired prerecorded message to play, the following steps occur automatically,
3CX Barge Messages works by assigning prompt (.wav audio) files to Digital Receptionists (IVR).   Agents use a simple web interface to select the desired prompt. When ready, the agent will press a button on the web page to play the selected message. The agent and all other callers participating in the current phone call can hear the message.


Before installing 3CX Barge Messages, you need to ensure that your computer meets the minimum requirements mentioned below:

  • 3CX Professional / Enterprise Edition Version 18 Service Pack 4 or above
  • Windows 10 or above / Windows Server 2016 or above
  • Microsoft SQL Server 2016 or above (Including the free SQL Express edition)
  • Microsoft .Net 4.7.2 or above
  • VoIPTools 3CX Relay Service installed on the 3CX server (Windows or Linux)
  • Microsoft Internet Information Server IIS 7.0 or above

  • Installation on a domain controller may require additional assistance
  • When installing SQL Server, we recommend you install it in “Mixed Mode” to include SQL Authentication and install SQL Management Studio.
  • When installing IIS, you must install Basic Authentication, .Net Extensibility, and ASP.Net 4.X.


Download software

You can order 3CX Barge Messages online at https://www.voiptools.com. Your order confirmation email will include your license key and a link to download the software.

Install Prerequisites

You must install several prerequisites before installing the 3CX Barge Messages. These prerequisites include Microsoft Internet Information Server (IIS) and Microsoft SQL server.

Install 3CX Barge Messages

This User Guide contains step-by-step instructions to install 3CX Barge Messages. Run the BargeMessages.exe setup program and follow the instructions mentioned in the manual.

Register your License Key

You must register your license key to activate the 3CX Barge Messages. Your license key comes with the order confirmation email, or you can find it in the order history on our website.

4.Step by Step Installation Procedure

The following section guides you through a detailed walk-through of the installation process:

Step 1:  Download ‘3CX Barge Messages’.  

You can locate the software download link included in your order confirmation email, you can find the link from your order history on our website. or you can navigate to our Downloads page.

Step 2:  Install Prerequisites

Click on the software installer downloaded in step 1. The installation wizard will automatically identify the prerequisites and assist you with each installation required to run 3CX Barge Messages. It includes .NET Framework (Web Installer), SQL Server Express (Web Installer), and SQL Server Management Studio.

  1. Double-click the downloaded installer executable to launch the Prerequisites Setup Wizard and click Next.

Figure 1: Prerequisites Setup Wizard

  1. In the Prerequisites window, install all the required prerequisites identified by the installer, or select/unselect the applications based on your requirements and click Next to continue.

Figure 2: Select Prerequisites to Install


The installer will download and install the selected applications.

Figure 3: Prerequisites Installation in progress

  1. The Microsoft SQL Server License Terms page gets displayed if you install SQL Server Express. Click Accept to acknowledge the license terms and continue.

Figure 4: SQL Server Express: Accept License Terms

  1. In the Media Location field, browse to change the location and click Install to begin the installation of SQL Server Express.

Figure 5: SQL Server Express: Target Location

  1. Click Close when you install the prerequisites.

Figure 6: SQL Server Express: Installed Successfully

  1. Click Next when the installation is complete.

Figure 7: Microsoft SQL Server Management Studio: Installation in progress

  1. In the confirmation message box, click Yes to reboot the computer.

Figure 8: SQL Server Management Studio: Reboot your computer


Step 3: Start the installation process

  1. 3CXBarge Messages Setup Wizard appears when you install the prerequisites. Click Next to Continue.

Figure 9: 3CX Barge Messages Setup Wizard

  1. On the Select Installation Folder window, the Folder field displays the path where the 3CX Barge Messages gets installed. You cannot change the location path.

Figure 10: Installation Folder Location

  1. Click Next to continue.

Step 4: Test Relay Settings

  1. On the 3CX Relay Services window in the Relay Host field, enter the IP address or FQDN of your 3CX server.

Figure 11: Test VoIPTools 3CX Relay settings

  1. To maximize security, you must configure the Relay and 3CX Barge Messages to use HTTPS (TLS encryption). To use TLS security, set the Relay Port to 8801 and the Protocol to HTTPS.

You must set the Relay Port to 8800 and the Protocol to HTTP if you did not configure your Relay to use the TLS encryption.

Figure 12: Relay Protocol

  1. Click Test Relay Settings to confirm that 3CX Barge Messages can communicate with the Relay services operating on the 3CX server.


If the test was unsuccessful:

  • Confirm you have the correct firewall port open (default TCP 8801) on the 3CX server and the firewall protecting the 3CX server.
  • Confirm that you have entered the correct IP address / FQDN for the 3CX server.
  • Confirm that the 3CX Barge Messages and  Relay use the same port and protocol.


  1. In the  Success message box, click OK.
  2. Click Next to continue with the installation.

Figure 13: Success message box


If the Relay test fails, you cannot continue the installation until you establish communication with the Relay.


Step 5: Configure the database

When configuring the 3CX Barge Messages, select an existing Microsoft SQL Server Instance in your environment. The database server can be a remote SQL Server (How-to configure SQL Server to permit remote connections) or a local Instance running on the VoIPTools server.

  1. On the SQL Database window in the Server field, select the desired instance of SQL Server.

  • We recommend you use SQL Authentication rather than Windows authentication because most of our tools leverage a Call Flow Designer (CFD) application running on the 3CX.
  • Often our CFD applications require access to a SQL database. If the 3CX server and the database server are not in an Active Directory domain, Windows authentication will fail.
  • To use SQL Authentication, you must configure the SQL server to run in Mixed Mode. If you install SQL Server with our tools, we configure SQL in Mixed Mode.


Figure 14: SQL Authentication

  1. To use SQL Authentication, uncheck the Trusted Connection checkbox.
  2. In the Username and Password fields, enter valid SQL login account credentials.

Figure 15: Configure Database

  1. To use Windows Integrated Authentication (not recommended), check the Trusted Connection (Windows integrated authentication) checkbox.
  2. In the Database field, the installer will automatically display the default database name. We recommend you use the default name. To upgrade or reinstall 3CX Barge Messages, select the current database name from the list.
  3. Click the Test SQL Connection button to confirm connectivity to SQL Server and then click Next to continue.

Step 6: Installing 3CX Barge Messages

  1. In the Ready to Install window, click Install.

Figure 16: Install 3CX Barge Messages


The application installation progresses.

Figure 17: Installation of ‘3CX Barge Messages’ in progress

  1. Click Finish when you complete the installation to exit the Setup Wizard.

Figure 18: Installation Complete

5.Web Portal

To access the 3CX Emergency Notifier web portal, click the Web Portal button on the configuration program, or
Click the desktop icon created in the installation process (3CX Emergency Notifier Web).

When connecting to the web portal, you need to provide login credentials:

  1. In the Extension field, enter your 3CX extension number.
  2. In the PIN field, enter your 3CX voicemail PIN.
  3. Click Login to log in to your account.

Fig 20: 3CX Barge Messages Web Portal login




5.1.Setting up 3CX Barge Messages

License Screen

For registration, you need to log into the 3CX Barge Messages web portal and perform the following tasks:

  1. On the 3CX Barge Messages web portal, click the License menu.
  2. On the Registration section, enter your License Key and other details and click Register.

Fig: License Screen


About Screen:

After you register, click About in the main menu. You can check for the Version Number of the product, the Copyrights year, and the Address of VoipTools, LLC.,

If you find any discrepancy, you can contact or mail us.

Fig 21: About Screen





Settings Screen

In the Settings Screen, you can do General Setting and Voice Settings for your prompts.

Voice Settings:

3CX Barge Messages can call your contacts and play recordings. The recordings can be prerecorded or
dynamically created using Text-To-Speech. A dynamically created recording can list information about
the extension where you dialed the emergency number.

The following settings can modify some of the attributes of the voice used to make a dynamic recording.

  1. In the Voice Settings section, check the Dynamic Recording check box to turn on Dynamic Recording, or you can uncheck the check box to use a prerecorded recording rather than Text-To-Speech. Upload the prerecorded messages in the Messages tab.
  2. From the Locale list, select the desired culture.

Fig: Voice Settings


  1. On the TTS Type list, select the TTS Type as Windows TTS or Amazon Polly
    1. Select TTS Type: Windows TTS to create dynamic play files by using the voices installed on your computer.
      1. In the Voice Name list, select the voice you want to use for dynamic recordings. The list generally displays all Voices installed on the computer.
      2. In the Gender list, select Male or Female so that the Emergency Notifier will play the .wav file in the male or female voice.
      3. In the Volume list, select the volume to apply for your recording.
      4. On the Speech Rate list, select the desired speech rate to adjust the speed of the speech.


    1. Select TTS Type: Amazon Polly to create a Self Identification Message (.wav file) using Amazon Web Services.
      1. In the Amazon Id and Amazon Key fields, enter valid details.
        • Learn to create an account on Amazon Web Services (AWS) and generate an AWS access key ID and the secret keyID using this link.
      1. In the Voice Name list, select the voice you want to use for dynamic recordings. The list generally displays all the Voices installed on your computer.
  1. Click Save to save the data.

General Settings:

In General settings, you can select the list of IVRs for barging in the calls.

The IVRs get fetched from the Digital Receptionists under the 3CX Console Management.

Fig: Digital Receptionists


In this section you can do any of the following tasks,

  • Select the checkboxes of the desired barge messages and click Save .
  • You can click Cancel to cancel the operation.



Once you save the IVR selections, click OK in the Success dialog box.


Prompts Screen

In the Prompts screen, you can insert your Prompt Messages and barge the Prompt Messages in calls.

  • To insert a Prompt, follow the procedure,
    1. On the Prompt Administration box in the File Name field, enter the name for your Prompt Message.
    2. In the Version field, enter the version for your Prompt Message.
    3. In the Description field, enter the description for your Prompt Message.
    4. Select the Upload Audio File checkbox or Add Prompt Text checkbox and click Save

Fig: Prompt Screen

  • To upload an audio file,
    1. Select the Upload Audio File Checkbox.
    2. Enter your audio file path location or use Browse to browse your audio file and click Save

Fig: Browse Audio File

  • To add a Prompt text,
    1. Select the Add Prompt Text checkbox.
    2. In the Prompt Text field, enter the text you want to play as audio and click Save .

Fig: Add Prompt Text


  • Click Cancel  to cancel the Prompt message,

When you save the Prompt message, you will get an Info dialog box. Click the OK button to add the Prompt message to the Prompts Table.

Fig: Prompt added successfully


  • You can have the same File Names with different versions.
  • Example :
    • If you can have a file “Test_Sample version 1”, you can have “Test_Sample version 2,” but you cannot have “Test_Sample version 1.”

In the Prompts Table,

  • Click Play to play and test your prompt message.

Fig: Test and Play Prompt Messages.


  • Click BargeIn to barge in your prompt message to the call.
  • Click Delete to delete the prompt messages from the Prompt Table.

Fig: Row deleted


Reports Screen

In the Reports screen, you can see the reports of the BargedIn calls made by the user and the manager.

Fig: Reports Screen


Date Time The date and time of the prompt messages barged in. The date format is mm/dd/yy and the Time format is hh:mm: ss. 
Phone Number Phone number to which your prompt messages barged in. If the phone number is the same server extension, it is an Internal inbound call. If the phone number has an inbound number from another server, it is an External call.
Extension The extensions to which you barged in your prompt messages.
File Name The file name of your prompt message.
Version The version of your prompt message.

5.2.Setting up 3CX Barge Messages - User Extension Login

User access is given only by the Manager.  If you log in as a User can view only the About screen and the Prompt screen.

Prompt Screen:

In the Prompt screen, you can do the following functions,

  • Click Play to play and test the prompt messages in the system.

Fig: Prompts Screen for user

  • Click BargeIn  to barge in the available prompt messages to the call.
  • View the prompt text in the Prompt Text field.

Fig: View Prompt Text


About Screen:

The About screen displays the VoipTools address, Toll-Free numbers, and the copyrights year.


Visit our website to access our online manuals and receive quick answers to most of your questions, or you can contact us by phone, email, live chat, and on the VoIPTools forums.

Support Hours (USA and India)

Our team is ready to assist you with answers to your technical questions during regular business hours from Monday to Friday, 8:00 AM to 6:00 PM (Central Standard Time) and 8:00 AM to 12:00 AM (Indian Standard Time).

Windows Event Log (Applications and Services ? VoIPTools)

The Windows Event Log lists several errors, information messages, and warnings related to all our VoIPTools applications and services. You can use data here for troubleshooting various application errors.


Our forum is focused on VoIPTools customers and helps them to collaborate on real-life challenges, solutions, and best practices. You can participate in our platform at https://www.voiptools.com/community/.

Submit a Bug

If you suspect a bug in any of our VoIPTools products, you can bring it to our notice by reporting your issue at: https://www.voiptools.com/report-a-bug/.

Live Chat

Our chat support team is ready to acknowledge your queries in real-time. You can start a live chat with us by clicking on the Live Chat button at the lower right corner of our web page.


You can email us at: support@voiptools.com. Be sure to describe your issue in detail. We will get back to you within a business day of receiving your request.


You can call us at +1 801-642-4655 to reach a representative. VoIPTools will accept calls at this number from 8:00 AM to 6:00 PM (Central Standard Time).

Support Services

Free Support:

If you purchased our products through a VoIPTools Partner, your Partner provides you with first-level support. Partners can access 100% free technical support, provided they actively participate in troubleshooting.

VoIPTools customers have access to our online manuals. We will respond to emails (next business day) and live chat, but we will not log in to your servers remotely.

Paid Support:

If you purchase “Installation Support’ our support team can log in to your servers and install and configure all our tools. It includes installing SQL Server Express and Internet Information Server if required. Our team will work with you to configure our applications to meet your needs best.

Help Guide Powered by Documentor
Suggest Edit