Customizing the Conversation Form

You can customize the SimpleChat Conversation entity form according to your organization's needs. The following fields are listed in the form:

 

Form header fields:

  1. Conversation Start: The date on which the first message was received or sent. Could be before the creation date if there was first a conversation between the bot and the customer
  2. Owner: When the activity is routed to an agent the activity also gets assigned to the agent
  3. Status Reason: The current status of the conversation. See details below
  4. Destination Queue: The queue to which the call will be routed during creation. Filled according to the queue of the selected answer or by default from the channel

 

Conversation Details section:

  1. Conversation With: Filled by the system's customer identification mechanism from the profile if the profile has already been associated with a contact, otherwise when selecting a contact in this field a new profile will be associated with it
  2. Customers: Displayed on public channels such as Facebook instead of Conversation With. Displays the list of all identified customers who responded to the post. Note: Unidentified customer profiles that responded to the post will only be displayed in the conversation transcript
  3. Subject: The primary field. Filled with the last customer's answer to the bot questions, or, if a bot was not involved, from the customer's initial message
  4. Channel: The specific channel where the conversation was received or sent, such as the specific Facebook page

Shown only when creating a conversation. Allows you to select a channel that the customer has already contacted before and was identified (was associated with the conversation)

  1. Outgoing Conversation: When making an outgoing conversation, if Always Display is selected display immediately in the SimpleChat panel, otherwise, if Display Upon Reply is selected, display in the SimpleChat panel only when the customer has responded to the outgoing message

Only shown in outgoing conversations, filled by default from the selected channel

  1. Caller Name: The name of the caller on the channel (such as the Facebook profile name), and when the customer is identified by the identification mechanism according to the social profile, the field will be updated to the CRM contact name

 

Context section:

  1. Regarding: the ability to associate the activity to a record in the system, such as a case
  2. Channel Type: The type of channel from which the customer has contacted, such as Facebook Wall or Web Chat
  3. Channel ID: The channel ID through which the customer has contacted. Will contain the URL from which a chat window opens, the SMS phone prefix (network ID), the post in a private conversation that was opened from a post, or the user ID on the other channels
  4. Call Direction: Incoming - initiated by the customer. Outgoing - manually by an agent or following a campaign
  5. During Work Hours: Marked by the system according to the work hours defined for the channel
  6. Related Conversation: The public post from which a private Facebook conversation was created
  7. Caller ID: Caller profile that is unique to the channel (such as Facebook ID). Will be used as a profile ID

 

Timeline section:

  1. Conversation Start: The date and time in which the first message was sent or received. Could be prior to Created On when a bot initially chats with the customer
  2. Waiting for Agent From: The time in which the conversation's status was set to Waiting for Available Agent
  3. Routed to Agent On: The time in which the conversation was routed to an agent but the agent has not yet replied
  4. Chatting With Agent From: The time in which the agent first answered the conversation that was routed to him
  5. Due Date: The date according to which the conversation is prioritized to be routed to an agent and according to it the agent to whom the conversation was routed sees an indication as the time approaches and when it has passed
  6. Handled On: The date on which the conversation was closed by a pre-conversation bot or by an agent, at which time a post conversation bot is activated, if set, otherwise the conversation is marked as complete.

 

Conversation Transcript tab:

Displays the conversation transcript. Shown only in conversations that are not opened from the SimpleChat panel

 

Notes tab:

Displays the notes component, which shows the files attached to the conversation

 

Below are additional fields that are not displayed on the form and can be used in views and charts:

  1. Customer Identification: programmatically marking the field when the record is created will skip the system's customer identification mechanism that uses a social profile to identify (allows the application of other logic)
  2. Required Participants: A list of all participants from the organization currently present in the conversation
  3. Optional Participants: A list of all participants from the organization who were previously present at the conversation
  4. Sentiment: Indicates the weighted sentiment of the customer according to the latest messages from him. A happy or sad smiley is displayed accordingly

Note: If the sentiment analysis mechanism was not activated in the settings or if the sentiment was not detected, the indication will not be displayed in the conversation pane

  1. Reminder: Snoozes the conversation for the specified time period. The conversation will be removed from the SimpleChat panel, leaving room for handling another conversation instead. When the time comes the conversation will be reintroduced in the SimpleChat panel, with an alarm clock indicator. Note: If the customer sent a new message when the conversation is snoozed, it will also be reintroduced to the agent

