Voice

Home 

Ivanti Voice/GoldMine Configuration

This topic describes the Ivanti Voice/GoldMine configuration process for both GoldMine Corporate Edition (CE) and GoldMine Premium Edition (PE). For GoldMine product-specific information, refer to the documentation accompanying the GoldMine product. Administrators must have system administrator-level knowledge of the Ivanti GoldMine and Ivanti Voice products.

Install GoldMine before installing Ivanti Voice. The GoldMine installer overwrites Ivanti Voice data, resulting in irrevocable data loss.

The Ivanti Voice/GoldMine configuration uses the following GoldMine database tables.

Table

Description

CONTACT1

Primary contact information including:

Account Number (ACCOUNTNO)

Record ID (RECID)

Name (CONTACT)

Phone numbers (PHONE1, PHONE2, PHONE3)

Fax number (FAX)

CONTACT2

Additional contact information including:

Fields for user defined keys (USERDEF01,...,USERDEF10)

The last the day of customer contact (LASTCONTON)

The next planned action (NEXTACTION)

The date the next action is planned (ACTIONON)

CONTHIST

Records of historical data including:

User ID (USERID)

Result code (RESULTCODE)

Activity type (ACTVCODE)

Units of forecasted sale (UNITS)

ID of the linked account (LINKACCT)

Additional contact data fields

CONTSUPP

Records of additional contact information (such as referrals and profiles) including:

Record type (RECTYPE)

Referenced contact (CONTSUPREF)

Fields for referenced contact data such as address, phone number, etc.

The Ivanti Voice/GoldMine configuration consists of server and client installation. The server configuration enables a voice application to:

Question callers.

Search and update the GoldMine database (including call history records) using caller input.

Configure a screenpop to display to the agent that receives the call.

The client configuration lets the Ivanti Voice Agent Dashboard communicate with GoldMine to perform a variety of tasks including:

Display screenpops for inbound calls.

Transfer the current Contact Info Window screenpop to another Agent Dashboard when the agent clicks the Send Screen button.

Update the GoldMine database with input from the agent.

Ivanti Voice/GoldMine Configuration

The following procedures describe two installation options:

Same Computer Installation: Servers, Clients - The Ivanti Voice and GoldMine servers can be installed on one computer with the clients installed a separate computer.

Separate Computer Installation: Server/Client, Server/Client - The Ivanti Voice server/GoldMine client can be installed on one computer with the GoldMine server/Ivanti Voice client installed on a separate computer.

Then you can create a Taskbar in GoldMine containing buttons that control Ivanti Voice Agent Dashboard functionality.

Same Computer Installation: Servers, Clients

In this configuration the Ivanti Voice and GoldMine servers are installed together on one computer, and the Ivanti Voice and GoldMine clients are installed on a separate computer.

Install GoldMine before installing Ivanti Voice. The GoldMine installer overwrites Ivanti Voice data, resulting in irrevocable data loss.

To Install Ivanti Voice and Goldmine:

1.Install GoldMine. Refer to the GoldMine Installation Guide for information.

2.Close the GoldMine application.

3.Install Ivanti Voice as described in the Ivanti Voice Administrator Guide.

4.Restart the computer.

5.Configure Ivanti Voice to connect with the GoldMine database:

  1. Open Management Portal > System Configuration > Contact Center Server > Integrations. The Integrations page opens.
  2. Click the GoldMine tab.
  3. Select the Enable check box. Click the Update button.

At this point, do not click the Commit Changes button or you will see errors in the Log, since the GoldMine connection has not yet been configured.

  1. In the Name field, enter the name of the ODBC connection to your GoldMine database.
  2. In the Description field, enter a description of the database connection, if desired.
  3. Click the Add button.
  4. Click the name of the connection, which now appears as a link. The connection settings appear.
  5. Configure the connection settings:

System Folder - Type the location of the GoldMine installation folder.

GoldMine Folder and Common Folder - Type the alias for accessing the database. For example, to access SQL Server, an alias of GoldMine might be configured. The string to access this would be MSSQL: GoldMine: dbo: (where GoldMine is the database name).

GM User Name - Type the GoldMine user name.

GM Password - Type the GoldMine password.

SQL User Name - Type the GoldMine database user name.

SQL Password - Type the GoldMine database password.

  1. Click the Commit Changes button.

Separate Computer Installation: Server/Client, Server/Client

In this configuration the GoldMine server and the Ivanti Voice client are installed on one computer, and the Ivanti Voice server and the GoldMine client are installed on a separate computer. Both computers must be members of the same Windows domain.

To Install Ivanti Voice and Goldmine:

1.Install the GoldMine server. Refer to the GoldMine Installation Guide for information.

2.Install the Ivanti Voice client on the same computer as the GoldMine server.

