---
title: Surveyor V18
description: "[3CX Surveyor by VoIPTools | Webinar clip 8/9/2022](https://www.youtube.com/embed/wHozqXC6Cdg?feature=oembed) # Introduction ***Revolutionize Your Call Center Operations with Surveyor: The Future of Campaign Management and Customer Engagement*** The 3CX Surveyor is an advanced web-based \"preview\" dialer designed to revolutionize your call center's…"
url: "https://voiptools.com/docs/surveyor-v18/"
updated: "2024-10-29"
category: "Tools - V18"
---

# Surveyor V18

[3CX Surveyor by VoIPTools | Webinar clip 8/9/2022](https://www.youtube.com/embed/wHozqXC6Cdg?feature=oembed)

# Introduction

***Revolutionize Your Call Center Operations with Surveyor: The Future of Campaign Management and Customer Engagement***

The 3CX Surveyor is an advanced web-based "preview" dialer designed to revolutionize your call center's campaign management. With Surveyor, you easily make impactful outbound calls to your contacts, ensuring high-touch interactions and exceptional results. Manage campaigns, assign agents to phone lists, and personalize interactions with script-reading capabilities. Gain valuable insights through web-based performance reports to optimize your call center operations. 3CX Surveyor provides detailed customer profiles, an integrated mini CRM, and the tools to treat customers like family, empowering your team to build strong relationships, ensure customer satisfaction, and drive sales.

## What is a 3CX Surveyor?

The 3CX Surveyor is a web-based "preview" dialer designed for the 3CX platform. Empower your agents to conduct personalized outbound calls, manage campaigns efficiently, use survey scripts, and generate performance reports. Manually import contacts into the tool and seamlessly integrate it with 3CX PBX for Windows. Agents can work from home or the office using the user-friendly web interface and 3CX softphone. Optimize your outbound calling processes with 3CX Surveyor for remarkable results.

## Why choose 3CX Surveyor?

| ![](https://voiptools.com/wp-content/uploads/2023/01/captivating-script.png) | **CAPTIVATING SCRIPTS** | Effectively engage your clients with captivating, personalized scripts tailored to their needs and preferences. Our user-friendly web-based system enables seamless script management and customization for exceptional customer interactions. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/seamless-monitoring-1.png) | **SEAMLESS MONITORING** | Efficiently monitor customer service progress with our integrated mini CRM. Track and evaluate customer interactions seamlessly to deliver personalized experiences and exceptional support. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/real-time-insights-1.png) | **REAL-TIME INSIGHTS** | Gain access to comprehensive and real-time insights through powerful web-based performance reports on survey data. Utilize simple yet robust analyses to reveal valuable trends and patterns, empowering data-driven decisions that propel your business forward. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/campaign-optimization.png) | **CAMPAIGN OPTIMIZATION** | Efficiently organize and optimize your campaigns by assigning agents to targeted phone lists and equipping them with survey scripts. Empower your team to conduct impactful outreach, ensuring valuable feedback and driving superior campaign results with confidence |
| ![](https://voiptools.com/wp-content/uploads/2023/01/high-touch-outbound-calls-1.png) | **HIGH-TOUCH OUTBOUND CALLS** | Establish profound connections with your contacts through our personalized and "high-touch" outbound calls. Our solution empowers your agents to confidently build rapport and foster relationships, guaranteeing that every interaction leaves a positive and enduring impact. |

# Prerequisites

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

- 3CX version V18
- Client: Internet Explorer, Google Chrome, Firefox, Opera browsers
- Server: Windows 10 (64-bit) or above / Windows Server 2012 (64-bit) or above
- [Microsoft Internet Information Server (IIS)](https://voiptools.com/docs/iis-features-and-configuration/) 7.0 or above
- Microsoft SQL Server 2016 or above (Including the free SQL Express edition)
- Microsoft .net 4.7.2 or above
- VoIPTools Relay installed on the 3CX server
- Port number **5800**opened on your device.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> While installing SQL Server, ensure the following,
>
>
>
> - Uninstall the previous versions of SQL Management Studio manually before installing the new version.
> - *Install it in “Mixed Mode” to include SQL Authentication, and install SQL Management Studio*

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png)**NOTE**:
>
>
>
> - You can run Abyss, IIS, and NGIX on the same server.
>
>
>
> - When installing IIS, be sure to install Basic Authentication, .Net Extensibility, and ASP.Net 4.X

# Installation overview

| ![](https://voiptools.com/wp-content/uploads/2023/01/1-2.png) | **[DOWNLOAD SOFTWARE](https://voiptools.com/docs/surveyor-v18/#6-toc-title)** | You can order 3CX Surveyor online at [https://www.voiptools.com](https://voiptools.com/downloads/).  Your order confirmation email will include your license key and a link to download the software. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/2.png) | **[INSTALL PREREQUISITES](https://voiptools.com/docs/surveyor-v18/#7-toc-title)** | There are a number of prerequisites that must be installed prior to installing the 3CX Surveyor. These prerequisites include Microsoft Internet Information Server (IIS) and Microsoft SQL Server |
| ![](https://voiptools.com/wp-content/uploads/2023/01/3.png) | **[INSTALL 3CX SURVEYOR](https://voiptools.com/docs/surveyor-v18/#7-toc-title)** | This User Guide contains step-by-step instructions to successfully install 3CX Surveyor. Begin by extracting the installer from the downloaded zip file (Step 1 above), then run the setup program named **SurveyorInstaller.exe** |
| ![](https://voiptools.com/wp-content/uploads/2023/01/4.png) | [**REGISTER YOUR SOFTWARE**](https://voiptools.com/docs/surveyor-v18/#12-toc-title) | You must register your license key to activate 3CX Surveyor. 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 Surveyor

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 Surveyor application.
2. In the**Microsoft Defender SmartScreen**, click the**More Info** option.

[![](https://voiptools.com/wp-content/uploads/2023/05/defender-7.png)](https://voiptools.com/wp-content/uploads/2023/05/defender-7.png)
***Figure*** 1: Windows defender screen

1. Click the **Run Anyway** option to start the installation.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-More-info-screen.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-More-info-screen.png)
***Figure*** 2: Microsoft Defender: More info screen

## Step 2: Install the 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 3CX Surveyor. It includes .NET Framework (Web Installer), SQL Server Express (Web Installer), and SQL Server Management Studio.

1. Click the downloaded installer executable to launch the **Prerequisites Setup Wizard** and click **Next**.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-CX-Surveyor-Setup-Wizard.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-CX-Surveyor-Setup-Wizard.png)
***Figure 3: 3CX Surveyor 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.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisite-installation-Selection.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisite-installation-Selection.png)
***Figure 4: Prerequisite installation Selection***

The installer will download and install the selected applications. It may take several minutes to complete.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisites-Installation-in-progress.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisites-Installation-in-progress.png)
***Figure 5: Prerequisites Installation in progress***

1. In the **Microsoft SQL Server License Terms **click the **Accept **button to acknowledge the license terms and continue.
   - This page appears if you do not have **SQL Server Express** preinstalled in your device.

[![](https://voiptools.com/wp-content/uploads/2024/03/1.png)](https://voiptools.com/wp-content/uploads/2024/03/1.png)
***Figure 6: SQL Server Express: Accept License Terms***

1. View the SQL Server Media target location in the **Media Location** field. If required, you can click the **Browse**button to change the location. Click **Install** to begin the installation of SQL Server Express.

[![](https://voiptools.com/wp-content/uploads/2024/03/2.png)](https://voiptools.com/wp-content/uploads/2024/03/2.png)
***Figure 7: SQL Server Express: Target Location***

SQL server installation is in progress. This may take several minutes to complete.

![](https://voiptools.com/wp-content/uploads/2024/03/3.png)
Figure: SQL Server Installation In Progress

1. Click the **Close**button once the prerequisites are installed.

[![](https://voiptools.com/wp-content/uploads/2024/03/4.png)](https://voiptools.com/wp-content/uploads/2024/03/4.png)
***Figure 8: SQL Server Express: Installed Successfully***

Microsoft SQL Management Studio installation is in progress. This may take several minutes to complete.

[![](https://voiptools.com/wp-content/uploads/2024/08/screenshot-OCM-SQL-Server-Management-Studio-Version-20.2.png)](https://voiptools.com/wp-content/uploads/2024/08/screenshot-OCM-SQL-Server-Management-Studio-Version-20.2.png)
***Figure 9: Microsoft SQL Server Management Studio: Installation in progress***

1. Click **Yes **in the **Confirmation Message Box** to reboot the computer.

***Figure 10: Reboot confirmation message box***

## Step 3: Start the installation process

1. Click **Next** on the **3CX Surveyor** **Setup Wizard** screen.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-setup-wizard.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-setup-wizard.png)
***Figure 11: Surveyor setup wizard***

1. On the Select Installation Folder window, the Folder field displays the path where the 3CX Surveyor gets installed. You cannot change the location path.
2. Click **Next **to continue

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-select-the-installation-folder.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-select-the-installation-folder.png)
***Figure 12: Surveyor select the installation folder***

## 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*880*1 in the **Relay Port** field.
3. Enter the *public key*you took from **VoIPTools Relay services**in the **Public Key**text area.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Configure-Relay-services.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Configure-Relay-services.png)
***Figure 13: Configure Relay services***

1. Click the **Test Relay Settings**to confirm ‘3CX Surveyor’ can communicate with the Relay services running on the 3CX server.
2. If the ‘3CX Surveyor’ 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.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Test-Relay-Success.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Test-Relay-Success.png)
***************************************************Figure*** 14: Test Relay Success************************************************

1. Click **Next** to continue with the installation.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> - You must set the Relay Port to 8801.
> - If the test was unsuccessful:*If the Relay test fails, you cannot continue the installation until you establish communication with the Relay.* Confirm the following if the Relay test failed,
>   - 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 FQDN for the 3CX server.
>   - Confirm that the 3CX Surveyor and Relay use the same port and protocol.

>

## Step 5: Configure the database

When configuring 3CX Surveyor, select an existing Microsoft SQL Server instance in your environment. The database server can be a **[remote SQL Server](https://voiptools.com/docs/configure-sql-server-for-remote-access-over-internet/)** or a local instance running on the VolPTools server.

1. On the SQL Database window in the Server field, select the desired instance of SQL Server.
2. To use SQL Authentication, uncheck the Trusted Connection checkbox.
3. In the Username and Password fields, enter valid SQL login account credentials.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Configure-SQL-database.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Configure-SQL-database.png)
***Figure 15: Configure SQL database***

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> - *We recommend you 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, 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.*

1. To use Windows Integrated Authentication (not recommended), check the Trusted Connection (Windows integrated authentication) checkbox.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> *In the Database field, the installer will automatically display the default database name. We encourage you to use the default name. To upgrade or reinstall 3CX Surveyor, select the current database name from the list.*

1. Click the **Tool **buttons to confirm connectivity to SQL Server. and click **OK** on the **Test Results **message box.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-OOL-Test-SQL-Connection-results.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-OOL-Test-SQL-Connection-results.png)
***Figure 16: TOOL Test SQL Connection results***

1. Click **Next**to continue with the installation.

## Step 6: Installing 3CX Surveyor

1. Click **Install **in the **Ready to Install **window.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Ready-to-install-screen.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Ready-to-install-screen.png)
Figure 17: Ready to install screen

The installation is in progress. This may take several minutes to complete.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Installing-3CX-Surveyor.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Installing-3CX-Surveyor.png)
***Figure 18: Installing 3CX***Surveyor

Check the** Launch 3CX Surveyor** checkbox and click **Finish **when the installation is complete.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-setup-completed.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-setup-completed.png)
***Figure 19: Surveyor setup completed***

## Step 7: Register the software

1. Click the**Surveyor Web** ![](https://voiptools.com/wp-content/uploads/2023/01/surveyor-icon.png)desktop icon to open the web application.
2. On the **Login**page, do the following tasks,
   1. In the **Extension **field, enter *your 3CX extension number.*

   1. In the **PIN **field, enter *your 3CX voicemail PIN.*
   2. Click the **Login **button to log in to your account

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> When logging in initially as an Agent, access to the application is denied. Agents gain access to the web portal only after a manager registers the application, allowing their entry. This process ensures Agent access but requires prior managerial registration for application authorization.
>
>
>
> ![](https://voiptools.com/wp-content/uploads/2023/11/screenshot-surveyor-login-access-restricted.png)
> Figure: Agent Restricted for Registration Process

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> If the Extension does not belong to **Surveyor Extension Group** then you will be unable to login to the 3CX Surveyor, and an error message appears as “Not Authorized for Dialer”

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-login-page-1024x491.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-login-page-1024x491.png)
*Figure 20: Web Portal Login*

1. On the top menu, hover over the **Settings**tab to display the settings menu.
2. Select**General Settings** from the settings menu.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-settings-menu.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-settings-menu.png)
Figure 21: Settings menu

1. In the top menu click the **Register**tab.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-register-1024x202.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-register.png)
Figure 22: Register tab

1. Enter*the license key*that you got in your order confirmation email. If you do not have one, you can order 3CX Surveyor online at [https://www.voiptools.com](https://web.archive.org/web/20220814064626/https://www.voiptools.com/) so that your order confirmation email will include your license key and a link to download the software.
2. Click **Register**![](https://voiptools.com/wp-content/uploads/2023/01/pencil-1.png)to register your software.

[![](https://voiptools.com/wp-content/uploads/2023/11/screenshot-surveyor-license-page-1024x475.jpg)](https://voiptools.com/wp-content/uploads/2023/11/screenshot-surveyor-license-page.jpg)
*Figure 23: 3CX Surveyor – Registration*

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> The license key permits you to install 3CX Surveyor on one computer. This is not free software.[https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2019/11/SrvrRegister.png](https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2019/11/SrvrRegister.png)

# Web Portal

To access the ‘3CX Surveyor’ web portal, click the **Web Portal** button on the configuration program, or click on the desktop icon that was created during the installation process (3CX Surveyor Web).

## Assign Roles in 3CX Console Management

In the **3CX Management Console**, you can assign user roles to extensions in order to control the access rights within the application. From here, you can also view the type of role associated with a specific extension.

### Assign the ‘Manager’ Role To An Extension

You can assign a ‘Manager’ role to a specific extension through the **3CX Console Management**

1. Log in to **3CX Console Management** with valid user credentials.
2. In the left side panel click the **Users**menu.
3. From the **Extensions** listing screen, find and double-click the desired extension to which you want to assign **Manager **Role. You can also type the extension number in the search bar for quick reference.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Extensions-1024x431.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Extensions.png)
**Figure 24: 3CX Console Management – Extensions**

1. On the tab bar, select **Rights**.
2. From the **Group Membership** drop down, select desired group to which you want to associate the current extension as **Manager**
3. From the **Role** drop down, select the option as **Manager**
4. On the top of the page, beside user name, click **OK**

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Set-‘Role-as-‘Manager-1024x446.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Set-‘Role-as-‘Manager-1024x446.png)
*Figure 25: Set ‘Role’ as ‘Manager’*

### View User Roles for Members of a Group

You can view user role for any extension through the **3CX Console Management**

1. In the **3CX Console Management** and from the **Navigation Pane**, select **Groups**.
2. From the **Extension Groups** listing screen, find and double-click the desired extension group for which you want to view the user roles for all of its associated extensions (members).

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Groups-–-Surveyor-Extension-Group-For-Example-1-1024x430.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Groups-–-Surveyor-Extension-Group-For-Example-1.png)
**Figure 26: 3CX Console Management – Groups – Surveyor Extension Group (For Example)**

>

1. In the **General **tab, under **Members **and in the **Role **column, you can view the associated role for each of the extensions of the group.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Group-Members-–-Role-1024x731.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-3CX-Console-Management-–-Group-Members-–-Role.png)
Figure 27: View role for extensions

### Manager view

You can see the following tabs when logged in as a Manager.

- [Dialer](https://voiptools.com/docs/surveyor-v18/#60-toc-title)
- [Campaign](https://voiptools.com/docs/surveyor-v18/#49-toc-title)
- [Contacts](https://voiptools.com/docs/surveyor-v18/#42-toc-title)
- [Import](https://voiptools.com/docs/surveyor-v18/#41-toc-title)
- [Reports](https://voiptools.com/docs/surveyor-v18/#76-toc-title)
- [Settings](https://voiptools.com/docs/surveyor-v18/#20-toc-title)
- About

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-manager-view-1024x188.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-manager-view-1024x188.png)
Figure 28: Tabs visible for a Manager

### Agent View

You can see the following tabs when logged in as an Agent.

- [Dialer](https://voiptools.com/docs/surveyor-v18/#60-toc-title)
- [Contacts](https://voiptools.com/docs/surveyor-v18/#42-toc-title)
- About

[![](https://voiptools.com/wp-content/uploads/2023/04/agent-view.png)](https://voiptools.com/wp-content/uploads/2023/04/agent-view.png)
Figure 29: Tabs visible for an Agent

## Settings

**Settings** enable you to configure general settings and customize brand settings.

**General Settings** enable you to register 3CX Surveyor software, control who can edit label text, and add dispositions and lookups. On the other hand, **Site Settings** enable you to customize branding settings for the application

Hover over the mouse on the Settings tab to display the dropdown menu with the following menu options:

- [General Settings](https://voiptools.com/docs/surveyor-v18/#20-toc-title)
- [Site Settings](https://voiptools.com/docs/surveyor-v18/#35-toc-title)

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Settings-menu.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Settings-menu.png)
**Figure 30: Settings menu**

>

### General Settings

**General Settings** screen enables you to register 3CX Surveyor software, control who can edit label text, and add dispositions and lookups.

>

#### Widget

**Widget** screen enables you to select desired widgets that you want to display in the **Dialer** screen.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-default-view-1-1024x749.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-default-view-1-1024x749.png)
*Figure 31: Widget Screen*

>

1. In the **Widget** screen, check all the desired widgets that you want to display in the **Dialer** screen and then at the footer, click ![](https://voiptools.com/wp-content/uploads/2023/01/save.jpg) **Save** ![](https://voiptools.com/wp-content/uploads/2023/01/save.jpg).
2. Click ![](https://voiptools.com/wp-content/uploads/2023/03/refresh.png)**Reload** to restart the application and display your changes.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> Pressing the ‘Reload’ button will log all users out of ‘3CX Surveyor’. The ‘Reload’ button will restart the application and display your changes.

#### General

Here, you can perform general settings for your ‘3CX Surveyor’ like set language, extension group and session timeout.

##### General Section

You can perform the following function in the General section.

 **Culture **drop-down list

Select the language to control how dates and currency should be displayed throughout the 3CX Surveyor web portal.

![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) ***NOTE***: *The default Culture is English.*

[![This image has an empty alt attribute; its file name is Screenshot-Surveyor-general-section-1024x809.png](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-general-section-1024x809.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-general-section-1024x809.png)
Figure 32: General settings: General section

|  **Culture **drop-down list | Select the language to control how dates and currency should be displayed throughout the 3CX Surveyor web portal. ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) ***NOTE***: *The default Culture is English.* |
| --- | --- |
|  **Surveyor Extension Group** field | Specify a 3CX extension group so that only the members assigned to this extension group can login to the 3CX Surveyor web portal. ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) ***NOTE***: *Surveyor licensing is based on the number of people in this extension group (including extension group managers).* |
|  **Wait Time** box | Enter time (in minutes) to control how soon a contact will be presented in the list of people to be called again, for example, the contact was previously dispositioned as “No Answer” |
|  **Session Timeout** box | Enter the time (in minutes) to control when a web page (session) will expire based on inactivity. When a web page expires, the user is redirected to the login page. |

[![This image has an empty alt attribute; its file name is Screenshot-Surveyor-general-section-1024x809.png](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-general-section-1024x809.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-general-section-1024x809.png)
Figure 32: General settings: General section

##### **Auto Import**

If you want to enable the automatic import of new CSV files, check the **Auto Import Contacts** box.

1. Under Auto Import section, check Auto Import Contacts box to turn on the auto-import feature so that the 3CX Surveyor automatically imports new CSV files from the monitored folder.
2. Check **First Row Header** check box to skip the first row of the CSV file if this row contains column heading rather than data to be imported.
3. In the **Import Path** field, enter the path of the monitored folder used by the auto-import feature.
4. In the **Archive Path** field, enter the path of the folder to which the original CSV file has to be moved once it has been auto-imported.
5. Click **Save** to save the data.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> Surveyor has the ability to monitor a specified folder and if a new CSV file is placed in the monitored folder, the contents are automatically imported into a campaign.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-auto-import-section-1-1024x809.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-auto-import-section-1-1024x809.png)
*Figure 33: General Settings: Auto Import*

>

**The controls** screen enables you to edit Label Text and control who can edit data for a specific ‘Label’ that appears in a specific screen.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-controls-screen-1-1024x808.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-controls-screen-1.png)
*Figure 34: General Settings – Controls screen*

##### **Grant Permission to Edit a Control**

1. On the **Settings **screen and in the **Controls **tab, search for the control for which you want to grant ‘Update’ permission.
2. Check one or more of the groups (Admins, Managers, and Users) that you want to grant update rights so that they can edit ‘Label’ data in a specific screen.
3. On the bottom right corner of the screen, click **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the changes.

##### **Edit the Update Rights for a Control**

1. In the **Controls **tab, select the control for which you want to edit the ‘Update’ rights.
2. Check or uncheck the group(s) to grant or revoke permissions respectively.
3. Click **Save ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg)** to save the changes.

##### **Edit Label Text**

1. In the **Controls **tab, select the control for which you want to edit the label text.
2. In the **Label Text** field, edit the text.
3. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/01/save.jpg) to save the data.

#### Dispositions

**Disposition **is a **Call Status** text that best describes why a call was dispositioned. (For instance, the disposition can be defined through call status as ‘Busy’, ‘Not Interested’, ‘Item Sold’ etc.). The disposition that you create will be added to the list in **Call Status** widget of **Dialer **screen. You can add a new or edit an existing disposition.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> You cannot delete a disposition. However, you can make it unavailable by simply checking **Disable **box.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-dispositions-screen-1024x747.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-dispositions-screen.png)
*Figure 35: General Settings – Dispositions screen*

>

##### **Add New Disposition**

1. On the **Settings **screen and in the **Dispositions** tab, click **Add **![](https://voiptools.com/wp-content/uploads/2023/03/black-plus.png) button on the left of the ‘Column Header’.
2. In the **Description** field, type the text for **Call Status**.
3. Check **Allow Retry** box if the call is busy so that the agent can retry the call.
4. Click **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png) to save the new disposition

##### **Edit Existing Disposition**

1. In the **Dispositions** tab, select the disposition that you want to edit.
2. In the text field, type the new label text so that it will be updated accordingly in the **Call Status **widget of the **Dialer **screen.
3. 3CX Surveyor supports batch edits and hence, you may edit one or more dispositions before you save them.
4. Check/ uncheck **Allow Retry** box so that you can allow/ not allow the agent to retry the call respectively.
5. Click **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png) to save the changes.

#### Lookups

Lookups define the contact sales attributes. The lookups that you create here will appear in the **Contact Attributes** widget of the **Dialer **screen. It is through these details that you know what sales transactions the contact had made with your company in the recent times and how the customer’s response towards buying your product is.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-empty-screen-1024x784.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-empty-screen.png)
*Figure 36: General Settings – Lookups scree*

##### **Add New Lookup**

1. On the **Settings** screen and in the **Lookups **tab, click Add button on the left of ‘Column Header’.
2. In the **Lookup Type** field, enter appropriate lookup type (For instance, ‘Buying Status’, ‘Class’, ‘Customer Status’, ‘Territory’ etc.)
3. In the Lookup Value field, enter the appropriate lookup value.
4. In the **Lookup Display** field, type appropriate ‘Lookup’ text that you want to display.
5. Click **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png) to save the new lookup.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> Once you create and save a lookup, you cannot edit **Lookup Type** and **Lookup Value** fields.

##### Edit Existing Lookup

1. In the **Lookups **tab, select the lookup that you want to edit.
2. In the L**ookup Display** field, edit the text.
3. Click **Save Changes ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png)**to save the changes.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> You cannot delete a lookup. However, you can make it unavailable by simply checking **Disable **box.

### Site Settings

The **Site Settings** screen enables you to customize branding settings for the application that include the following:

- Customize the gradient color of ‘Application Header’
- Customize grid color in screens that display grid data
- Customize logo on the ‘Application Header’
- Customize ‘Header Title Prefix’ on the ‘Application Header’

#### Custom Brand Settings

1. Hover over the mouse on **Settings** tab and from the drop down menu, select **Site Settings**

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Select-‘Site-Settings.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Select-‘Site-Settings.png)
*Figure 37: Select ‘Site Settings’*

#### **Customize Application Title Header – Gradient Color**

1. In the Header Colour section do the following,
   1. Select the top paint from the Top Colour color palette. 
   2. Select the bottom paint from the **Bottom Colour** color palette.
2. Click **Apply** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to Save the settings.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-header-gradient.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-header-gradient.png)
Figure 38: Header Gradient Color

#### **Customize Grid Color**

1. From the **Grid Color** palette, select the color that you want to display for the grid in screens that display grid data
2. Click **Apply**![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save your settings.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-grid-colour-1024x569.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-grid-colour.png)
Figure 39: Grid Color Palette

#### **Customize Logo**

- If you are uploading the logo for the first time then,
  1. In the **Custom Logo** section, click Chose File button to choose a logo from your device.
  2. Select the uploaded logo from the **Select Logo** dropdown list.
  3. Click **Apply** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save your changes.
- If your have uploaded the logo,
  1. Select the uploaded logo from the **Select Logo** dropdown list.
  2. Click **Apply** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg)  to save your changes.

[https://web.archive.org/web/20220814065022/https://www.voiptools.com/wp-content/uploads/2018/12/RMS33.png](https://web.archive.org/web/20220814065022/https://www.voiptools.com/wp-content/uploads/2018/12/RMS33.png)

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-Customize-logo.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-Customize-logo.png)
Figure 40: Custom Logo

#### **Customize ‘Header Title Prefix’ Text**

1. In the **Header Title** field, enter the text that you want the application to display as a ‘prefix’ for the existing title in the application header.
2. Click **Apply**![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the header title prefix.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-Header-prefix-1.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Recording-Manager-Header-prefix-1.png)
Figure 41: Custom Header Title Prefix

The final result of the page when you do all the customizations,

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-final-display-1024x327.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-final-display.png)
Figure 42: Display of Customized Brand Settings

## Import

Import screen enables you to import contacts from a CSV file into the central repository of contacts.

1. Beside the**Import File** field, click the **Browse **button to select the import file (.csv).
2. Click the **Get Fields** ![](https://voiptools.com/wp-content/uploads/2023/01/left-triangle.png) button to load the CSV column headers into the **CSV File** list box.
3. Move each column from the CSV File list box into the CSV Field list box by appropriately using buttons such that the columns in the CSV Field list box will match those of the **Contact Field** list box.
4. Select the **Update Existing Contacts box to**overwrite existing contacts.
5. Click the **Import **![](https://voiptools.com/wp-content/uploads/2023/01/down-triangle.png) button to import all the contacts from the CSV file into the central repository of contacts.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Import-Screen-1024x468.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Import-Screen.png)
*Figure 43: Import Screen*

>

## Contacts

The **Contacts **screen enables you to manage all your contacts and also record notes and services related to various contacts.

### Contact tab

The contacts screen is like a mini CRM that manages all your contacts. Here, you can search for any contact by typing appropriate data in any one of the fields in the Contact screen and click the **Search **button so that 3CX Surveyor finds the result from the database.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-contact-tab-1024x557.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-contact-tab.png)
*Figure 44: Contact – Contact tab*

#### Private Contact

- To mark a contact as private, check the **Private **box.

[![](https://voiptools.com/wp-content/uploads/2023/04/private-box-1024x557.png)](https://voiptools.com/wp-content/uploads/2023/04/private-box.png)
Figure 45: Private check box

#### Do Not Contact

You can check the **Do Not Contact** box to disble the contact permanently from the dialer if the contact is not interested to be contacted again

[![](https://voiptools.com/wp-content/uploads/2023/04/do-not-contact-box-1024x557.png)](https://voiptools.com/wp-content/uploads/2023/04/do-not-contact-box.png)
Figure 46: Do Not Contact box

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> If you mark a contact as ‘Private’ or ‘Do Not Contact’, it will never show up in the dialer.

>

#### Contact Toolbar

In the **Contacts** screen, and in the **Contact **tab, on the bottom right corner, the contact toolbar exists.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-contact-toolbar-1024x557.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-contact-toolbar.png)
Figure 47: Contact tab: Contact toolbar

| ![](https://voiptools.com/wp-content/uploads/2023/04/search.png) | **Search** | Type appropriate information anywhere in the field and click the **Search **![](https://voiptools.com/wp-content/uploads/2023/04/search.png)button. 3CX Surveyor finds the person from the database and populates the information in all the fields. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/eraser.png) | **Delete Contact** | Search for the contact that you want to delete and click the **Delete Contact **![](https://voiptools.com/wp-content/uploads/2023/01/eraser.png) button to delete the contact. |
| ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) | **Save** | Click the **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) button to save the changes you made to the contact. |
| ![](https://voiptools.com/wp-content/uploads/2023/04/wrong.png) | **Clear Contact** | Click the **Clear Contact** ![](https://voiptools.com/wp-content/uploads/2023/04/wrong.png) button to clear the contact details in the Contact tab. |

### History tab

The **History**screen allows you to record notes about various conversations your company had with a specific contact over time. You can record important information like commitments or services you provided so that when the customer calls you, you can quickly look into notes to know if you can perform something on their behalf to achieve great customer satisfaction. It provides a great way to understand your customer even before you start talking to them.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-history-tab-1024x413.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-history-tab-1024x413.png)
*Figure 48: Contacts – History tab*

>

### Qualification tab

**Contact** screen enables you to view the information about contact.[https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2019/07/Contacts-Qualification-page.png](https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2019/07/Contacts-Qualification-page.png)

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-qualifications-tab-1024x469.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-qualifications-tab.png)
*Figure 49: Contacts – Qualification tab*

>

## Campaign

A campaign is a global contact list that can have one or more sub lists within it. Here, you make a subset of selected contacts and assign them to a list called ‘sub list’, and then assign agents to that sub list so that they can have people to call for. You can create a campaign ahead of time and it becomes available as soon as the correct date arrives.

If multiple agents are working on the same campaign/list, the system ensures that each of the agents will work on different contacts.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-default-view-3-1024x306.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-default-view-3-1024x306.png)
*Figure **50**: Campaign screen*

>

### Create New Campaign

1. In the **Campaigns **screen, click the **Add ** ![](https://voiptools.com/wp-content/uploads/2023/01/Icon-BlueAddbutton.png) button that appears on the left of ‘Column Header’.
2. In the **Campaign** dialogue box, and in the **Description 1** field, enter the name of the campaign.
3. In the **Description 2** field, enter a brief description for the campaign.
4. From the **Status **dropdown list, select **Active **to activate the campaign.
5. In the **Agent Script** area, enter the notes for the campaign.
6. Click **Save** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the new campaign.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-New-campaign-988x1024.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-New-campaign.png)
*Figure 51: Create New Campaign*

>

###  Create New Campaign List

1. In the **Campaigns** screen, click ![](https://voiptools.com/wp-content/uploads/2023/01/Icon-greyrightarrow.png) **Expand **button that appears beside the campaign to which you want to add the campaign list.
2. Click the **Add **![](https://voiptools.com/wp-content/uploads/2023/01/Icon-BlueAddbutton.png) button that appears on the left of the ‘Campaign List’ column header.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-new-list-1024x472.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-new-list.png)
*Figure 52: Campaign List dialog box*

>

#### General tab

1. On the **Campaign List** dialog box, in the **General **tab and in the **List Name** field, type the name of the campaign list.
2. From the **Status **drop-down, select **Active **or **Inactive **to activate or inactivate the campaign respectively.
3. Select **Start Date** and **End Date** to specify the time for which the campaign will be valid.
4. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the new campaign list.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaign-General-tab-1024x496.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaign-General-tab.png)
*Figure 53: Campaign: General tab*

>

#### Agent Script tab

Agent Script screen enables an agent to typically note down important discussing subject or points to remember or any other verbatim while talking with the customer. Here, you can change font type, font color, add bullet points, add images and do many more that are required for you to create a script. You can prepare the ‘Agent Script’ in either **Design **or **HTML **editor.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaigns-Agent-Script-tab-1024x487.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaigns-Agent-Script-tab.png)
*Figure 54: Campaigns: Agent Script tab*

>

####  SQL Query tab

SQL Query tab enables you to filter the contacts by creating complicated SQL queries with specific criteria by using appropriate operators and conditions. The resulting contacts who meet the specified criteria will be included in the campaign. It is to these contacts that the assigned agents will perform calls.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaigns-SQL-Query-tab-1024x491.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Campaigns-SQL-Query-tab.png)
*Figure 55: Campaigns: SQL Query tab*

>

##### **Add Contacts to Campaign List**

1. In the **Campaign **screen, click **Edit Campaign List** ![](https://voiptools.com/wp-content/uploads/2023/03/edit.png)button beside the campaign for which you want to create new contact list.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-edit-list-1024x523.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-edit-list.png)
Figure 56: Edit campaign

1. In the **Campaign List** dialog box, click **SQL Query** tab.
2. On the left top corner of the screen, beside click the **Add** ![](https://voiptools.com/wp-content/uploads/2023/01/black-plus-1.png) button and then right below it, click **Company **and select appropriate value.
3. Click **Begins with **link and choose appropriate operator and then beside the link, enter a required value to retrieve the contacts as per the created search criteria. This creates complex SQL query.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-campaign-list-SQL-Query-Search-queury-builder-1024x524.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-campaign-list-SQL-Query-Search-queury-builder.png)
Figure: 57: Query Builder

1. Click **Apply**![](https://voiptools.com/wp-content/uploads/2023/03/refresh.png)to apply the search criteria you just added to your query.
2. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the contacts for the campaign list.

For example,

To search for the companies that begin with the letter "V"

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-query-builder-example.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-query-builder-example.png)
Figure 58: SQL Builder example

##### **Clear History button**

The **Clear History** ![](https://voiptools.com/wp-content/uploads/2023/01/eraser.png) button clears all the history transaction log of the campaign. This is especially useful when you want to make calls all over again to all your contacts after every regular period of time (for example, every month) irrespective of making calls in the last period of time.

#### Assign Agents tab

**Assign Agents** tab enables you to assign specific agents to a campaign list. The **Unassigned** list box displays list of all the agents that you assigned to the **Surveyor Extension Group** specified in the **Settings–General** tab. To assign agents to the campaign list, select the required agents from the **Unassigned **list box and move them to the **Assigned **list box.

1. In the **Campaign list** dialog box click **Assign Agents** tab.
2. From the **Unassigned **list box, move required agents to the **Assigned **list box to assign them to the campaign list.
3. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the agents in the campaign list.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-campaign-list-assign-agents-1024x517.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-campaign-list-assign-agents.png)
*Figure 59: Campaigns: Assign Agents*

The following table gives information on the icons used in the Assign Agent tab,

| ![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle.png) | **Assign Agent** | Lets you assign a selected agent for the campaign. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/left-triangle.png) | **Unassign Agent** | Lets you remove a selected agent from the campaign. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/double-right.png) | **Assign All** | Lets you assign all the available agents to the campaign. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/double-left.png) | **Unassign All** | Lets you remove all the assigned agents in the campaign. |

