Task Flow to Enable Digital Channels
License Requirements
The digital channel features of Cisco SocialMiner are available in the Premium license version of Cisco Unified Contact Center Express. The feature availability in Unified CCX is based on the type of license for Cisco Unified Contact Center Express.
Install Cisco SocialMiner
SocialMiner is installed as an appliance using the Cisco Unified Operating System (Unified OS). The operating system and the SocialMiner application are installed together using a similar installation process as other Unified OS products such as Cisco Unified Communications Manager and Cisco Unified Intelligence Center.
SocialMiner operates on a VMware Virtual Machine (VM) on hardware that is running a VMware Host Server. SocialMiner currently supports installation of only a single node (as opposed to a duplexed or redundant system).
Perform the following steps to install SocialMiner:
Procedure
Step 1 |
Create a virtual machine using a VMware Open Virtual Format template. |
Step 2 |
Use the latest OVA template for the fresh installation of SocialMiner release. Go to https://software.cisco.com/download/home/270569179 and download this template. |
Step 3 |
When deploying the template, select either a large or a small deployment from the drop-down list. |
Step 4 |
Mount the SocialMiner DVD or ISO file to the virtual machine and set the virtual machine to boot from the SocialMiner DVD. The installation wizard opens. Use Tab to navigate between elements and then press the space bar or the Enter key to select the element and proceed. |
Step 5 |
Perform the media check when prompted. |
Step 6 |
Follow the instructions on the screen and select Yes or Continue. |
Step 7 |
Use the arrow keys to highlight the correct time zone and then use Tab to navigate to the OK button. Press Enter to proceed. |
Step 8 |
Provide the network information for SocialMiner . You must provide valid hostname with matching IP address. The system confirms that the hostname matches the IP address later in the installation process. |
Step 9 |
Select Yes to provide DNS Client Settings for SocialMiner . Provide DNS servers and the domain. Select OK. DNS configuration is mandatory. |
Step 10 |
Provide an Administrator ID and password. This credential is for platform (Unified OS) administration. |
Step 11 |
Provide information about your organization. This information generates the security (SSL) certificates for this server. |
Step 12 |
You must provide at least one NTP Server. Enter the NTP host address and select OK. |
Step 13 |
Provide a security password. |
Step 14 |
Provide a username and password for the SocialMiner administrator. You can import additional SocialMiner users from Active Directory after the SocialMiner installation is complete. |
Step 15 |
The confirmation window opens. You can select Back to change settings or OK to complete the installation. Installation can take up to 2 hours. The server may reboot to complete the installation steps. If you install from an ISO file and see the virtual machine message, to "Disconnect anyway (and override the lock)?", select Yes. A sign-in prompt appears on the server console. |
Step 16 |
After the installation is complete, perform the one-time setup tasks like:
|
Configure SocialMiner in Unified CCX
SocialMiner Configuration
Use the SocialMiner Configuration web page to configure Cisco SocialMiner . You must configure information only on this web page to enable the chat and email features.
Cisco Unified CCX does not support custom configuration changes on the chat and email campaigns or feeds from the SocialMiner administration page.
This option is available only with the Unified CCX Premium license package. The email feature support for Unified CCX depends on the SocialMiner version. For information about feature compatibility, see the Unified CCX Compatibility related information, located at: https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-express/products-device-support-tables-list.html.
Any configuration change using SocialMiner Administration interface is not supported.
Note |
On a high availability setup, after the Add to Cluster operation is successful, the following message is displayed: In case of HA, configure the SocialMiner on secondary node after adding to cluster in the secondary node. |
Every time you navigate to this page, the state of feeds, campaigns, and notifications rules are validated for chat and email, the connectivity to the email server is checked, and the web page shows the appropriate status. Icons are used as visual indicators to display the status of each service. Hover the cursor over the icon to display a tool tip that explains the reason for the current state. As part of validation, Unified CCX checks the following:
-
SocialMiner XMPP Service
Unified CCX checks the connectivity with the SocialMiner XMPP service. If the XMPP service is down, the following message is displayed:
SocialMiner XMPP service is not accessible. Check the logs for more details.
- SocialMiner Runtime Service
Unified CCX checks the connectivity with the SocialMiner runtime service. If the runtime service is down, the following message is displayed:
SocialMiner runtime service is not accessible. Check the logs for more details.
-
SocialMiner Tomcat Service
Unified CCX checks the connectivity with the SocialMiner Tomcat service. If the Tomcat service is down, the following message is displayed:
Unable to communicate to the SocialMiner on the IP address(Hostname) provided. Please verify whether SocialMiner is running on this IP address(Hostname) or check the network connection and make sure that SocialMiner is reachable from CCX.
-
SocialMiner Status
-
Feeds
Unified CCX validates the status of the intended chat and email feeds in SocialMiner .
-
—All the feeds are operating normally in SocialMiner .
-
—One or more feeds mismatches with SocialMiner .
-
—All the feeds are missing in SocialMiner .
-
-
Campaigns
Unified CCX validates the status of the intended chat and email campaigns in SocialMiner .
-
—All the campaigns are operating normally in SocialMiner .
-
—One or more campaigns mismatches with SocialMiner .
-
—All the campaigns are missing in SocialMiner .
-
-
Notifications
Unified CCX validates the status of the intended chat and email notifications in SocialMiner .
-
—All the notifications are operating normally in SocialMiner .
-
—One or more notifications mismatches with SocialMiner . This status icon also appears after configuration, when no chat and email contact is injected yet. The status will change to normal after successful injection of chat and email contact.
-
—All the notifications are missing in SocialMiner .
-
-
Email Server
Unified CCX checks the connectivity with the email server.
-
—Email server is operating normally.
-
Not Configured—Channel provider is not configured.
-
Not Applicable—The following are the reasons for the current state:
-
Cisco Finesse is not active.
-
Email CSQ is not configured.
-
SocialMiner version is incompatible with the Email feature.
-
-
—Unable to reach the email server.
-
-
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose CCP OR SocialMiner as applicable. The Configuration web page appears.
|
||||||||||
Step 2 |
Complete or modify the following fields for SocialMiner :
|
||||||||||
Step 3 |
Click Save to save the changes.
|
Mail Server Configuration
Use the Mail Server Configuration web page to configure the mail server. This web page is available only when Cisco Finesse is enabled on the Unified CCX node with a premium license.
Before you begin
-
Execute the commands set-service msExchangeIMAP4 -startuptype automatic, and start-service msExchangeIMAP4 on Microsoft Exchange to set the Microsoft Exchange IMAP4 service to start automatically.
-
Execute the command set-service msExchangeIMAP4BE -startuptype automatic, and execute start-service msExchangeIMAP4BE (for Microsoft Exchange 2013) on Microsoft Exchange to set the Microsoft Exchange IMAP4 Back End service to start automatically.
These commands are specific to the local Exchange server.
-
Create accounts and email addresses to be used for CSQ creation.
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose . |
||||||||||||||||||||||||||||||||||
Step 2 |
Complete or modify the following fields for the mail server:
|
||||||||||||||||||||||||||||||||||
Step 3 |
Click Update to save the changes. |
Contact Service Queues
Before you begin
-
You must create a skill before creating a CSQ. For information about creating a skill, see Skill Configuration section in the Cisco Unified Contact Center Express Administration and Operations Guide.
-
Before creating an email CSQ, you must have configured the mail server.
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose or as applicable.The Contact Service Queues (CSQs) web page opens and displays the information for existing chat and email CSQs if any. |
||||||||||||||||||||||||||||||||||||||
Step 2 |
To add a new chat or email CSQ, click the Add New icon that appears in the toolbar in the upper left corner of the window or the Add New button that appears at the bottom of the window. The Contact Service Queue Configuration web page opens. |
||||||||||||||||||||||||||||||||||||||
Step 3 |
Specify the following fields:
|
||||||||||||||||||||||||||||||||||||||
Step 4 |
Click Next. The Skill Association for CSQ area opens with the newly assigned CSQ name.
|
||||||||||||||||||||||||||||||||||||||
Step 5 |
From the Available Skills list, choose the skill that you want to associate with the CSQ by clicking it. To choose more than one skill, press the Ctrl key and click the skills that you want to associate with the CSQ. |
||||||||||||||||||||||||||||||||||||||
Step 6 |
Click Add. The chosen skill and the minimum competence level for that skill are displayed in the right pane under the heading Selected.
|
||||||||||||||||||||||||||||||||||||||
Step 7 |
Specify a minimum competence level for the skill assigned to the CSQ. |
||||||||||||||||||||||||||||||||||||||
Step 8 |
To view the associated resources, click Show Resources. |
||||||||||||||||||||||||||||||||||||||
Step 9 |
Click Save to save the changes for the CSQ. The newly added CSQ appears in the List of CSQs.
You can sort the CSQs by title by clicking the CSQ Name header and by type by clicking the CSQ Type header. |
||||||||||||||||||||||||||||||||||||||
Step 10 |
To view the printable report and associated resources, click the CSQ for which you want to view the report and the associated resources and then click Open Printable Report.
|
Predefined Responses
You can add a maximum of ten chat predefined responses. These predefined responses are available to all the agents in the Manage Chats Gadget on the Finesse Agent Desktop. Use the Predefined Responses page to configure and manage chat predefined responses. To access the predefined responses, choose .
Note |
Predefined responses are not available in the Cisco Agent Desktop. They are only available with the Finesse Agent Desktop. |
Predefined Responses
Using this web page, you can add, modify, and delete predefined responses.
You can add a maximum of 500 chat and email predefined responses in total.
Note |
To modify an existing predefined response, click the Title header for the predefined response that you want to modify. To delete an existing predefined response, click the Delete icon for the predefined response that you want to delete. |
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose .The Predefined Responses web page opens, displaying the information for existing responses, if any. |
||||||||||||||||
Step 2 |
Click the Add New icon that is displayed in the toolbar in the upper left corner of the window or the Add New button that is displayed at the bottom of the window to create a new response. The Predefined Response Configuration web page opens. |
||||||||||||||||
Step 3 |
Specify the following information:
|
||||||||||||||||
Step 4 |
Click Save. The newly added predefined response appears with the assigned tags in the List of Predefined Responses. You can sort the predefined responses by title by clicking the Title header and by type by clicking the Type header. |
Wrap-Up Reasons
To access the Wrap-Up Reasons, choose
.Use the Wrap-Up Reasons page to configure and manage Wrap-Up categories and reasons for chat and email Contact Service Queues (CSQs). Use the Ellipsis (...) to view all the Wrap-Up Reasons that are added for each Wrap-Up category.
Wrap-Up Reasons
Using this web page, you can add, modify, and delete the Wrap-Up Reasons.
You can add a maximum of 25 Wrap-Up categories. If you exceed the maximum number of categories, the Add New button is disabled.
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose . |
||||||||||
Step 2 |
Click the Add New icon or the Add New button that is displayed in the toolbar in the upper left corner of the window. The Wrap-Up Reasons web page opens. |
||||||||||
Step 3 |
Specify the following information:
|
||||||||||
Step 4 |
Click Save. The newly added Wrap-Up category appears with the assigned tags in the List of Wrap-Up Reasons.
|
Email Signatures
To access the email signatures, choose
.Email Signature Configuration
Using this web page, you can add, modify, and delete email signatures.
Note |
To modify an existing email signature, click the Title header for the email signature that you want to modify. To delete an existing email signature, click the Delete icon for the email signature that you want to delete. |
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose .The Email Signature web page opens, displaying the list of existing email signatures that are configured, if any. |
||||||||||||||
Step 2 |
Click the Add New icon that is displayed in the toolbar in the upper left corner of the window or the Add New button that is displayed at the bottom of the window to create a new email signature. The Email Signature Configuration web page opens. |
||||||||||||||
Step 3 |
Specify the following information:
|
||||||||||||||
Step 4 |
Click Save. The newly added email signature appears with the assigned tags in the List of Email Signatures. You can sort the email signatures by title by clicking the Title header and by type by clicking the Type header. |
Channel Parameters
Use the Channel Parameters web page to configure channel parameters.
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose OR as applicable.The Channel Parameters Configuration web page opens. |
||||||||||||||||||||||||||||||||
Step 2 |
Use this web page to specify or modify the following fields for channel parameters:
|
||||||||||||||||||||||||||||||||
Step 3 |
Click Save to save the changes for the channel parameters.
|
Chat Widgets
Use the Chat Widgets section to configure chat widgets and generate HTML code that can be hosted on the customer website. You can configure and manage the following types of chat widgets:
-
Classic Chat
-
Bubble Chat
To access the Chat Widgets page, choose .
Chat Widgets Page
The Chat Widgets page lists the following information and options for each chat widget:
Field |
Description |
||
---|---|---|---|
Name |
Name of the chat widget. |
||
Description |
A brief description. |
||
Widget Type |
Configured as a Classic Chat or a Bubble Chat. |
||
Post Chat Rating |
Whether post chat rating is available for the chat.
|
||
Code |
Option to generate the web form code for the configured chat widget. |
||
Delete |
Option to delete the chat widget. |
Chat Widget Configuration
You can add, modify, and delete chat widgets. You can schedule business hours in the chat widget for week days, custom business days, and holidays. You can also configure an off hours message.
Note |
|
You can configure or modify Classic Chat and Bubble Chat widgets.
Bubble Chat Widget
Procedure
Step 1 |
From the Unified CCX Administration menu bar, choose . The Chat Widgets web page opens, displaying the information for existing chat widgets.
|
|||||||||||||||||||||||||||||||
Step 2 |
Click the Add New icon or the Add New button. The Bubble Chat Configuration web page opens. The administrator can configure the messages and labels in any language. |
|||||||||||||||||||||||||||||||
Step 3 |
In the Widget Details area, specify the following information:
|
|||||||||||||||||||||||||||||||
Step 4 |
Click Next. |
|||||||||||||||||||||||||||||||
Step 5 |
Specify the following information:
|
|||||||||||||||||||||||||||||||
Step 6 |
Click Next. |
|||||||||||||||||||||||||||||||
Step 7 |
Specify the following information:
|
|||||||||||||||||||||||||||||||
Step 8 |
Click Next. |
|||||||||||||||||||||||||||||||
Step 9 |
In the User Form Fields area, specify the following information:
|
|||||||||||||||||||||||||||||||
Step 10 |
In the Add problem Statement CSQ mapping area, specify the following information:
To add more problem statements and associate them with a chat CSQ, click Add More. Click the delete icon for a problem statement to delete that problem statement. |
|||||||||||||||||||||||||||||||
Step 11 |
Click Next. The Chat Messages area appears. |
|||||||||||||||||||||||||||||||
Step 12 |
Specify the following information:
|
|||||||||||||||||||||||||||||||
Step 13 |
Click Next. The Service Hours page appears. |
|||||||||||||||||||||||||||||||
Step 14 |
In Service Hours area, select one of the following options to configure the business hours.
|
|||||||||||||||||||||||||||||||
Step 15 |
Select the desired calendar from the drop-down list and click the View link to preview the calendar details such as Business Hours, Custom Business Days, and Holidays. |
|||||||||||||||||||||||||||||||
Step 16 |
In the Messages area, specifiy the following: |
Field | Description |
---|---|
Holiday |
Message displayed on the bubble chat widget to inform the customer during a holiday. |
Off Hours |
Message displayed on the bubble chat widget to inform the customer during non-working hours. |
Label |
Heading text displayed on the bubble chat widget to inform the customer for the business hours details. |
Step 17 |
In the Label for Days of Week area, specify a label for each day of the week. |
||
Step 18 |
Click Finish.
|
||
Step 19 |
Click Save Code to File to save the generated code. Click Back to Chat Widgets to go to the main Chat Widgets page.
|
Teams
Choose
from the Unified CCXAdministration menu bar to access this configuration area.Note |
The team configuration for chat is the same as it is for voice. |
Change the Desktop Layout
Procedure
Step 1 |
Sign in to Cisco Finesse Administration Console. |
||
Step 2 |
In the Desktop Layout tab, you can define the layout of the Finesse desktop . |
||
Step 3 |
In the Finesse Layout XML area, make changes to the XML as required to include the new gadgets. |
||
Step 4 |
Click Save. Finesse validates the XML file to ensure that it is a valid XML syntax and confirms to the Finesse schema.
|
Configuration of Proxy Based on Deployment of SocialMiner
Procedure
Step 1 |
Sign in to Cisco Unified Contact Center Express Administration. |
||
Step 2 |
Navigate to System Menu > System Parameters to modify the fields in Proxy Parameters.
|
Certificate Management
Procedure
Step 1 |
Sign in to Cisco Unified OS Administration using your administrator password. |
Step 2 |
Navigate to Security > Certificate Management menu. |
Step 3 |
You can use the Find controls to filter the certificate list. |
Step 4 |
Click the file name of the certificate. The Certificate Configuration window appears and perform the necessary actions. |