Note: Not used from version 2.0 onwards

  1. Number of Likes: The number of times people have marked Like to the conversation's post
  2. Number of Messages: The amount of incoming and outgoing messages in a conversation (sent by the customer, the agent, or the bot)
  3. Handling by BOT: Is automatically marked as long as the status conversation is Handled by BOT
  4. Last Incoming Message: The last message from the customer. Allows application of logic according to message
  5. Last Incoming Message On: The time in which the last message was received from the customer
  6. Last Outgoing Message On: The time in which the last message was sent to the customer
  7. Snooze Start: The date and time in which the conversation was last snoozed
  8. Snooze End: The date and time in which the conversation will stop snoozing or has already stopped snoozing
  9. Wait Time for Available Agent (Minutes): Minutes from the time a conversation enters the queue until a free agent is found and the conversation is routed to it (can be used in charts)

Wait Time for Available Agent: Display the above time in views in a readable format

  1. Wait Time for Agent Response (Minutes): Minutes from the time a conversation is routed to an agent until the agent sends a first response (can be used in charts)

Wait Time for Agent Response: Display the above time in views in a readable format

  1. Total Wait Time for Agent (Minutes): Minutes from the time a conversation enters the queue until it is routed to an agent and agent sends a first response (can be used in charts)

Total Wait Time for Agent: Display the above time in views in a readable format

  1. Chat Time With Agent (Minutes): Minutes from the time the agent sent a first response until the agent ended the conversation (can be used in charts)

Chat Time With Agent: Display the above time in views in a readable format

  1. Handling Completion (Minutes): Minutes from the time the agent sent a first response until the conversation is closed (can be used in charts)

Handling Completion: Display the above time in views in a readable format

 

The following are additional fields that are populated in response to a Location question if Convert Location to Address is marked for the channel: Street Number, Street Name, Quarter, City, County, State or Province, Postal Code, Country, Point of Interest, Address: human-readable address of this location, Address Components: json string of all address components retrieved from google (includes additional components)

Note: The fields will not be filled in if a customer submitted his location on his own initiative, not as an answer to a Location type question

 

Below are additional fields in the entity for internal use by the bot mechanism::

  1. Last Answer: Cleared when sending a question to the customer and filled when receiving an answer within the time frame
  2. Last answer On: In the workflow set the wait condition on this field to respond to the customer's choices. Note: Waiting on Last Answer will trigger the workflow twice, when the field is filled and when it is cleared by the next question
  3. Last Answer ID: The ID of the customer's selection from the options presented to him
  4. Last Latitude, Last Longitude: The last location provided by the customer in answer to a Location type question. Allows filtering and sorting a dynamic question by the distance from that location
  5. Question Path: Guids of the questions separated by semicolons.

Enables logic for retrieving information based on all the questions that were presented to the customer rather than the last one

  1. Answer Path: Guids of the answers separated by semicolons.

Enables logic for retrieving information based on all of the answers the customer chose instead of the latest one. Note: A question with no answers is not displayed and is represented as guid.empty (zeros)

 

Below are the possible conversation statuses:

Status reasons under the Open main status

New

Default status reason of every conversation in the system

Note: The conversation is only created after the pre-call questions bot finished executing, if a bot was set in the channel

Handled by BOT

Automatically when a message or question is sent to a customer through a bot, whether by one of the built-in bots such as a pre-conversation bot or a long wait bot, or through a workflow or call to an API service

Ready for Routing

Automatically when a pre- conversation bot has finished its operation and it is therefore required to route the conversation to an agent. Note: If the bot is restarted by the workflow engine the status will return to Handled by BOT

Waiting for Available Agent

Automatically when a free agent detection logic started to execute (when a conversation is routed to a queue and in some other cases)

Routed to Agent

Automatically when an available agent is located, and as long as the agent has not responded to the customer

Chatting with Agent

Automatically when an agent sends a message to a customer in the conversation window (not when he has just opened the conversation form)

Handled

Automatically when an agent clicks the Exit button in the conversation pane. As a result of the conversation is removed from the SimpleChat panel, if a post conversation bot is set it will be activated, otherwise the conversation will be closed with Completed status

Status reasons under the Scheduled main status

Scheduled

Not in use. This main status is built-in for all activities and can't be changed

Status reasons under the Completed main status

Completed

Updated when the activity is marked as complete

Status reasons under the Cancelled main status

Canceled

Updated when the activity is canceled

Customer Didn't Respond

Filled by the bot as a result of a No Response operation for which the follow-up action was set to Cancel Activity

Outside Work Hours

Updated automatically if in the channel Service Schedule was filled and Close Activity was marked, and the conversation is outside the work hours