>

### Edit Campaign List

1. Click the **More Info** ![](https://voiptools.com/wp-content/uploads/2023/03/close-dropdown.png) Dropdown icon to expand the campaign.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-dropdown-icon-1-1024x306.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-dropdown-icon-1-1024x306.png)
Figure 60: More Info icon

1. Click the **Edit Campaign List** button beside the campaign list that you want to edit.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-edit-campaign-1024x354.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-edit-campaign.png)
Figure 61: Edit campaign icon

1. In the **General**, **Agent Script**, **SQL Query** and **Assign Agents** tabs, edit the required information.
2. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/01/save.jpg) to save the changes.

### Activate/ Inactivate Campaign List

1. Click the **Edit Campaign List** button beside the campaign list that you want to activate.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-edit-campaign-1024x354.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-surveyor-edit-campaign.png)
Figure 62: Edit campaign icon

1. In the **General **tab, from the **Status **drop-down, select **Active **to activate or **Inactive** to inactivate the campaign list.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-activate-or-inactivate-agent.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-activate-or-inactivate-agent.png)
Figure 63: Active/Inactivate campaign

1. Click **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the changes.

## Dialer

- As an agent, you will be able to see **Dialer**, **Contacts **and **About **screens.

- From the **Dialer** screen, an agent can select a campaign and a campaign list in order to call all the agents assigned to that campaign list.

