The Analytics module provides the history of all administrative tasks with attributes such as User, Date/Time, and Description for an event. You can review the Audit Report page to analyze admin users, custom admins, and user events such as log on, log off, and changes to system settings.
The following illustration shows an example of the Analytics module with the Audit Report page displayed.
Viewing System and User Events
On the Audit Report page in the Kore.ai Bots Admin Console in the Analytics module, you can view the Kore.ai system and user-generated events. For example, a system-generated event could be a periodic Microsoft® Active Directory® Sync. An example of a user-generated event could be the addition of a new user.
Post the release of v8.1, the changes triggered by using Public APIs is also captured. For example import of roles using API etc.
Using the filters on the Audit Report page you can select event categories, events, and time periods to drill-down and filter events as needed. Kore.ai audit reports also list error messages that can help you to troubleshoot system issues or when you create a Kore.ai service request.
Using the Search Field
The list of entries in an admin console table can be very large depending on the size of your company, for example, a list of users. To find one or more specific users or groups, in the Search field, enter at least three characters to begin find-as-you-type.
To view all entries, clear the search field, and then press the Enter key.
Filter Options
You can narrow the list of events by date range, user/app, category, and name.
Date Filter can be set to
- past 24 hours – default selection;
- past 7 days; or
- Custom range by selecting the start and end dates.
Event Filter can be set by clicking the Filters button and then setting:
-
- the User Name/App Name field to narrow the events triggered either by a specific user or by a specific app.
- the Event Category field to show All events or select a specific category from the drop-down list.
- Based on the Event Category field selected, you can choose All or a specific event by name in the Event Name filter.
Export Options
- The export icon can be used to Export the audit reports in CSV format.
Record Details
By clicking on any entry you get to view further details pertaining as seen below:
| Note: The Audit Report contains system and user events for several Kore.ai products. To drill down further than Event Categories, use the Search for Description field, which lets you add one more criterion to the filter. To get XO Platform data, search for “Bot Builder” exactly; the Search field is case-sensitive. For more complex filtering, we recommend exporting the report and using a spreadsheet editor. |
Audit Report Details
The audit report is categorized by event category and event name. The following table lists these categories and a brief description as to what even qualifies against each category.
| Event Type | Event Description |
|---|---|
| User Created | When a user account is created. |
| User Modified | When a user profile is updated. |
| User Deleted | When a user account is deleted. |
| Group Created | When a group is created. |
| Group Updated | When a group is updated. |
| Group Deleted | When a group is deleted. |
| Users Added to Group | When users are added to a group. |
| Groups Added to Group | When groups are added to a group. |
| Users Removed from Group | When users are removed from a group. |
| Groups Removed from Group | When groups are removed from a group. |
| Admin Role Assigned to Users | When a user is assigned admin role. |
| Admin Role Deleted for Users | When a user is unassigned from admin role. |
| Bot Role Assigned to Users | When a bot role is assigned to users. |
| Bot Role Deleted for Users | When a bot role is deleted for a user. |
| Role Created | When custom admin role, and/or bot role created. |
| Role Updated | When custom admin role, and/or bot role details are updated. |
| Role Permissions Updated | When master and/or custom admin role, and/or bot role permissions are updated. |
| Role Deleted | When custom admin role, and/or bot role deleted. |
| Role Assigned to Groups | When a master and/or custom admin role, and/or bot role are assigned to groups. |
| Role Assigned to Users | When a master and/or custom admin role, and/or bot role are assigned to groups. |
| Role Deleted for Users | When master and/or custom admin role, and/or bot role are deleted for Users |
| Role Deleted for Groups | When master and/or custom admin role, and/or bot role are deleted for groups |
| Kore Connector Modified | When connector details are modified. |
| Kore Connector Status | When connector status changes. |
| Kore Connector Deleted | When a connector is deleted. |
| Kore Connector Certificate | When a connector certificate is generated. |
| App Created | When an app is created. |
| App Modified | When the client secret for the app is reset. |
| App Deleted | When an app is deleted. |
| App Scopes Assigned | When app scopes are assigned. |
| App Scopes Modified | When app scopes are modified. |
| App Scopes Deleted | When app scopes are deleted. |
| Settings Modified | When context persistence settings are modified. |
| Bot Deployment Approved | When a bot deployment request is approved. |
| Bot Deployment Rejected | When a bot deployment request is rejected. |
| Bot Deployment Settings | When settings for Deployment Requests and/or Enterprise Bot Assignments are modified. |
| Bot Task Suspended | When a task is suspended. |
| Bot Task Activated | When a task is activated. |
| Bot Owner | When the bot owner changes for the bot. |
| Bot Auto Approve | When auto approve settings have changed. |
| Bot Channels Modified | When a channel is enabled or disabled for the bot. |
| Bot Task Assignment | When tasks are assigned or unassigned for users/groups or when task assignment settings change. |
| User Enrollment Preferences | When the self signup setting for enterprise users changes. |
| Accept Enrollment Request | When enrollment request is accepted. |
| Reject Enrollment Request | When enrollment request is rejected. |
| Kill Session | When a session is killed. Includes details of both the user whose session was killed and the user who killed the session. |
| Access Chat History | When a chat history by a user is viewed. Also captured is the conversation session id. |
| Download Chat History | When a chat history by a user is downloaded. Also captured is the conversation session id. |
Viewing Chat History
You can view Chat History for all deployed bots from the Analytics > Bot Chat History section of the Kore.ai Bots Admin Console.
Click a specific chat to display the chat conversation or history. You can jump to the specific user’s previous and next conversation sessions if available.
Bot Chat History Page Columns
To sort the list of column values, click the Arrow Up 
icon or Arrow Down 
icon to the right of a column name.
The following list describes the columns displayed in the admin console table.
| COLUMN | DESCRIPTION |
|---|---|
| Bot Name | Name of the Bot in chat. |
| Timestamp | The date and time of the chat in YYY-MM-DD HH:MM AM/PM, for example, 2015-09-11 02:10 PM. It is displayed in the selected Time Zone. |
| Channel | Channel on which the Chat occurred. |
| Language | Language of the Chat. |
| User | The user name and id who initiated the chat can be either one of the following:
|
| Export | Option to Export the individual Chat in Excel or PDF format. |
About the Action Bar
This section describes the controls on the Action bar on the Chat History page.
Using the Time Zone Field
The time against the chat history would be displayed in the Time Zone selected. By default, it is set to Local. You can change it using the Change link and then selecting the appropriate zone.
Using the Search Field
The list of entries in an admin console table can be very large depending on the size of your company, for example, a list of users. To find one or more specific users or groups, enter at least three characters in the Search field to begin find-as-you-type.
To view all entries, clear the search field, and then press the Enter key.
Select Timestamp
Set the duration for which the Chat History needs to be retrieved:
- 7 Days.
- 24 hours – default setting.
- Custom – Select the start and end dates.
Export
You can use the export icon next to the Filters option to export the Chat History (Sessions) results in the CSV format.
Filters
Filter based on:
- the Bot you want to track; you can select multiple bots.
- the User initiating the Chat – can be Kore generated user id or channel assigned user id. This option is available only if a single bot is selected from the previous selection.
- conversation types can be either one or both of the following:
- interactive sessions – conversations that include one or more messages from the user.
- non-interactive sessions – conversations that do not include any message from the user.
- Channel of interaction
- Language of interaction
Meta tags added at a message, user, or session levels. Multiple tag filters can be applied in a ‘AND’ condition. This option is available only when at least one bot is selected.
The export file of Chat History (session-level) will include the details of the applicable tags.
Chat History Details
Chat History provides visibility into the user information with the inclusion of the following functionality:
- User Profile: Provides a 360-degree view of the user along with their usage metrics;
- User Conversation Sessions: Lists out all the sessions of the user in the given period with the selected utterance section expanded.
- Trace ID – A unique ID assigned to each incoming message. The Id is also included in all the logs maintained by the Platform. To see the associated Trace ID for an incoming message, hover over the message, click the Info icon, and then click the Message Id to view the Trace ID.
Note: The Trace ID is retained in the logs for 30 days. Once the Trace ID is expired, you see a tooltip message as ‘Trace Id: Trace records for this message are not available‘.
Click on any chat history to see these options. Following are the user information details provided:
| Functionality | Attribute | Description |
|---|---|---|
| User Profile | Kore User ID | User id assigned by the platform. |
| Channel Data | Data received from the channel i.e. the information that is available in User Context. | |
| User Meta Tags | The total number of meta tags associated with the user and key-value pairs for the most recent ones. | |
| Latest Interaction | Last time the user interacted with the bot. | |
| Total Conversation Sessions | The total number of interactive and non-interactive sessions registered by the user from the beginning of time. | |
| Total Conversation Sessions in Last 30 Days | The total number of interactive and non-interactive sessions registered by the user in the last 30 days. | |
| *The next few attributes will not be displayed if there is no interaction by the user in the last 30 days | ||
| Last 30 Days’ Intent Detection Rate | (Total identified intents / (Total identified intents + unidentified utterances)) * 100 for the utterances over the last 30 days. | |
| Intents Requested | Total identified intents + unidentified utterances. | |
| Intents Identified | Total intents identified. | |
| Last 30 Days Goal Completion Rate | (Total success tasks / (Total success tasks + total failed tasks) ) * 100 for the tasks over the last 30 days. | |
| Tasks Initiated | Total success tasks + total failed tasks. | |
| Tasks Completed | Tasks successfully completed. | |
| Recent Conversation Flows | Top 10 popular conversation flows executed by the user in the last 30 days. Popular flows are determined by the number of instances that the flow was executed. | |
| User Conversation Sessions | Session Attributes | |
| Session Start | Session start date and time. | |
| Session End | Session end date and time. | |
| Channel | Channel in which the session was initiated. | |
| Agent Transfer Tag | The session where the user was transferred to an agent. Sessions should be considered even if the user returns to the bot. | |
| Drop Off Tag | The session where the user dropped off. | |
| Total Success Tasks | Count of tasks successfully completed in the session. | |
| Total Failed Tasks | Count of tasks failed in the session. | |
| Intents Identified | Count of intents successfully identified in the session. | |
| Intents Not Identified | Count of intents unidentified in the session and list of unidentified intents. | |
| Conversation Path | The series of tasks initiated by the user in the session. | |
| Session Meta Tags | Count of the session meta tags used with the details of the most recent custom meta tags displayed. | |
| Conversation Transcript | ||
| Message Meta Tags | The chat transcript is annotated with message tags for messages with meta-tags associated with them. | |
| Agent Transfer | Indicates the point of agent transfer at the last message prior to transfer. | |
| Drop Off | Indicates the point of drop off at the last message prior to dropping off. | |