Why do we need the 3CX Barge Message? #

Companies all over the world use Compliance messages on an everyday basis. Some examples of these messages are,

• Notify the callers that their call is going to be recorded.
• Disclaimer statements.
• Service agreements.
• Policy statements.

Purpose of 3CX Barge Messages: #

• Save the agent’s voice and let the system say it for the agent.
• Present all the information with consistency to the customer.

How do Barge Messages work? #

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 message is heard by both the agent and all other callers participating in the
current phone call.

Prerequisites: #

Before you attempt to install 3CX Barge Messages, you need to ensure your computer meets the minimum
requirements outlined 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 (https://www.voiptools.com/iis-features-and-configuration)
• 7.0 or above
• Port number 7850 opened on your device.

NOTE:

• 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, be sure to install Basic Authentication, .Net Extensibility, and ASP.Net 4.X.

Installation #

	Download software	You can purchase the VoIPTools suite of tools (including 3CX Barge Messages) online at https://www.voiptools.com(https://www.voiptools.com). Your order confirmation email will include your license key and a link to download the software.
	Install Prerequisites	There are a number of prerequisites that must be installed prior to 3CX Barge Messages. If needed, the installer will prompt you to confirm the installation of .Net, SQL Server, and Internet Information Server (IIS).
	Install 3CX Barge Messages	This User Guide contains step-by-step instructions to successfully install 3CX Barge Messages. Begin by downloading the installer using the link provided in your order confirmation email then run the setup BargeMessages.exe.program.
	Register your License Key	You must register your license key to activate 3CX Barge Messages. Your license key is included in your order confirmation email, and can also be found in your order history on our website.

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

1. Find the software download link in the Order Confirmation Email, or you can find it in your order history on our website and download the 3CX Barge Message application.
2. In the Microsoft Defender SmartScreen, click the More Info option.

3. Click the Run Anyway option to start the installation.

Step 2: Install Prerequisites #

Click on the software installer that was downloaded in step 1 above. The installation wizard will automatically
identify the needed prerequisites and assist you with the install of each prerequisite needed to run ‘3CX Barge
Messages’. Prerequisites include .NET Framework (Web Installer), SQL Server Express (Web Installer) and,
SQL Server Management Studio.

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

2. Select/unselect the applications to be installed based on your unique requirements and click Next to continue.

NOTE:

It is important that you install all the required prerequisites.

The installer automatically downloads and installs the prerequisites. The download may take several minutes.

3. The Microsoft SQL Server License Terms page appears if you have selected to install SQL Server Express. Click Accept to acknowledge the license terms and continue.

4. Browse the Media Location field to change the SQL Server Media target location and click Install to begin the installation of SQL Server Express.

5. Click Close when the prerequisites are successfully installed.

The Microsoft SQL Server Management Studio begins to install. It may take several minutes to complete the installation.

6. Click Yes to reboot your computer.

Step 3: Start the installation process #

1. Click Next to Continue on the 3CX Barge Messages Setup Wizard page.

2. Note the Installation Folder where ‘3CX Barge Messages’ will be installed. Note that you cannot change the path.
3. Click Next to continue.

Step 4: Test Relay Settings: #

1. In the 3CX Relay Services window, in the Relay Host field, enter the FQDN of your 3CX server.
2. Enter 8801 in the Relay Port field.
3. Enter the public key you took from VoIPTools Relay services in the Public Key text area.

3. Click the Test Relay Settings to confirm ‘3CX Barge Messages’ can communicate with the Relay services running on the 3CX server.
4. If the ‘3CX Barge Messages’ is successfully able to communicate with the Relay services that run on the 3CX server, a Success message box appears. Click OK. If the test fails, you will not be able to continue until communication with the relay is established.
5. Click Next to continue with the installation.

NOTE:

If the Relay test was unsuccessful,

• Confirm you have the correct firewall port(s) open (default TCP 8801) on the 3CX server and the perimeter firewall protecting the 3CX server.
• Confirm that you have entered the correct IP address / FQDN for the 3CX server. If using an FQDN, confirm you can resolve the FQDN by pinging the name.
• Confirm that 3CX Barge Messages and the Relay are attempting to communicate on the same port and protocol (HTTPS/8801 or HTTP/8800).

Step 5: Configure the database #

When configuring 3CX Barge Messages, select an existing Microsoft SQL Server instance in your environment. The database server can be a remote SQL Server. Click this link to know How-to configure SQL Server to permit remote connections or on 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.

NOTE:

• We strongly encourage you to use SQL Authentication rather than Windows authentication. Many of our tools leverage a Call Flow Designer (CFD) application running on the 3CX. Frequently 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, your SQL Server must be configured to run in “Mixed Mode”. If you installed SQL Server with one of our tools, we automatically configure SQL in “Mixed Mode”.

2. Uncheck the Trusted Connection checkbox to use SQL Authentication.
3. In the Username and Password fields, enter valid SQL login account credentials.

4. Check the Trusted Connection (Windows integrated authentication) checkbox to use Windows Integrated Authentication (not recommended)
5. Select an existing database name from the list if you are upgrading or reinstalling 3CX Barge Messages. If installing for the first time use the default name In the Database field.
6. 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. Click Install to start the installation of ‘3CX Barge Messages’ In the Ready to Install window.

The application installation progresses. This may take several minutes to complete.

2. Click Finish when the installation is complete.

Step 7: Register your Software #

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

1. Click the 3CX Barge Messages desktop icon to open the web application.
2. In the Login page, log in with your credentials.
3. On the 3CX Barge Messages web portal, click License in the main menu.
4. In the Registration section, enter your License Key and other details appropriately and click Register.

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.

Login Page #

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.

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.

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. You can choose the TTS type as Windows TTS or Amazon Polly.

TTS type: Windows TTS #

1. Select Windows TTS from the TTS Type dropdown list.
2. From the Locale drop-down list, select the desired culture.
3. On the Gender drop-down, select Male or Female so that the Emergency Notifier will play the .wav file in the male or female voice.
4. In the Voice Name drop-down list, select the voice you want to use for dynamic recordings. The drop-down list generally displays all Voices installed on the computer.
5. In the Volume drop-down list, select the volume you want to apply for your recording.
6. On the Speech Rate drop-down list, select the desired speech rate to adjust the speed of the speech.
7. Click Save to save the data.

TTS type: Amazon Polly #

1. Select Amazon Polly from the TTS Type dropdown list to create a Self Identification Message (.wav file) using Amazon
   Web Services.
2. From the Locale drop-down list, select the desired culture.
3. In the Voice Name drop-down list, select the voice you want to use for dynamic recordings. The drop-down list generally displays all the Voices installed on your computer
4. In the Amazon Id and Amazon Key fields, enter valid details.
5. Click Save to save the data.

NOTE:

Learn to create an account on Amazon Web Services (AWS) and generate an AWS access key ID and the secret keyID using this link.(#aws)

General Settings: Select IVRs to barge in #

In General settings, you can select the list of IVRs for barging in the calls. The IVRs are fetched from the Digital Receptionists under the 3CX Console Management.

1. Select the checkboxes of the desired barge messages
2. Click Save to save the IVRs for barging in.
3. Once you save the IVR selections, click OK on the displayed Success dialogue box.

Prompts Screen #

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

Insert Prompt #

Follow the procedure to insert a prompt,

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 any one of the following,
   • Upload Audio File checkbox to upload a pre-recorded audio file in your device.
   • Add Prompt Text checkbox to add a text and convert the text into speech using the inbuilt TTS software.

Upload an audio file #

Follow the procedure if you wish to use a pre-recorded audio file as a prompt.

1. Select the Upload Audio File Checkbox.

2. Click the Browse button to browse your audio file or enter the file path in the File Path field.
3. Click Save to save the prompt settings.

Insert prompt by Prompt text #

Follow the procedure if you wish to add a text and convert the text into speech using the inbuilt TTS software.

1. Select the Add Prompt Text checkbox.

2. In the Prompt Text field, enter the text you want to play as audio.
3. Click Save to save the prompt settings.

NOTE:

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

Prompts Table functions #

• Click the Play to play and test your prompt message.

• Click BargeIn to barge in your prompt message to the call.

Figure 31: Barge in prompt

• Click Delete to delete the prompt messages from the Prompt Table.

Reports Screen #

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

DATE AND 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 another server inbound number, 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.

Support #

Visit our website to access our online manuals and receive quick answers to most of your questions. Otherwise, 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 and we now offer 24/7, 365 days a year.

Windows Event Log (Applications and Services VoIPTools) #

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

Forums #

Our forum is intended for VoIPTools customers to collaborate on real-life challenges, solutions, and best practices. You can participate on our forum 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 simply clicking on the Live Chat button at the lower right corner of our web page.

Email #

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

Phone #

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 will provide first-level support. Partners have access to 100% free technical support, provided they participate actively in the troubleshooting process.

VoIPTools customers have access to our online manuals and 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 for you. This includes installing SQL Server Express and Internet Information Server if required. Our team will work with you to configure our applications to best meet your needs.