- The **Dialer** screen displays widgets; each designed specially to inform you specific information about the contact. Once a contact is ready to be dialed, all the information related to that contact will be automatically populated in all the fields of the widgets so that you can know important information about the customer even before you call them. This feature enables you to enjoy positive call experience.

- You can move the widgets to the desired position on the screen to create your own screen layout. You can save your layout or can again reset it back to the original format.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-default-view-2-1024x390.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-default-view-2.png)
*Figure 64: Dialer Screen*

### How to Open a Widget?

1. In the **Dialer **screen, and on the toolbar, click the widget button of the widget that you want to open.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> If a widget is already open, the toolbar displays the widget button in grey.

### Various Widget Specifics

The **Dialer **screen displays various widgets and this section exemplifies some of the commonly used ones for your reference

#### Campaign Widget

1. In the **Campaign **widget, from the **Campaign **drop down, select the campaign for which you want to work.
2. From the **List **drop down, select the Campaign List so that you can start calling the agents assigned to it.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-show-campaign-2.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-show-campaign-2.png)
**Figure 65: Campaign widget**

#### Call Control Widget

1. In the **Call Control** widget, you can automatically see the contact number of the first contact in the campaign list.
2. Click any of the following buttons to do the desired function,

| ![](https://voiptools.com/wp-content/uploads/2023/01/incoming-call.jpg) | **Dial ** | lets you dial the contact number that appears in the **Contact **field. You can also dial additional phone numbers by clicking on the respective ![](https://voiptools.com/wp-content/uploads/2023/01/Icon-GreenSavebutton.png) green Check icon beside **Phone 1**/ **Phone 2**/ **Mobile**/ **FAX** icons. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/call-declined-1.jpg) | **Done ** | Lets you transfer the call. To transfer a call to another extension, you must first enter the extension number in the **Contact** field. When you press the transfer buttfdialer n, the Surveyor looks at the **Contact** field to determine where to transfer the call. It will not prompt you for the number. |
| ![](https://voiptools.com/wp-content/uploads/2023/04/search.png) | **Search ** | Lets you search for a contact. |
| ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) | **Save**  | Lets you save if you made any changes to the contact’s information. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle.png) | **Next ** | Goes to the next contact in the dialer. ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) ***NOTE:***The number beside the Next button indicates how many people are yet to be called. |

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-control.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-control.png)
*Figure 66: Call Control widget*