3.Configure network sharing for the GoldMine server system directory (<install_dir>/Goldmine/Goldmine) on the GoldMine server host computer, making sure you grant full sharing rights and NTFS permissions to the computer account on which you plan to install the Ivanti Voice server:

  1. On the GoldMine server host computer, right-click the <install_dir>/Goldmine/Goldmine folder and select Properties. The GoldMine Properties dialog box opens.
  2. Click the Sharing tab, then select the Share this folder option.
  3. Click the Permissions button. The Permissions for GoldMine dialog box opens.
  4. Click the Add button. The Select Users, Computers, or Groups dialog box opens.
  5. Click the Object Types button. The Object Types dialog box opens.
  6. Select the Computers check box, then click OK to return to the Select Users, Computers, or Groups dialog box.
  7. In the Enter the object names to select field, type the name of the computer on which you plan to install the Ivanti Voice server, then click the Check Names button. The appropriate name of the Ivanti Voice server target host computer displays.
  8. Click OK to return to the Permissions for GoldMine dialog box.
  9. Click the Apply button, then click OK to return to the GoldMine Properties dialog box.
  10. Click the Security tab, then click the Add button. The Select Users, Computers, or Groups dialog box opens.
  11. Click the Object Types button. The Object Types dialog box opens.
  12. Select the Computers check box, then click OK to return to the Select Users, Computers, or Groups dialog box.
  13. In the Enter the object names to select field, type the name of the computer on which you plan to install the Ivanti Voice server, then click the Check Names button. The appropriate name of the Ivanti Voice server target host computer displays.
  14. Click OK to return to the Security tab.
  15. Click Apply, then click OK.
  16. Repeat steps 3 through 17 for the Ivanti Voice client.

4.Install the Ivanti Voice server on a different computer.

5.On Ivanti Voice server computer, map the shared GoldMine directory as the network drive by creating a script to map the drive on system startup.

  1. Start the Microsoft Management Console: select Start > Run. The Run dialog box opens. Type mmc in the Open field, then click OK.
  2. In the Microsoft Management Console, press Ctrl+M or click File > Add/Remove Snap-in.
  3. Click the Add button.
  4. Select the Group Policy Object Editor snap-in and click the Add button.
  5. Click Finish in the next dialog box.
  6. Click Close, then click OK.
  7. Create a new text file map.bat in the C:\Windows\System32\GroupPolicy\Machine\Scripts\Startup folder.

GroupPolicy is often a hidden folder, so enable viewing of hidden folders in Windows Explorer (Tools>Folder Options>View tab). If the Scripts and Startup folders are missing, create them before proceeding.

  1. Use Notepad to edit the map.bat file, adding two lines:

net use q: /delete

net use q: \\GM_host_machine\share \ (e.g.: net use q:\\ipcc-nlb2\goldmine)

The letter q is a placeholder for any unused drive letter you choose to use.

  1. Expand the tree in the left pane, then select Scripts (Startup/Shutdown).
  2. Double-click the Startup script in the right pane.
  3. Click Add, then click Browse.
  4. Double-click the map.bat file created earlier.
  5. Click Apply, then OK. Close the Management Console without saving the console settings.
  6. Reboot the Ivanti Voice server computer, and then verify the drive is mapped.

The drive may appear as a disconnected network drive in the My Computer folder.

6.Install the GoldMine client on the same computer on which the Ivanti Voice server was installed. In the installation wizard, when the GoldMine Shared Directory dialog box opens, specify the path to the GoldMine server location: \\GoldMine_Host_Machine\GoldMine. Click Next, then continue installing the GoldMine client, in accordance with the GoldMine installation procedure.

Create Agent Dashboard Taskbar in GoldMine PE

GoldMine PE users can create a Taskbar containing buttons that control Ivanti Voice Agent Dashboard functionality such as indicating Go Ready or Not Ready, answering calls, hanging up calls, etc.

Open the Agent Dashboard and verify the default connector is specified (VPCC.GenericConnector.1) in the Dashboard Options dialog box. Refer to Ivanti Voice Configuration with other Ivanti Products for details.

To Create an Agent Dashboard Taskbar:

1.On the GoldMine PE Taskbar, click Customize.

2.Right-click the Taskbar and select Add New Group.

3.Name the group Agent, then click OK.

4.Set the properties for each of the Agent Dashboard functions:

Go Ready

  1. Right-click the Agent group and select Add New Item. The Taskbar Group Item Selection dialog box opens.
  2. In the Item Type field, select External Application.
  3. In the Caption field, type Go Ready.
  4. In the Application field, type (or browse to) C:\Windows\System32\wscript.exe.
  5. When you browse to the wscript.exe file, it automatically populates the Start Directory field with the setting C:\Windows\System32. You must change this path to: C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice.
  6. In the Command Line field, type set-ready-dashboard.js.
  7. In the Icon File field, type or browse to C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice\Ready.ico (the icon was installed with Ivanti Voice).
  8. Click OK.

