{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5264,"path":"conversational-interfaces/virtual-agent/va-interactions.md","title":"Virtual Agent interaction records","bundle":null,"doc_type":null,"release":"australia","body":"\n# Virtual Agent interaction records\n\nEach time a Virtual Agent conversation occurs, an interaction record captures the entire conversation in the Interactions \\[interaction\\] table. The record includes all topic elements used in the conversation, as well as live agent transfers.\n\n## Interactions \\[interaction\\] table\n\nEach conversation in an instance generates an interaction record in the Interactions \\[interactions\\] table, which logs the conversation between a requester and Virtual Agent. The interaction records include conversations that occur across the supported chat channels: chat widget, native mobile app, and messaging integrations.\n\n**Note:** The Interactions table is part of the Interaction Management plugin \\(com.glide.interaction\\). Virtual Agent, Agent Chat, and Connect Support use this plugin.\n\nThese interaction records provide administrators, Virtual Agent administrators, support agents, and support managers with a convenient way to review what happened during a conversation. The records also provide a quick way to see the type of conversations that occur: Virtual Agent, live agent transfers to Agent Chat, and live agent transfers to Connect Support.\n\n\\[Omitted image \"VA-interactions-table.png\"\\] Alt text: Key fields in the Interactions table, such as the Virtual Agent and Agent Chat fields that indicate the type of conversation.\n\n**Note:** Conversation transcripts are available only for Virtual Agent records that have Virtual Agent conversations and live agent transfers to Agent Chat.\n\n-   When a conversation transcript for live chat exceeds 4000 characters, the transcript is handled as an attachment to the interaction record.\n-   File attachments that the user uploads are recorded in the Attachments \\[sys\\_attachment\\] table, which corresponds to the interaction record. Attachments are automatically displayed in the activity stream.\n-   For Virtual Agent conversations that have live agent transfers to Connect Support, only the Virtual Agent conversation is included in the interaction transcript. Live agent conversations in Connect Support are recorded in the activity stream.\n\n## Key fields in the Interactions table\n\nTo view the Interactions table, navigate to **All**, and then enter `interaction.list` in the navigation filter. You can configure the fields displayed in the table using the [list collector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/t_UseSlushbuckets.md) \\(slushbucket\\).\n\n<table id=\"table_xs3_3hy_yjb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAgent average response time\n\n</td><td>\n\nAverage time based on how long the agent takes to respond to each message sent by a requester. For example:\n\n ```\n00:00 Requester: I have a question.\n00:01 Agent: What is it?\n00:04 Requester: How do I reset my password?\n00:05 Requester: I forgot it and can't access my account.\n00:07 Agent: Here is the answer.\n```\n\n Pair \\#1 00:01-00:00 = 00:01\n\n Pair \\#2 00:07-00:04 = 00:03\n\n \\(00:01 + 00:03\\) / 2 = 00:02 average\n\n</td></tr><tr><td>\n\nAgent chat\n\n</td><td>\n\nFlag that indicates the conversation was transferred to a live agent in Agent Chat: true or false.\n\n</td></tr><tr><td>\n\nApplication\n\n</td><td>\n\nScope of the application. Scope determines the accessible files and data available to other applications.\n\n</td></tr><tr><td>\n\nAssigned to\n\n</td><td>\n\nName of the fulfiller: Live agent name or Virtual Agent\n\n</td></tr><tr><td>\n\nDomain\n\n</td><td>\n\nThe domain the conversation took place in. For more information, see [Domain separation and Virtual Agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/domain-separation-virtual-agent.md).\n\n</td></tr><tr><td>\n\nNumber\n\n</td><td>\n\nNumber of the interaction record.\n\n</td></tr><tr><td>\n\nOpened\n\n</td><td>\n\nDate and time that the conversation started.\n\n</td></tr><tr><td>\n\nOpened for\n\n</td><td>\n\nName of the requester. Anonymous users are identified as Guests.\n\n</td></tr><tr><td>\n\nSentiment\n\n</td><td>\n\nShows the sentiment level of the interaction, if sentiment analysis is enabled on the instance. This value can be shown to agents in the Agent Chat interface. Business rules can be created based on this value at handoff \\(Virtual Agent to live agent, live agent to live agent, or live agent to queue\\). Valid values are as follows:-   Positive\n-   Neutral\n-   Negative\n-   null \\(no value assessed\\)\n\nThis value is also entered in the [Interaction Insights table](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/ci-interaction-insights-table.md).\n\n</td></tr><tr><td>\n\nState\n\n</td><td>\n\nConversation states: -   In Progress: Conversation between requester and virtual agent is in progress.\n-   Closed Complete: Virtual agent ends the conversation.\n-   Closed Abandoned: Requester ends the conversation before completing the conversation with the virtual agent.\n\n **Note:** There are different State Reasons for the Closed Complete and Closed Abandoned states, depending on whether you're using Virtual Agent only, Virtual Agent with Live Agent, or Live Agent only. For details on the State Reasons, see [Reasons for Closed Complete and Closed Abandoned states](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-interactions.md).\n\n</td></tr><tr><td>\n\nState Reason\n\n</td><td>\n\nDetailed explanations \\(reasons\\) for the conversation states Closed Complete and Closed Abandoned. To learn more, see [Reasons for Closed Complete and Closed Abandoned states](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-interactions.md).\n\n</td></tr><tr><td>\n\nTranscript\n\n</td><td>\n\nLog of the conversation between the requester and agents \\(virtual or live\\).\n\n</td></tr><tr><td>\n\nType\n\n</td><td>\n\nType of interaction record. Virtual Agent conversations are record type Chat.\n\n</td></tr><tr><td>\n\nUpdated\n\n</td><td>\n\nDate and time that the conversation record was last updated.\n\n</td></tr><tr><td>\n\nVirtual agent\n\n</td><td>\n\nFlag that indicates whether the conversation is for Virtual Agent: true or false. A Virtual Agent conversation is flagged when a requester selects a conversation topic or when the topic discovery process starts the appropriate conversation.\n\n</td></tr></tbody>\n</table>## Reasons for Closed Complete and Closed Abandoned states\n\nVirtual Agent closes completed and abandoned conversations for various reasons, depending on whether the conversation is for Virtual Agent \\(VA\\) only, Virtual Agent with Live Agent \\(VA-LA\\), or Live Agent \\(LA\\).\n\n\\[Omitted image \"va-interactions-reasons.png\"\\] Alt text: Interactions table that shows the State Reason column for Closed Abandoned and Closed Complete states.\n\nThe **State Reason** field provides details on the different ways in which a conversation ends. The following table describes the reasons and also the related message displayed for dashboard analytics. For details about how Virtual Agent and Agent Chat handle idle conversations and the corresponding default timeout periods, see [Closing Virtual Agent and Agent Chat conversations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-open-conversations.md).\n\n<table id=\"table_wxj_vcq_b4b\"><thead><tr><th>\n\nState\n\n</th><th>\n\nState Reason\n\n</th><th>\n\nVirtual Agent\n\n</th><th>\n\nVirtual Agent &amp; Live Agent or Live Agent only\n\n</th></tr></thead><tbody><tr><td>\n\nClosed Abandoned\n\n</td><td>\n\nLeft Before Engagement\n\n</td><td>\n\nNot applicable.\n\n</td><td>\n\nRequester chose to be routed to a live agent, but closed the conversation \\(selecting **+ End**\\) before an agent was assigned.\n\n Dashboard message:\n\n `User closed LA - before Agent engagement`\n\n</td></tr><tr><td>\n\nClosed Abandoned\n\n</td><td>\n\nNo Activity\n\n</td><td>\n\nRequester opened a conversation, but didn't engage with the bot \\(for example, closed the browser\\) and didn't initiate topic discovery. The system closed the Virtual Agent idle conversation after the default timeout.\n\n-   Virtual Agent idle chat timeout: Two hours \\(default\\)\n-   Dashboard message: `System closed VA - user never engaged`\n\n</td><td>\n\nRequester chose to be routed to a live agent \\(not through pre-chat setup\\) but didn't engage with the agent. If the conversation timed out and the **Time Out Abandoned VA Conversations**scheduled job ran, the interaction state is Closed Abandoned with No Activity.\n\n Dashboard message: `System closed LA - before Agent engagement`\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nUser Ended\n\n</td><td>\n\nAfter engaging with the bot \\(requester entered at least one utterance during a conversation or completed a conversation\\), requester closed the conversation session by selecting **End**.\n\n Dashboard message: `User closed VA - Clicked End/X`\n\n</td><td>\n\nRequester started to chat with live agent but closed the chat client by selecting **End**.\n\n Dashboard message: `User closed LA - Clicked End/X`\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nAuto Closed\n\n</td><td>\n\nRequester interacts with VA topic and completes the conversation. No live agent interaction.\n\n Dashboard message:`System closed VA - Auto Closed`\n\n</td><td>\n\nNot applicable.\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nNo User Response\n\n</td><td>\n\nRequester engaged with the bot \\(entered at least one utterance\\), but left without actively closing the conversation. The system closes the idle conversation after two hours \\(default\\).\n\n -   Virtual Agent idle chat closed: Two hours\n-   Dashboard message: `System closed VA - User no response`\n\n</td><td>\n\nRequester engaged with live agent but stopped and left the agent hanging \\(idle live chat\\). The system closes the idle live chat after six minutes \\(default\\).\n\n -   Idle live chat closed: Six minutes\n-   Dashboard message: `System closed LA - User no response`\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nTopic Complete\n\n</td><td>\n\nRequester engaged with the bot in a topic but didn't respond to the Anything Else setup topic, or chose Yes to continue but didn't respond. The **Time Out Abandoned VA Conversations** job closes the interaction after the default timeout.\n\n-   Virtual Agent idle chat closed: Two hours\n-   Dashboard message: `System closed VA - Topic complete`\n\n</td><td>\n\nNot applicable.\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nLeft for search\n\n</td><td>\n\nRequester engaged with the bot \\(entered at least one utterance\\), but selected Search in the middle of the conversation and didn't return to the conversation. The system closes the conversation because of inactivity.Dashboard message:`System closed VA- Left with AI search`\n\n</td><td>\n\nNot applicable.\n\n</td></tr><tr><td>\n\nClosed Complete\n\n</td><td>\n\nAgent Ended\n\n</td><td>\n\nNot applicable.\n\n</td><td>\n\nAfter requester started a chat with a live agent, the agent actively closed the conversation by selecting **End Chat**.Dashboard message:`Agent closed LA - Clicked End/x`\n\n</td></tr><tr><td>\n\nFaulted\n\n</td><td>\n\nError\n\n</td><td>\n\nA runtime exception occurred while processing a message.\n\n</td><td>\n\nRequester’s conversation was closed due to a runtime error.\n\n</td></tr></tbody>\n</table>## Detailed view of a Virtual Agent interaction record\n\nFrom the Interactions table, you can open a specific record to see additional details about the Virtual Agent interaction: a transcript of the conversation, related tasks, and interaction logs.\n\n**Note:** If a field is not visible, you can add it to the form view. For more information, see [Configuring the form layout](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/configure-form-layout.md).\n\n-   **Conversation transcript**\n\n    The transcript shows the dialog exchange between the agent \\(virtual or live\\) and requester, as well as the time stamp for each dialog turn.\n\n    \\[Omitted image \"VA-interaction-record.png\"\\] Alt text: A Virtual Agent chat transcript in a Virtual Agent interaction record.\n\n-   **Related Tasks**\n\n    Any cases, incidents, or requests created or updated during the conversation are automatically attached to the interaction record as a Related Task. To ensure that these tasks are included with the interaction record, design your conversation topics using certain Assistant Designer utilities and the system method vaSystem.attachRecordToConversation. For details, see [Topic design considerations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-interactions.md) below.\n\n    \\[Omitted image \"VA-interaction-relatedtask.png\"\\] Alt text: The Related Tasks tab on the Interactions record shows the incident record that was created during the interaction.\n\n-   **Interaction Logs**\n\n    The **Interaction Logs** tab lists all the topics that run in a conversation, including the setup topics and the topics executed by topic discovery or by user selection. Each topic element is assigned a number that indicates the sequential order in which the topics run.\n\n    \\[Omitted image \"VA-interaction-log-table.png\"\\] Alt text: The Interaction Logs tab on the Interactions record shows the topics that were run during the user interaction.\n\n\n## Security considerations\n\nInformation in conversation transcripts is viewable to all users. If you need to control access to records containing sensitive information, you can use scoped access control lists \\(ACLs\\) and lock scripted access to those records by using the Restricted Caller Access \\(RCA\\) feature. For details, see [Set application scope, application resource, and event access](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/application-development/scope-resource-access.md) and [Manage Restricted Caller Access](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/security-management/t_ConfigureSIM.md).\n\n## Topic design considerations\n\nIf your Virtual Agent conversations create or update incidents, cases, or requests, consider designing your topics with the following [Virtual Agent Designer utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-utilities.md) and system method:\n\n-   [Action utility](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-action.md) to create or update incidents or cases\n-   [Lookup utility](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-lookup.md) to view information\n-   System method vaSystem.attachRecordToConversation\\(String tableName, String sysId\\) to attach the task to the interaction record\n\nUse these utilities and system method so that incidents, cases, or requests created during a Virtual Agent conversation are included in the **Related Tasks** list of the interaction record.\n\n**Note:** Records created or updated using the [Script Action utility](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-script-action.md) are not captured as related tasks in the interaction record.\n\n**Parent Topic:**[Virtual Agent technical reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-advanced-technical-reference.md)\n\n**Related topics**  \n\n\n[Domain separation and Virtual Agent]()\n\n[Virtual Agent scripts]()\n\n[Input data types in Virtual Agent topics]()\n\n[NLU system entities]()\n\n[Virtual Agent URL parameters]()\n\n[Latency feedback in Virtual Agent]()\n\n"}}