>

#### Call Status Widget

In order to move to the next customer, you need to disposition the call. **Call Status** widget enables you to select one of the dispositions from the available dispositions list.

1. In the **Call Status** widget, select the appropriate disposition.
2. In the **Call Control** widget, click **Save** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg). The call will be dispositioned.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-status.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-status.png)
*Figure 67: Call Status widget*

#### Contact Address Widget

**Contact Address** widget displays address details of the contact. Once the contact number of the next caller is displayed in the **Call Control** widget, the address details of the contact will be automatically populated in this widget.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-contact-address-1.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-contact-address-1.png)
*Figure 68: Contact Address widget*

#### Contact Attributes Widget

Once the contact number of the next caller is displayed in the **Call Control** widget, all the sales information related to the contact will be populated in the **Contact Attributes** widget. From here, you can know what the contact’s first order, last order, last contact details, class, status and territory are.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-contact-attributes-1024x253.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-contact-attributes.png)
*Figure 69: Contact Attributes widget*

####  Call Back Widget

**Call Back** widget enables you to schedule a call back according to the customer’s preferred timings. If you are working on a call and if the call back scheduled time arrive, the dialer waits till you have finished the call and once you click the **Next **![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle.png) button, the call will be dialed to the **Call Back** number.

1. In the **Call Back** widget, from the **Date/ Time** drop-down, select the appropriate date and time.
2. In the **Phone **field, enter the phone number to which you need to call back.
3. Once the call back has been performed successfully, check the **Done **box to know in future that the call back for the customer has been performed.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back-1024x213.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back.png)
*Figure 70: Call Back widget*