Go Not Ready

  1. Right-click the Agent group and select Add New Item. The Taskbar Group Item Selection dialog box opens.
  2. In the Item Type field, select External Application.
  3. In the Caption field, type Go Not Ready.
  4. In the Application field, type (or browse to) C:\Windows\System32\wscript.exe.
  5. When you browse to the wscript.exe file, it automatically populates the Start Directory field with the setting C:\Windows\System32. You must change this path to: C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice.
  6. In the Command Line field, type set-not-ready-dashboard.js.
  7. In the Icon File field, type or browse to C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice\NotReady.ico (the icon was installed with Ivanti Voice).
  8. Click OK.

Answer

  1. Right-click the Agent group and select Add New Item. The Taskbar Group Item Selection dialog box opens.
  2. In the Item Type field, select External Application.
  3. In the Caption field, type Answer.
  4. In the Application field, type (or browse to) C:\Windows\System32\wscript.exe.
  5. When you browse to the wscript.exe file, it automatically populates the Start Directory field with the setting C:\Windows\System32. You must change this path to: C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice.
  6. In the Command Line field, type answer-dashboard.js.
  7. In the Icon File field, type or browse to C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice\answer.ico (the icon was installed with Ivanti Voice).
  8. Click OK.

Hang Up

  1. Right-click the Agent group and select Add New Item. The Taskbar Group Item Selection dialog box opens.
  2. In the Item Type field, select External Application.
  3. In the Caption field, type Hang Up.
  4. In the Application field, type (or browse to) C:\Windows\System32\wscript.exe.
  5. When you browse to the wscript.exe file, it automatically populates the Start Directory field with the setting C:\Windows\System32. You must change this path to: C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice.
  6. In the Command Line field, type hangup-dashboard.js.
  7. In the Icon File field, type or browse to C:\Program Files\Ivanti\IP Communications Management\scripts\HEATVoice\hangup.ico (the icon was installed with Ivanti Voice).
  8. Click OK.

Start Sales Scripts

  1. Right-click the Agent group and select Add New Item. The Taskbar Group Item Selection dialog box opens.
  2. In the Item Type field, select Main Menu Action.
  3. In the tree, open Go To > Sales Tools, then click OK. The Sales Scripts icon is automatically selected.

Voice Applications

The Ivanti Voice Application Builder contains the following blocks specifically designed for creating voice applications for the Ivanti Voice/GoldMine configuration, utilizing the GoldMine database:

GoldMine Auto-Complete Activity Block - Configures actions and corresponding notes to post to the contact record and History tab.

GoldMine Auto-Schedule Activity Block - Configures the application to post actions and corresponding notes to the contact record Pending Activity tab as scheduled.

GoldMine Search Block - Searches the GoldMine database for contact records, typically using a contact phone or account number as a search key. The result of search is stored as the record ID value. Call properties can define the values of the search keys, and store the values of fields returned.

GoldMine Screenpop Block - Governs the GoldMine screenpop action when a call is routed to an agent.

GoldMine Update Block - Updates fields in the GoldMine database.

For information about copying, then editing (Ivanti does not recommend directly editing the sample applications) the GoldMineDemo voice application (described below) or creating a new application, refer to Voice Application Design.

GoldMineDemo Sample Voice Application

The GoldMineDemo voice application demonstrates how to identify a contact using the contact’s default phone number (PHONE1 field) and account number.

To Use the Demo Voice Application:

1.The GoldMine Screenpop block is configured to open a new contact window (the Incoming call action value is set to Open). The Open Search Center option is selected for callers Ivanti Voice does not identify as contacts.

2.The GoldMine Search block searches for the ANI. If the ANI is not found in the database, the voice application prompts the caller to enter a default phone number, and the GoldMine Search block searches the database for the number entered.

3.If the search is successful, the agent who receives the call also sees the screenpop configured in step 1.

4.When the call is complete, the voice application updates the GoldMine History database using GoldMine Auto-Complete Activity block.

Ivanti Voice/GoldMine Call Scenario

The client and Agent Dashboard configurations enable the following call scenario:

  1. Ivanti Voice connects a caller to the GoldMine voice application. The voice application collects caller identification information either automatically using the ANI, or by prompting the caller to input identifying data such as a phone number, account number, or other types of data the GoldMine database stores in the CONTACT1, CONTACT2, and CONTSUPP tables.
  2. The voice application accesses the GoldMine application and queries the GoldMine database for the caller’s record using the identification information. The GoldMine application returns the caller’s record to the voice application.
  3. The voice application attaches the record to the interaction, prepares a screenpop using data in the record, and places the interaction in a queue that contains GoldMine calls (if you are using the GoldMineDemo application, this queue is the GoldMine Demo Queue).
  4. When Ivanti Voice routes the interaction to an agent, the connector on the agent’s workstation requests data from the GoldMine database to populate the screenpop.

You can also configure the voice application to let the agent try to find the contact information manually using the GoldMine Search Center; however, even if the search is successful, the Agent Dashboard does not update the GoldMine database history fields automatically.

  1. After the interaction is complete, the voice application updates the GoldMine database using the GoldMine Auto-Complete Activity block.

Was this article useful?