From Bright Pattern Documentation
Jump to: navigation, search
(Created page with "<translate>= How to Display Searchable Call List Columns in Activity Forms = For call centers that conduct Contact-center-administrator-guide/ServicesandCampaignsOverview|ca...")
 
Line 1: Line 1:
 
<translate>= How to Display Searchable Call List Columns in Activity Forms =
 
<translate>= How to Display Searchable Call List Columns in Activity Forms =
For call centers that conduct [[Contact-center-administrator-guide/ServicesandCampaignsOverview|calling campaigns]], it is often desirable to display some of the data from [[contact-center-administrator-guide/Lists|calling list records]] in the agents’ [[Scenario-builder-reference-guide/WebScreenPop|Web Screen Pop]] [[Contact-center-administrator-guide/ActivityForms|activity forms]].  
+
For call centers that conduct [[Contact-center-administrator-guide/ServicesandCampaignsOverview|calling campaigns]], it is often desirable to display some of the data from [[contact-center-administrator-guide/Lists|calling list records]] in the agents’ [[Contact-center-administrator-guide/ActivityTab#Enable_screenpop_activity_form|screenpop activity form]]. In this article, you will learn how to display searchable calling list columns in activity forms in Agent Desktop
  
In this article, you will learn how to display searchable calling list columns in [[Scenario-builder-reference-guide/WebScreenPop|Web Screen Pop]] [[Contact-center-administrator-guide/ActivityForms|activity forms]] in Agent Desktop
 
  
 +
[[File:01-Calling-List-Results-Agent-Desktop-53.png|800px|thumb|center|Searchable call list records in Agent Desktop]]
  
[[File:01-Calling-List-Results-Agent-Desktop-53.png|800px|thumb|center|List records in Agent Desktop]]
 
  
 +
== Prerequisites ==
 +
Note that you should have familiarity with configuring forms. For more information, see the ''Form Builder Guide'', section XXX.
  
 
== Procedure ==
 
== Procedure ==
 
=== Step 1: Create a Call List with Searchable Fields ===
 
=== Step 1: Create a Call List with Searchable Fields ===
To begin, you will need to create and upload a calling list in section [[Contact-center-administrator-guide/Lists#List_Import|Lists]]. In the list import wizard, Fields screen, list columns must be marked as [[Contact-center-administrator-guide/Lists#Fields_screen|searchable]]. Note that call list fields cannot be marked as searchable after they have been uploaded, so it is very important not to miss this step!
+
To begin, you will need to create and upload a calling list in section [[Contact-center-administrator-guide/Lists#List_Import|Lists]]. In the list import wizard, Fields screen, list columns must be marked as [[Contact-center-administrator-guide/Lists#Fields_screen|searchable]]. '''Note''': Call list fields cannot be marked as searchable after they have been uploaded, so it is very important not to miss this step!
  
  
Line 18: Line 19:
 
=== Step 2: Connect the Call List to a Campaign ===
 
=== Step 2: Connect the Call List to a Campaign ===
 
After creating your call list, you will need to associate it with a [[Contact-center-administrator-guide/ServicesandCampaignsOverview|campaign]]. This can be done in section Lists by clicking '''add''' in the ''Campaigns'' setting.
 
After creating your call list, you will need to associate it with a [[Contact-center-administrator-guide/ServicesandCampaignsOverview|campaign]]. This can be done in section Lists by clicking '''add''' in the ''Campaigns'' setting.
 +
 +
 +
[[File:Calling-List-Connect-to-a-Campaign-53.PNG|650px|thumb|center|A call list connected to a campaign]]
 +
  
 
=== Step 3: Create Custom Activity History Fields ===
 
=== Step 3: Create Custom Activity History Fields ===
Next, you will need to create custom Activity History fields. This is done in section [[Contact-center-administrator-guide/CustomFields#Activity_History|Custom Fields > Activity History]]. In configuring this your custom fields, make sure to mark them as [[Contact-center-administrator-guide/CustomFields#Searchable_4|searchable]].
+
Next, you will need to create custom Activity History fields. This is done in section [[Contact-center-administrator-guide/CustomFields#Activity_History|Custom Fields > Activity History]]. '''Note''': When configuring your custom fields, make sure to mark them as [[Contact-center-administrator-guide/CustomFields#Searchable_4|searchable]], otherwise they will not show up in a search.
  
  
Line 26: Line 31:
  
  
=== Step 4: Create a Form with the Custom Activity History Fields ===
+
=== Step 4: Create an Activity Form Containing the Custom Activity History Fields ===
4. Add the custom activity fields to a form in a Data Field (Activity History)
+
Next, you will need to create an [[Contact-center-administrator-guide/ActivityForms|activity form]] that includes the custom Activity History fields. To do this, add a control to a form that contains the  [[Form-builder-reference-guide/Text#Data_field|data field]] configuration option (e.g., [[Form-builder-reference-guide/Text|text]], [[Form-builder-reference-guide/PhoneNumber|phone number]], [[Form-builder-reference-guide/Checkbox|checkbox]], etc.). From the data field, you can select the custom Activity History field; taking this action maps the custom Activity History fields to the activity form fields the agents will work with.
  
  
Line 34: Line 39:
  
 
=== Step 5: Define Search Grid Columns ===
 
=== Step 5: Define Search Grid Columns ===
8. Finally, back in Forms > Activity > "Search grid columns," you can add the form field with the associated custom field content
+
Back in section [[Contact-center-administrator-guide/ActivityForms|Forms > Activity]], you will need to configure [[Contact-center-administrator-guide/ActivityForms#Search_grid_columns|"Search grid columns"]]; this setting is where you define what activity form fields are searchable when the activity form pops. Additionally, you may choose how the search results are displayed (e.g., ascending, descending, etc.).
  
  
Line 40: Line 45:
  
  
=== Step 6: Map the Custom Activity History Fields to the Call List Fields ===
+
=== Step 6: Enable Screenpop for the Activity Form ===
5. Go back to the blended campaign > Activity Tab
+
In section [[Contact-center-administrator-guide/ActivityTab|Services & Campaigns > Activity tab]], you will need to configure the setting [[Contact-center-administrator-guide/ActivityTab#Enable_screenpop_activity_form|"Enable screenpop activity form"]]. Click the '''add/edit''' button to select the activity form you created. This setting allows the form you created to pop to the agent during an interaction.
6. Edit the "Pre-fill activity history custom fields from the following lists"
 
7. From here, you will have the option to associate the custom field with the list field
 
 
 
 
 
[[File:Pre-Fill-Activity-History-Custom-Fields-From_List-53.PNG|650px|thumb|center|Map the form fields to the call list fields]]
 
 
 
 
 
 
 
1. Let's say you create a custom form with custom fields.
 
2. Form is assigned to a blended campaign
 
3. form fields are associated with the list columns
 
4. both form fields and list columns are set to be searchable
 
5. The form fields can be text for example and have to be associated with list columns in campaign settings.
 
 
 
7. You would need to configure the mapping between activity history custom fields and the list columns.
 
8. Please also make sure list fields are searchable, this can be configured while importing the list.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  
  
 +
[[File:06-Enable-Screenpop-Form-53.PNG|650px|thumb|center|Enable screenpop for the activity form]]
  
  
 +
=== Step 7: Map the Custom Activity History Fields to the Call List Fields ===
 +
The final step in the procedure is the most important: connect the call list fields to the custom Activity History fields. Also located in section [[Contact-center-administrator-guide/ActivityTab|Services & Campaigns > Activity tab]], you will configure the setting [[Contact-center-administrator-guide/ActivityTab#Pre-fill_form_fields_from_the_following_lists|"Pre-fill activity history custom fields from the following lists"]]. Clicking the '''Edit''' button opens a menu where you can map the call list columns to the custom Activity History fields.
  
  
 +
[[File:Pre-Fill-Activity-History-Custom-Fields-From_List-53.PNG|650px|thumb|center|Map the form fields to the call list fields]]
  
  

Revision as of 22:35, 18 December 2018

• 5.19 • 5.3 • 5.8

<translate>= How to Display Searchable Call List Columns in Activity Forms = For call centers that conduct calling campaigns, it is often desirable to display some of the data from calling list records in the agents’ screenpop activity form. In this article, you will learn how to display searchable calling list columns in activity forms in Agent Desktop


Searchable call list records in Agent Desktop


Prerequisites

Note that you should have familiarity with configuring forms. For more information, see the Form Builder Guide, section XXX.

Procedure

Step 1: Create a Call List with Searchable Fields

To begin, you will need to create and upload a calling list in section Lists. In the list import wizard, Fields screen, list columns must be marked as searchable. Note: Call list fields cannot be marked as searchable after they have been uploaded, so it is very important not to miss this step!


Mark the appropriate fields as "Searchable"


Step 2: Connect the Call List to a Campaign

After creating your call list, you will need to associate it with a campaign. This can be done in section Lists by clicking add in the Campaigns setting.


A call list connected to a campaign


Step 3: Create Custom Activity History Fields

Next, you will need to create custom Activity History fields. This is done in section Custom Fields > Activity History. Note: When configuring your custom fields, make sure to mark them as searchable, otherwise they will not show up in a search.


Create custom Activity History fields


Step 4: Create an Activity Form Containing the Custom Activity History Fields

Next, you will need to create an activity form that includes the custom Activity History fields. To do this, add a control to a form that contains the data field configuration option (e.g., text, phone number, checkbox, etc.). From the data field, you can select the custom Activity History field; taking this action maps the custom Activity History fields to the activity form fields the agents will work with.


Add the custom Activity History fields to the form


Step 5: Define Search Grid Columns

Back in section Forms > Activity, you will need to configure "Search grid columns"; this setting is where you define what activity form fields are searchable when the activity form pops. Additionally, you may choose how the search results are displayed (e.g., ascending, descending, etc.).


Configuring "Search grid columns"


Step 6: Enable Screenpop for the Activity Form

In section Services & Campaigns > Activity tab, you will need to configure the setting "Enable screenpop activity form". Click the add/edit button to select the activity form you created. This setting allows the form you created to pop to the agent during an interaction.


Enable screenpop for the activity form


Step 7: Map the Custom Activity History Fields to the Call List Fields

The final step in the procedure is the most important: connect the call list fields to the custom Activity History fields. Also located in section Services & Campaigns > Activity tab, you will configure the setting "Pre-fill activity history custom fields from the following lists". Clicking the Edit button opens a menu where you can map the call list columns to the custom Activity History fields.


Map the form fields to the call list fields





</translate>

< Previous | Next >