#### Call Notes Widget

**Call Notes** widget displays all the call notes recorded in the previous calls with the contact.

**Priority Notes** section (top portion of the ‘Call Notes’ widget) displays important information about the contact that an agent needs to know before making the call.

The lower portion of the **Call Notes** widget displays the notes about the agent.

1. Click ![](https://voiptools.com/wp-content/uploads/2023/01/Icon-BlueAddbutton.png) **Add** button in the ‘Column Header’ of the **Call Notes** widget.
2. Enter required notes for the contact.
3. Click **Save** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the call notes.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-notes.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-notes.png)
*Figure 71: Call Notes widget*

#### Agent Script Widget

**Agent Script** widget displays the information specific for the agent.

[![](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Agent-Script-widget.png)](https://voiptools.com/wp-content/uploads/2023/02/Screenshot-Surveyor-Agent-Script-widget.png)
*Figure 72: Agent Script widget*

>

####  Caller ID Widget

**Caller ID** widget enables you to work in sync with the ‘Caller IDs’ screen of the ‘3CX Caller ID’ application. From here, you can update Outbound Caller ID for logged-in user’s extension, revert back to agent default Caller ID, and manually update Outbound Caller ID for logged-in user’s extension. For more information, you can refer [Caller ID manual](https://web.archive.org/web/20220814064626/https://www.voiptools.com/3cx-callerid-user-guide/).

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> To view **Caller ID** widget, you need to install ‘3CX Caller ID’ application.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-caller-id.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-caller-id.png)
*Figure 73: Caller ID widget*

##### Update Outbound Caller ID for Logged-in User’s Extension

1. From the **Numbers** drop down, select the franchise whose extension you want to apply to your outbound caller ID.
2. Once applied, the system displays the successfully updated message.

##### Revert Back To Agent Default Caller ID

Reverting a CallerID for an agent will revert it back to the ‘Agent Caller ID’ (specified in the **Agents **tab). If the agent is not assigned any Caller ID, then the application takes ‘Default CallerID’ (specified in the **Settings **tab) of the extension group to which the agent belongs to.

1. Beside **Numbers** drop down, click the **Revert **![](https://voiptools.com/wp-content/uploads/2023/01/refresh.png) button.
2. Once the revert process is successful, the system displays the successfully reverted message.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> Every agent must have a default Caller ID (Agents tab) else Caller ID will not be reverted.

##### Manually Update Outbound Caller ID for Logged-in User’s Extension

1. In the **Manual Number** field, enter the desired number manually with which you want to update the ‘Outbound Caller ID’ for the logged-in user in the 3CX Console Management.’
2. Beside the Manual Number field, click the **Update **![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle.png) button to update the login extension with new manual CallerID.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> You cannot revert manual number.

#### Auto Voicemail Widget

**Auto Voicemail** widget enables you to access the ‘Play’ and ‘Send’ features in sync with the ‘Auto Voicemails’ screen of the ‘3CX Auto Voicemail’ application. **Auto Voicemail** widget enables your staff to automatically play prerecorded voice messages when connected to a customer’s voicemail box. For more information, you can refer [Auto Voicemail manual](https://web.archive.org/web/20220814064626/https://www.voiptools.com/3cx-auto-voicemail-user-guide/).

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> To view **Auto Voicemail** widget, you need to install ‘3CX Auto Voicemail’ application.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-auto-voice-mail.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-auto-voice-mail.png)
*Figure 74: Auto Voicemail widget*

You can also insert all the widgets in the dialer screen,

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-full-display-1024x498.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-full-display-1024x498.png)
Figure 75: All widgets in dialer screen

## Reports

**Reports **screen enables you to view the sales report, performance report, call report and notes report for all the campaigns in the 3CX Surveyor. As a manager, you can filter the records by entering details in any one of the column headers and export data in various formats like pdf, xls, xlsx, rtf or csv.

1. On the **Reports **menu, select the type of report that you want to view.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-reports-menu.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-reports-menu.png)
Figure 76: Reports menu

