Chat Configuration
The administrator has to configure the following settings for the chat feature to work.
•Global Constant - In the Configuration module, under Global Constants, set the ChatEnabled field as True.
•User role - To make the chat icon 
available for a user, the administrator should enable chat for the user role.
To enable the chat feature for a user role:
| a. | Log in to Neurons for ITSM with the Administrator user role. |
| b. | From the Configuration console, select Configure > Roles and Permissions. |
| c. | Select the role for which you want to enable the chat feature. |
| d. | Ensure the Overwrite default branding options with the options listed below check box is selected. |
| e. | Select the Enable Chat as Analyst check box. |
•If you select the Overwrite default branding options with the options listed below check box, all check boxes under Branding Options will be disabled. Ensure to select them as needed.
• Chat requests to the Service Desk team get routed using the Round Robin algorithm based on the Service Desk Analyst's login state.
Allowing Service Desk Analyst to end the chat
A Service Desk Analyst can end the chat if there is no response from the end user after the first session expiry message has been sent.
For this to work - from Configuration console > Build > Global Constants, set the EndChatSessionByAnalysts option as True. By default, this option is set as False.
Configuring Chat
The chat configuration settings are pre-defined, however, you can change the settings as need be. There are four business objects - Chat Configuration, Chat Configuration Header, Chat Configuration Message, and Chat Configuration Text using which you can configure the Chat functionality.
Chat Configuration - Business Object
Use this business object to configure the session details.
•First Inactivity Timeout: Timeout limit when a first warning message is sent to the Self Service Mobile user when inactive on a chat session.
•Second Inactivity Timeout: Timeout limit when a second warning message is sent to the Self Service Mobile user when inactive on a chat session.
•Session Expiration Timeout: Timeout limit when the Self Service Mobile user is logged out when inactive on a chat session.
•Analyst Session Timeout: Timeout limit when a Service Desk Analyst's status is turned Offline when no chat session is assigned.
•User Timeout: Timeout limit when a Self Service Mobile user is logged off from a chat session when unable to assign the chat session with the Service Desk Analyst.
•Concurrent Chat Sessions per Analyst: Number of chat requests that can be assigned to the Service Desk Analyst at a time.
•View User Chat History for last Created Incident(s): Number of previous chat sessions' history that should be stored. History is stored only when an Incident is created in the chat session.
•Maximum Number of Files that can be shared at one time: Limit of number of files that can be shared at a time in the chat.
•Maximum Number of File shares allowed per session: Limit of number of files that can be shared in a single session.
•Maximum Size for an Uploaded File: Limit of the file size that can be uploaded in the chat.
Chat Configuration Header - Business Object
Use this business object to set all header messages.
•Online Message Header: Header displayed to the Self Service Mobile user when the Service Desk Analyst staff is online and ready to pick up chat sessions.
•Offline Header: Header displayed to the Self Service Mobile when the Service Desk Analyst is offline and not available to pick up chat sessions.
•Hop Header: Header displayed to the Self Service Mobile when the Service Desk Analyst staff is offline during non-hours-of-operation.
•Join Header: Header displayed to the to the Self Service Mobile when a Service Desk Analyst joins the chat session.
•Fail Join Header: Header text displayed to the to the Self Service Mobile when unable to assign a Service Desk Analyst to the chat session.
•Knowledge Message: Link to knowledge base displayed to the Self Service Mobile user when unable to assign a Service Desk Analyst to the chat session.
•Warning Header: First warning header displayed to the Self Service Mobile user when inactive on the chat for the set time.
•Second Warning Header: Second warning header displayed to the Self Service Mobile user when inactive on the chat for the set time.
•Typing: Typing indicator displayed in the chat window text box.
•Send Message Place Holder: Message displayed in the chat window text box.
•Incident Created text: Message displayed in the chat window when an incident is created from the chat session.
When an Incident is created from a Chat, the Description field in the Incident will be auto-filled with the Chat history. This is enabled through the form used for the Chat Business Object. This feature is available by default for all new customers. However, existing customers need to install the package - Copy_chat_History_Upgrade.MetadataPackage and use the Create Incident - NEW form for configuring the Chat Business Object.
•User Disconnected: Message displayed to the Service Desk Analyst and the Self Service Mobile user when the chat session gets disconnected.
•Analyst Disconnected: Message displayed to the Neurons Self Service user when the Analyst id disconnected.
•Accessibility button Tooltip Text: The text to be displayed for the Accessibility button tool tip.
•Copy button Tooltip Text: The text to be displayed for the Copy button tool tip.
•Header Text for User Chat Interface: Text to be displayed for the Chat UI.
Chat Configuration Message - Business Object
Use this business object to set all body messages.
•Online Message: Message displayed to the Self Service Mobile user when the Service Desk Analyst staff is online.
•Offline Message: Message displayed to the Self Service Mobile user when the Service Desk Analyst staff is offline during hours-of-operation.
•Hop Message: Message displayed to the Self Service Mobile user when the Service Desk Analyst staff is offline during non-hours-of-operation.
•Joining Message: Message to the Self Service Mobile user when trying to assign a Service Desk Analyst to the chat session.
•Join Message: Message displayed to the Self Service Mobile user when a Service Desk Analyst joins the chat session.
•Fail Join Message: Message to the Self Service Mobile user when unable to assign a Service Desk Analyst to the chat session.
•Knowledge Button: Second line of the knowledge base link message when unable to patch a Service Desk Analyst to the chat session.
•Personal: Personal message.
Chat Configuration Text - Business Object
Use this business object to set all textmessages.
•First Warning text: First warning message displayed to the Self Service Mobile user when inactive on the chat for the set time.
•Second Warning Text: Second warning message displayed to the Self Service Mobile user when inactive on the chat for the set time.
•Expired Warning Text: Message displayed to the Self Service Mobile user just before logging off the chat session when the user is inactive on the chat for the set time.
•Session Expired Text: Message displayed to the Self Service Mobile user after logging off the chat session when the user was inactive on the chat for the set time.
•User Wait Expired Text: Message displayed to the Self Service Mobile user when unable to assign a Service Desk Analyst to the chat session.
• To avoid data exposure, use either ${lastname}, {$middlename}, or ${firstname} placeholder in the fields - Join Message, Joining Message, and Analyst Disconnected. However, you can use ${fullname} if you do not mind exposing the users' full name.
• When you make changes to the Chat Configuration, you need to clear cache for the changes to be effective. Without clearing cache, the changes will not take effect. To do it, open the Configuration console > Cache Management > Reset Chat Objects.
•Concurrent Session Expired Text: Message displayed when the concurrent session expires.
•Full Size button Tooltip Text: The text for the full size button tool tip.
•Chat Connection Failure Timeout Text: Message displayed to the Self Service Mobile user when the connection fails due to Analyst unavailability.
•Chat Connection Failure Text: Message displayed to the Self Service Mobile user when the connection fails.
•Minimize button Tooltip Text: The text for the minimize size button tool tip.
•Restore button Tooltip Text
Create Incident Quick Action
Service Desk Analyst can create an Incident from the chat session which is based on the Create Incident Quick Action added to the ivnt_Chat Business Object. This Quick Action can be customized as needed.
Customizing the Create Incident Quick Action
1.Log in to Neurons for ITSM with the Administrator user role.
2.Open the Configuration console.
3.Under Build, click Business Objects > search and open ivnt_Chat Business Object.
4.Click Create Incident.
5.Edit the data as needed and click Save.