1. Click appropriate export button to export the logs in your desired format.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-export-options-1024x174.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-export-options-1024x174.png)
Figure 77: Export options

### Field Definitions

![](https://voiptools.com/wp-content/uploads/2023/01/Icon-Productmanuals-Fielddefinitions.png)

>

| **Campaign Name** | Name of the campaign |
| --- | --- |
| **Date/Time** | Date and time at which the campaign was created. Date format is ***DD/MM/YYYY.*** The time format is 24 hours clock with ***HH:MM:SS*** format. |
| **Name** | Name of the customer |
| **Phone** | Phone Number of the customer |
| **Value** | The value of sales done |
| **First** |  |
| **Last** |  |

### Sales Report

**The sales Report** screen displays the list of all the calls of all the campaigns with disposition selected as ‘Sale.’

To view the sales report follow the procedure,

1. On the menu bar hover over the **Reports**tab and select the **Sales Report** option.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-select-sales-report.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-select-sales-report.png)
Figure 78: Select sales report

1. View the sales report or export the sales report in the available formats.[https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2020/02/SVR1sale-report.png](https://web.archive.org/web/20220814064626/https://www.voiptools.com/wp-content/uploads/2020/02/SVR1sale-report.png)

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-sales-reports-1024x541.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-sales-reports.png)
Figure 79: Sales report

![](https://voiptools.com/wp-content/uploads/2023/01/Icon-Productmanuals-Fielddefinitions.png)

| **Campaign Name** | Name of the campaign |
| --- | --- |
| **Date/Time** | Date and time at which the campaign was created. Date format is ***DD/MM/YYYY.*** The time format is 24 hours clock with ***HH:MM:SS*** format. |
| **Name** | Name of the customer |
| **Phone** | Phone Number of the customer |
| **Value** | The value of sales done |
| **First** |  |
| **Last** |  |

### Performance Report

**Performance Report** screen displays performance data of an agent for a specific campaign. The record includes data such as name and login time of the agent, number of calls performed, total call time, and the name of the campaign.

To view the performance report follow the procedure,

1. On the menu bar hover over the **Reports**tab and select the **Performance Report** option.

[![](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-select-performance-report.png)](https://voiptools.com/wp-content/uploads/2023/04/screenshot-surveyor-select-performance-report.png)
Figure 80: Select Performance Report

1. View the Performance report or export the data in the available formats.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-performance-reports-1024x508.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-performance-reports-1024x508.png)
Figure 81: Performance Report

![](https://voiptools.com/wp-content/uploads/2023/01/Icon-Productmanuals-Fielddefinitions.png)

| **First** |  |
| --- | --- |
| **Last** |  |
| **Login Date/Time** |  |
| **Calls** |  |
| **Time** |  |
| **Campaign Name** |  |

>

### Call Report

**Call Report** screen displays disposition details of every call in a campaign.

To view the Call Report follow the procedure,

1. On the menu bar hover over the **Reports**tab and select the **Call Report** option.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-select-call-report.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-select-call-report.png)
Figure 82: Select Call Report

1. View the Call report or export the data in the available formats.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshots-Surveyor-caller-reports-1024x524.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshots-Surveyor-caller-reports.png)
Figure 83: Call Report

![](https://voiptools.com/wp-content/uploads/2023/01/Icon-Productmanuals-Fielddefinitions.png)

| **Customer** |  |
| --- | --- |
| Phone |  |
| Date and Time | Date and time at which the campaign was created. Date format is ***DD/MM/YYYY.*** The time format is 24 hours clock with ***HH:MM:SS*** format. |
| **Dispositions** |  |

### Call Back Report

To view the CallBack Report follow the procedure,

1. On the menu bar hover over the **Reports**tab and select the **Call Back**option.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back-report.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back-report.png)
Figure 84: Select Call Back Report

1. View the CallBack report or export the data in the available formats.

[![](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back-reports-1024x426.png)](https://voiptools.com/wp-content/uploads/2023/04/Screenshot-Surveyor-call-back-reports.png)
Figure 85: Call Back Report

![](https://voiptools.com/wp-content/uploads/2023/01/Icon-Productmanuals-Fielddefinitions.png)

| **Agent Last Name** |  |
| --- | --- |
| **Agent First Name** |  |
| **Caller** |  |
| **Name** |  |
| **Buyer** |  |
| **Contact** |  |
| **Phone** |  |
| **Complete** |  |
| **Campaign Name** |  |
| **Call Back Date** |  |

# Need Support?

You get quick answers to most of your inquiries in our online manual. If you prefer direct contact, we offer various support channels, including phone, email, live chat, and our helpful VoIPTools forums.

![](https://voiptools.com/wp-content/uploads/2023/05/24-hours-support-2.png)

## 24/7 Support Availability

Rest assured, our dedicated team is here to assist you around the clock, every day of the year. Whether you're based in the USA or India, we're ready to provide prompt responses to your technical queries.

![](https://voiptools.com/wp-content/uploads/2023/05/windows-log-event.png)

## Windows Event Log for VoIPTools Applications and Services

For troubleshooting any application errors, our Windows Event Log contains a comprehensive list of error messages, warnings, and informative notes related to all our VoIPTools applications and services. It's a valuable resource to help you pinpoint and resolve any issues you may encounter.

![](https://voiptools.com/wp-content/uploads/2023/05/forums.png)

## Join Our Forum Community

Are you looking to collaborate with other VoIPTools customers facing similar challenges? Our forum is the perfect platform to exchange ideas, solutions, and best practices. Join the conversation at: [**https://www.voiptools.com/community/**](https://voiptools.com/blog/)

![](https://voiptools.com/wp-content/uploads/2023/05/live-chat.png)

## Real-Time Live Chat Assistance

Got questions that need immediate answers? Our chat support team is available to assist you in real time. Just click on the Live Chat button located at the lower right corner of our website, and we'll acknowledge your queries right away.

![](https://voiptools.com/wp-content/uploads/2023/05/email-support.png)

## Efficient Email Support

To ensure a thorough understanding of your concerns, email us at ***support@voiptools.com***. Describe your issue in detail, and we'll get back to you within one business day with the support you need.

![](https://voiptools.com/wp-content/uploads/2023/05/phone-support.png)

## Reach Us by Phone

If you prefer to speak with a representative directly, you can reach us at +1 801-642-4655. Our attentive team is available to take your calls from 8:00 AM to 6:00 PM (Central Standard Time).

# Comprehensive support services:

![](https://voiptools.com/wp-content/uploads/2023/05/free-support.png)

## Free Support

If you've purchased our products through a VoIPTools Partner, rest assured that they provide first-level support at no additional cost. Partners have access to 100% free technical assistance and actively participate in the troubleshooting process.

VoIPTools customers enjoy access to our online manuals and receive support through emails (with responses within one business day) and live chat. However, please note that we do not provide remote server login assistance.

![](https://voiptools.com/wp-content/uploads/2023/05/paid-support.png)

## Paid Support

For a more hands-on experience, consider our "Installation Support" package. Our expert support team can log in to your servers, and install and configure all our tools. This comprehensive service includes setting up SQL Server Express and Internet Information Server if necessary. We'll work closely with you to tailor our applications to meet your requirements.

We're committed to providing top-notch support to ensure your VoIPTools experience is smooth and hassle-free. Contact us today, and let us assist you in making the most of our powerful tools!
