Skip to main content

Descriptions of default table columns on data explorer

API events

FieldDescription
TIMESTAMPThe TIMESTAMP field represents time intervals in 1-minute slots within a 24-hour day. When an event occurs, its timestamp is rounded to the nearest 1-minute interval. The first occurrence creates a new row with the timestamp, and if the same event occurs again within the same 1-minute slot, the count column value for that timestamp is incremented by 1. This allows tracking the number of occurrences of the same event within each 1-minute interval. Subsequent occurrences in the same interval contribute to the count column value. For example: Suppose an event occurs at 9:46:24, its timestamp would be 9:46, creating a new row. If the same event happens at 9:46:37, the count becomes 2 for the 9:46 timestamp. Another event at 10:13:47 creates a new row with a timestamp of 10:13. The count column tracks repeated occurrences within the same 1-minute slot.
BIDBusiness Identifier
CUSTOMID1Custom Identifier from CDP (Customer Data Platform)
CUSTOMID2Custom Identifier from CDP (Customer Data Platform)
EVENTINFOAdditional Information Stored By Platform (Not for customer customization)
IPUser's IP address identified by the platform
NAMENot Applicable (NA)
SOURCEAdditional Information Stored By Platform (Not for customer customization)
STATUSCODEVarious Status of the API response. 200 Means Success, 404 means Server-side Failure
UIDUnique Identifier of User
LANGUAGELanguage identified by our platform for the ongoing interaction
RESPONSE_TIMETime taken (in milliseconds) by the server to respond back to the API request
COUNTNumber of API Hits

Bot events

EventsDescription
bot_loadsFired when a gets bot loaded on the platform
datastore-bulk-upsertFired when Bulk insert or update operation is performed on the datastore
datastore-deleteFired when a delete operation is performed on the datastore
datastore-failed-deleteFired when a delete operation fails on the datastore
datastore-failed-dropdataFired when a drop data action fails on the datastore
datastore-failed-findFired when a find request is received on the datastore and the request fails
datastore-failed-insertFired when an insert operation is performed and it fails to insert into the datastore
datastore-failed-searchFired when a search operation is performed on the datastore and it fails
datastore-failed-searchDocumentsFired when a step of the journey is expected or a prompt is shown to the user
datastore-failed-updateFired when the update operation is performed on the datastore and it fails
datastore-feedbackFired when feedback is pushed into the datastore
datastore-findFired when a find operation is performed on the datastore
datastore-insertFired when an insert operation is performed on the datastore
datastore-searchFired when a search operation is performed on the datastore
datastore-searchDocumentsFired when a document search operation is performed on the datastore
datastore-updateFired when an update operation is performed on the datastore
db_node_fallbackFired when a notification is received to the mobile widget
email-sentFired when an email is sent
function-execution-timeFired when a session is created based on a USER message
invocationFired when a new session is created from a user message for the WhatsApp channel
otp-sentFired when an OTP is sent
otp-verifiedFired when an OTP is verified
pdf-convert-apiFired when a PDF convert API is being hit
redis-delFired when the delete operation is performed on the Redis memory
redis-getFired when data is fetched from the Redis memory
redis-setFired when write operation is performed on the Redis memory
synonymsFired when a synonym is detected
unknown-messageFired when an unknown message is received
widget_loadedFired when a widget is loaded

Click here to learn about events.


Chat tickets

FieldDescription
USER_IDUnique identifier for the user in the given channel.
RECENT_USER_MESSAGE_TIMETime of the last user message; null if not responded.
CONTACT_PHONEPhone number of the user collected from the bot.
CONTACT_EMAILEmail of the user collected from the bot.
CONTACT_NAMEName of the user collected from the bot.
TICKET_PRIORITYPriority of the ticket (default: medium).
TICKET_CREATION_TIMETime the ticket is created.
SOURCE_CHANNELChannel through which the user accessed the bot.
TICKET_TRANSFERSList of ticket reassignments to agents or groups.
TICKET_TYPEType of the ticket (default: live chat).
VOICE_CALL_FLAGIndicates if video calling is enabled for this ticket.
AUTO_TRANSLATE_FLAGIndicates if auto-translate is enabled for this ticket.
RECENT_AGENT_MESSAGE_TIMETime of the last agent message.
ADMIN_ASSIGNMENT_FLAGIndicates if an admin assigned this ticket to the agent.
REPLY_COUNTNumber of aggregate responses given by the agent to the end user.
USER_REPLY_COUNTNumber of aggregate responses given by the user to the agent.
TICKET_IDAuto-generated reference number for each incoming ticket.
TAGSCategorization of tickets done with configured words/phrases in inbox settings.
COMMENTSAdditional information about the chat ticket, including inactivity, auto-translate, etc.
OPEN_TIMETime the ticket was opened.
ASSIGNMENT_TIMETime the ticket was assigned.
RESOLUTION_TIMETime the ticket was resolved.
GROUP_CODECategory/group to which the ticket was assigned.
AGENT_NAMEName of the assigned agent.
AGENT_EMAILEmail of the assigned agent.
REOPENED_AGENT_EMAILEmail of the agent who reopened the ticket.
RESOLUTION_DURATION_CREATE_IN_SECONDSDuration between resolution time and creation time (in seconds).
RESOLUTION_DURATION_ASSIGNED_IN_SECONDSDuration between resolution time and assigned time (in seconds).
QUEUE_WAIT_DURATION_IN_SECONDSDuration between assigned time and ticket creation time (in seconds).
FIRST_RESPONSE_DURATION_IN_SECONDSDuration between First Response Time (FRT) and assigned time (in seconds).
FIRST_RESPONSE_TIME_CREATION_IN_SECONDSDuration between FRT and ticket creation time (in seconds).
AVERAGE_RESPONSE_TIME_IN_MILLISECONDSAverage time taken for agents to respond to each customer reply in all tickets (in milliseconds).
AVERAGE_RESPONSE_TIME_IN_SECONDSAverage time taken for agents to respond to each customer reply in all tickets (in seconds).
CHILD_BOT_IDBot ID from which this chat was raised (for unified inbox).
CUSTOM FIELDSIndividual custom fields and their values captured from this live chat.
TICKET_STATUSPossible statuses for a chat ticket: Open, Assigned, Missed, Resolved, and Queued.

Status description

StatusDescription
OpenSet when an incoming live chat has no available agents, either inside or outside working hours, to handle it.
AssignedSet when a chat is assigned to an agent after being created.
MissedSet as the fallback for all incoming chats that cannot be assigned to agents. This may occur if the queue is not enabled, the queue is full, or offline functionality is not enabled.
ResolvedSet when agents close a live chat.
QueuedSet when agents are busy or away, or if chat concurrency per agent is full. Incoming live chats are directed to queued chats when queues are enabled.

Email tickets

FieldDescription
AGENT_EMAILEmail ID of the assigned agent.
AGENT_NAMEName of the assigned agent.
AGENT_ASSIGNMENT_COUNTThe current ticket concurrency assigned to the agent at the time of ticket creation.
ADMIN_ASSIGNMENT_FLAGTrue if the admin manually assigned this ticket to an agent.
ASSIGNMENT_TIMEThe timestamp at which the ticket was assigned to the agent.
AGENT_IDUnique identifier for the assigned agent.
COLLABORATORSList of collaborators involved in the ticket.
CONTACT_FIRST_NAMEFirst name of the customer who created this ticket.
CONTACT_EMAILEmail of the customer who created this ticket.
TICKET_CREATION_TIMEThe timestamp when the ticket was created within the platform.
CUSTOM FIELDSAll individual custom fields and their values captured from this email ticket.
TICKET_DUE_DATEDue date of the ticket.
FIRST_RESPONSE_TIMEThe timestamp of the first response provided by the agent in that ticket.
FIRST_RESPONSE_DUE_TIMEDue time for the first response SLA.
FIRST_RESPONSE_DURATION_ASSIGNED_IN_SECONDSTotal time duration between the ticket being assigned to an agent and the agent providing the first response.
FIRST_RESPONSE_DURATION_CREATE_IN_SECONDSTotal time duration between the ticket being created in the platform and the agent providing the first response.
FIRST_RESPONSE_TARGETThe target timestamp by which the first response must be provided according to the SLA policy.
GROUP_CODEThe group to which the ticket is assigned.
RECENT_AGENT_MESSAGE_TIMEThe timestamp of the last agent message in that ticket.
RECENT_BOT_MESSAGE_TIMEThe timestamp of the last bot message in that ticket.
RECENT_REOPEN_TIMEThe last timestamp when the ticket was reopened.
RECENT_USER_MESSAGE_TIMEThe timestamp of the last user message in that ticket.
MANUAL_ASSIGNMENT_FLAGTrue if the ticket was manually assigned to an agent.
PARENT_FLAGTrue if other tickets are merged into this ticket (parent).
PARENT_TICKET_IDTicket ID of the parent ticket to which this ticket is merged.
TICKET_PRIORITYThe priority of the ticket, set during its creation or changed by the agent (High, Medium, or Low).
REOPENED_FLAGTrue if the ticket is reopened.
REOPENED_AGENT_EMAILEmail ID of the agent to whom the ticket was reopened.
REOPENED_BYThe agents name who reopened the ticket.
REOPEN_COUNTCount of times the ticket is reopened.
REPLY_COUNTCount of exchanges between the customer and the agent.
RESOLUTION_DUE_TIMEDue time for ticket resolution.
RESOLUTION_DURATION_ASSIGNED_IN_SECONDSTotal time duration between the ticket being assigned to an agent and the ticket getting resolved.
RESOLUTION_DURATION_CREATE_IN_SECONDSTotal time duration between the ticket being created in the platform and the ticket getting resolved.
RESOLUTION_TARGETWhether the resolution SLA was achieved or breached.
RESOLUTION_TIMEThe timestamp when the ticket was marked resolved by the agent.
RESPONDED_FLAGIndicates whether the agent has responded to the ticket.
TICKET_STATUSStatus of the email ticket (Opened, In-progress, On-hold, Resolved, or Pending).
TICKET_SUBJECTThe subject mentioned in the email ticket.
TAG_NAMEAll the tags applied to this particular ticket.
TICKET_IDAuto-generated reference number for each incoming ticket.
TRANSFERRED_FLAGTrue if the ticket has been transferred at least once.
USER_IDUnique identifier for the user in the given channel.
USER_REPLY_COUNTNumber of times the user has replied in the ticket.

Inbox call records

FieldDescription
BOT_IDBot ID associated with the configured inbox for handling calls.
USER_IDUnique identifier for the user in the given channel.
TICKET_IDAuto-generated reference number for each incoming ticket related to the voice call.
CALL_DURATIONDuration between the call pickup time and call end time.
CALL_SIDUnique identifier for the voice call.
CALL_PICKUP_TIMETime at which the call is picked up by the agent.
CALL_END_TIMETime at which the call is ended, either by the agent, user, or due to an error.
CALL_WRAPUP_TIMETime at which the ticket status transitions to wrap-up after the call ends.
CALL_WRAPUP_DURATIONDuration between the ticket resolved time and ticket wrap-up time.
CALL_RECORDING_URLURL link to the call recording (audio) between the agent and the customer.
CALL_QUEUE_START_TIMEQueued time of the ticket or call.
CALL_QUEUE_WAIT_TIMEDuration between the first time the ticket is queued and the pickup time.
CALL_ASSIGNED_TIMETime at which the ticket is assigned to an agent.
CALL_CSAT_AGENT_SCOREThe default Customer Satisfaction (CSAT) feedback received for the agent after the voice call.
CALL_CSAT_TICKET_SCOREThe default CSAT feedback received for the overall ticket after the voice call.
TIMESTAMPCreated time of this voice call on the inbox.
QUEUE_DROP_OFF_TYPEIndicates whether the user dropped off from the queue and the reason for the drop-off.
QUEUE_DROP_OFF_TIMETime at which the user dropped off from the queue.
REQUEUE_COUNTNumber of times the call or ticket was requeued.
DISCONNECTED_BYIndicates which peer (agent or user) hung up the call.

Inbox events

FieldDescription
TIMESTAMPThe date and time when the event was triggered.
AGENTIDUnique Identifier (UID) for agents, used for internal purposes.
BIDBusiness Identifier - a distinctive identifier for the business involved.
CATEGORYThe name or code of the group to which the raised Inbox ticket belongs.
SOURCEThe communication channel through which the user is engaging with the bot (e.g., Whatsapp, Facebook, Yellow Messenger).
UIDUser Identifier - a unique identifier assigned to each user for tracking and distinction.
EVENTIndicates the status of the event, such as assigned, missed, open, queued, reassigned, resolved, or answered.

Events description

Event NameDescription
assignedTriggered when a chat is assigned to an agent for resolution.
missedTriggered when a chat transitions into the "Missed" status.
openTriggered when a chat enters the "Open" status due to the absence of available agents.
queuedTriggered when a chat is placed in a queue, typically due to agent unavailability or full chat concurrency.
reassignedTriggered when a chat is reassigned from one agent to another.
resolvedTriggered when an agent clicks "Resolve" to mark the chat as resolved or the chat is auto-closed.
answeredTriggered when the agent has responded to the ticket at least once.

Knowledge base report

FieldDescription
TIMESTAMPTime at which the query was made to the Language Model (LLM)
ORIGINAL_QUERYMessage typed out by the user (Input)
CONV_HISTORYPrevious user and bot messages before the user's message
REPHRASED_QUERYTrue query considering context from conversational history
DOCUMENT_TAGSDocument tag values, if any, passed
WAS_SUMMARY_GIVENTrue or false value stating if the response was summarized
ANSWERCopy of the answer provided by the bot to the asked query
LINKSCopy of the web links provided by the bot
SITE_KEYWebsite domain based on which the answer was retrieved
UIDUnique user ID of the user having the conversation
TRACE_IDUnique ID of the query for further analysis on search

Knowledge base articles

FieldDescription
ARTICLE_IDIdentity number assigned to the article during its creation.
ARTICLE_TITLETitle of the published article.
VISIBILITYVisibility status selected during article creation, either Internal or External.
SUBCATEGORYThe immediate folder or subcategory under which the article is organized.
PARENT_CATEGORYThe name of the top-level category under which the article is classified.
VIEWSThe number of views received by this particular article.
LIKESThe number of likes received on this particular article.
DISLIKESThe number of dislikes received on this particular article.
LANGUAGEThe language selected during article creation; the article is visible on the website in this specified language.
PUBLISHED_ATThe timestamp indicating when the article was published.

Message events

FieldDescription
TIMESTAMPThe TIMESTAMP field represents time intervals in 1-minute slots within a 24-hour day. When an event occurs, its timestamp is rounded to the nearest 1-minute interval. The first occurrence creates a new row with the timestamp, and if the same event occurs again within the same 1-minute slot, the count column value for that timestamp is incremented by 1. This allows tracking the number of occurrences of the same event within each 1-minute interval. Subsequent occurrences in the same interval contribute to the count column value. For example: Suppose an event occurs at 9:46:24, its timestamp would be 9:46, creating a new row. If the same event happens at 9:46:37, the count becomes 2 for the 9:46 timestamp. Another event at 10:13:47 creates a new row with a timestamp of 10:13. The count column tracks repeated occurrences within the same 1-minute slot. Ex: 00:00:00 UTC.
CITYUser's city retrieved from the IP address. String data type.
COUNTRYUser's country retrieved from the IP address. String data type.
DEVICEUser's device type, such as Desktop, Tablet, or Mobile. String data type.
IPUser's IP address. Integer data type.
MESSAGETYPEType of the message sender, e.g., BOT, USER, AGENT, NOTIFICATION.
PLATFORMUser's device operating system, e.g., Windows, Linux, etc. String data type.
REGIONUser's state retrieved from the IP address. String value.
SOURCEChannel in which the user is chatting with the bot. Example: Whatsapp, Facebook, yellowmessenger.
UIDUnique Identifier of the User.
SESSIONIDUnique Identifier per session.
SESSION_SUMSeconds since the last message. The time is stored in seconds from the previous User/Bot/Agent message.
CUSTOMID1Custom Identifier from Customer Data Platform (CDP).
CUSTOMID2Custom Identifier from Customer Data Platform (CDP).
UTM_CAMPAIGNAssociated with the campaign's name from the Engage module.
UTM_MEDIUMAssociated with the campaign's medium from the Engage module.
UTM_SOURCEAssociated with the campaign's source from the Engage module.
LANGUAGELanguage identified by our platform during the ongoing interaction.
BIDBusiness Identifier.
INTERACTIONTYPEUser input classification, e.g., user chose a quick reply or typed the input.
COUNTRolled-up value of that event where data was exactly the same, just a difference in time. Associated with timestamp description.
identificationStatusDenotes if a user message was identified/unidentified.
lastMessageTypeDenotes if the last message in the chat was from the Bot/User/Agent.

Notifications report

FieldDescription
NAMEName of the campaign
CAMPAIGNIDUnique ID assigned to the campaign.
REPORTIDUnique ID assigned to the campaign report.
SENDERIDAlphanumeric or numeric string that identifies the sender of a message
USERIDUnique ID for each User present in the User360 Table
CDPUSERIDUnique ID of the user (in User360) to whom the campaign was sent
TEMPLATEIDUnique ID of the template used in the campaign
MESSAGEIDUnique ID assigned to the message within the campaign sent to the user.
STATUS
SOURCEChannel through which the campaign message was sent. Example: Whatsapp, Facebook, yellowmessenger
SMSUNITSThe number of SMS units consumed for a single message in the campaign.
SCHEDULEDATDate and time when the campaign was scheduled to send.
SENTATDate and time when the campaign was sent
DELIVEREDATDate and time when the campaign was successfully delivered.
READATDate and time when the recipient read the campaign message
REPLIEDATDate and time when the recipient replied to the campaign
REPLYContent of the reply received from the recipient
ERRORMESSAGEAny error message generated during the campaign delivery process.

User engagement events

Following are the fields tracked on the user engagement events table:

FieldDescription
TIMESTAMPThe TIMESTAMP field represents time intervals in 30-minute slots within a 24-hour day. When an event occurs, its timestamp is rounded to the nearest 30-minute interval. The first occurrence creates a new row with the timestamp, and if the same event occurs again within the same 30-minute slot, the count column value for that timestamp is incremented by 1. This allows tracking the number of occurrences of the same event within each 30-minute interval. Subsequent occurrences in the same interval contribute to the count column value. For example: Suppose an event occurs at 9:46, its timestamp would be 9:30, creating a new row. If the same event happens at 9:59, the count becomes 2 for the 9:30 timestamp. Another event at 10:13 creates a new row with a timestamp of 10:00. The count column tracks repeated occurrences within the same 30-minute slot.
BIDBusiness Identifier, a unique identifier for the business associated with the event.
CATEGORYAn umbrella term for journeys; certain journeys can be grouped under this category.
CITYApproximate city location identified by the platform.
COUNTRYApproximate country location identified by the platform.
CUSTOMID1Custom Identifier from Customer Data Platform (CDP).
CUSTOMID2Custom Identifier from Customer Data Platform (CDP).
DEVICEApproximate user device value identified by the platform, such as mobile or desktop.
EVENTThe specific event that occurred.
EVENTINFOAdditional information stored by the platform (not for customer customization).
JOURNEYThe flow name under which this event was generated.
PLATFORMApproximate underlying platform of the user device (e.g., Desktop can have Windows, Linux).
STEPStep name in the Automation flow under which this event was generated.
REGIONGeographical location (state) identified where the bot is being used.
SOURCEDifferent channel integration from where the user triggered the event, such as Yellowmessenger, WhatsApp, etc.
TARGETINFOUsed for storing additional information for some events, such as journey switched.
UIDUnique Identifier of the User.
SESSIONIDUnique Identifier of the User for a 24-hour timeframe from the first event triggered by the user.
LANGUAGELanguage identified by the platform during the ongoing interaction.
INTERACTIONTYPEUser input classification, for example, whether the user chose a quick reply or typed the input.
COUNTRolled-up value of the event where the data was exactly the same, with differences only in time (this is associated with the timestamp description).
VALUEThe VALUE field is used for pushing a numerical value associated with an event. By default, if no specific value is provided, it is set to 0. This field allows you to convey a quantitative aspect related to the event, providing additional context or information.

Events description

Following are the events tracked on the user engagement events table:

EventDescription
agent-sessionFired when a new agent session is created. An agent session is initiated with the creation of the first ticket and lasts for 24 hours. Any subsequent tickets created within this timeframe are considered part of the same agent session. Therefore, the number of agent sessions will always be less than or equal to the number of tickets created
agent-transferFired when a chat conversation is transferred to a live agent
banner-cta-clickedFired when the User clicks on the link configured in the callout banner
bot-closedFired when the Bot is closed by the user (close button)
bot-icon-clickedFired when the Bot avatar (in title bar) is clicked by the user
bot-icon-loadedFired when the Bot avatar is displayed to the user (on load)
bot-loadedFired when the Bot script is loaded on the website
bot-openedThis occurs when a user clicks on the chat bubble to open the bot.
bot-sessionFired when a session is created based on a bot message (first message sent by the bot). It has a session time window of 24hrs for a given UID and source
business-initiatedFired when a new session is created by notification from the business side for the WhatsApp channel
card-cta-clickedFired when the User clicks on the link configured in the card buttons
condition-recordedFired when a condition node is executed in a flow
feedbackFired when a user gives feedback after completing the chat
first-messageFired when a new profile of a user is created
first-message-bidFired when a user profile is updated with the bid for the first time
home-button-clickFired when a user clicks on the home button in the chat widget
invalid-responseFired when an invalid response other than the provided option is selected/entered by the user
journey-completedFired when a journey gets completed for the user
journey-startedFired when a journey starts for the user
journey-switchedFired when a journey is switched by NLP System for the user due to utterance matching another journey
message-hyperlink-clickedFired when the User clicks on the link configured in the text message
new-sessionFired when a new session is created
notification-receivedFired when a notification is received on the mobile widget
optinFired when a WhatsApp opt-in is added
optoutFired when a WhatsApp opt-out is added
otp-sentFired when an OTP sent from the bot using the platform function
otp-verifiedFired when an OTP is verified from the bot using the platform function
page-loadedFired every time the client website page is loaded/reloaded where our script is running
pwa-loadedFired when the PWA version of the bot script is loaded
pwa-openedFired when the PWA bot is opened by the user
step-expectedFired when a step of the journey is expected / prompt is shown to the user
step-recordedFired when input is given by the user for a step (step value is recorded) of a journey
unidentified-utteranceFired when a user message is not understood by the Bot
user-initiatedFired when a new session is created from a user message for the WhatsApp channel
user-revisitedFired when the chat widget loads for the user's IP address on subsequent visits. This event is specific to bots hosted on websites.
user-sessionFired when a session is created based on a USER message
user-visitedFired when the chat widget loads for the user's IP address for the first time. This event is triggered once for the lifetime of the user's unique ID. It is specific to bots hosted on websites

Other events:

  • inbound-overlay-closebtn
  • inbound-overlay-conversion
  • inbound-overlay-impression
  • inbound-widget-closebtn
  • inbound-widget-conversion
  • inbound-widget-impression

User feedback

FieldDescriptionValue Format
BOTIDBot ID assigned by the platform.Integer (e.g., x1657623696077)
UIDUser ID generated by the platform.Integer (e.g., 1836013421788526118418800767619)
SESSIONIDSession ID generated by the platform.String (e.g., 65a8d2971e1a2100011a2433)
SURVEYTYPEType of feedback collected in the Feedback card.String (e.g., Star, Thumbs)
NODETYPEType of node, indicating PROMPT_FEEDBACK or MESSAGE_FEEDBACK.String
JOURNEYNAMEJourney/Flow name where the feedback card is configured.String
JOURNEYSLUGJourney slug where the feedback card is configured.String (e.g., new-feedback-flow_ysdkao)
STEPSLUGStep slug where the feedback card is configured.String (e.g., ae4c7ac271f37ccd)
SOURCEChannel from which the user has visited (always yellowmessenger).String
RATINGRating given by the user in the Feedback card (1 to 5).Integer (e.g., 1, 2, 3, 4, 5)
SCALEScale in the Feedback card (2 for Thumbs, 5 for Star).Integer
FEEDBACKSText feedback given by the user.String (e.g., ["Quick resolution"])
CUSTOMTAGPlaceholder for custom tags (Not Applicable).Not Applicable
RESPONSEFeedback quality given by the user (Positive: 3/4/5 in star, Negative: 1/2 in star).String
CREATEDATFeedback submission date & time.Date (e.g., Thu Jan 18 2024 12:56 PM)
LASTBOTMESSAGELast message sent by the bot before collecting feedback.String
LASTUSERMESSAGELast message sent by the user before collecting feedback.String

Video chats

FieldDescription
TICKET_IDAuto-generated reference number assigned to each incoming ticket.
CHILD_BOT_IDBot ID of the child bot if orchestrator parent bot and unified inbox are enabled.
AGENT_NAMEName of the Inbox Support Agent handling the ticket (e.g., Amudhan S).
AGENT_USERNAMEEmail of the Inbox Support Agent without special characters (e.g., amudhanyellowai).
CLIENT_EMAILCustomer's email ID if provided.
CLIENT_NAMECustomer's name if provided.
CALL_DURATION_IN_SECONDSDuration of the video call in seconds (difference between start and end time).
START_TIMETimestamp indicating the start time of the video call.
END_TIMETimestamp indicating the end time of the video call.
MEETING_IDUnique identifier assigned to each meeting.
MEETING_NAMEInternal string for meeting identification (e.g., ${ticket.botId}_${ticket.ticketId}_${ticket.assignedTo}_${ticket.uid}).
MEETING_END_REASONReason for the completion of the meeting, typically when all the participants leave.
DID_AGENT_JOINIndicates whether the agent joined the call.
DID_CLIENT_JOINIndicates whether the user joined the call.
WHO_HUNG_UPSpecifies who initiated the call hang-up.
RECORDING_IDIdentifier number assigned to each recording.
RECORDING_STATUSProcessing status of the recording (e.g., pending, completed).

Analytics (Custom table)

Analytics table can be found under custom tables in which the following data is captured.

FieldsDescription
CHATURLLink to Chat Transcript: e.g. https://app.yellow.ai/public/messages/a9c9844ad89bb7aeb6a3918ad57623c37616acfc6c094e3b529ad0a763323f9e687450946280f5eca561274bdc0d6360510eff61eb0b24d55cb5c1e7092c/660a37f54a1f6800016fd072
TIMESTAMPDate and Time when event was triggered: Sun Mar 31 2024 11:28 PM
AEVENTEvent triggered upon an action. This includes both OOB, and custom events configured in the bot: e.g. welcome_message, kb_question_not_answered, booking_done
MESSAGEIDUnique ID set in backend for each message: e.g. 123456789
PROFILE_PLATFORMPlatform through which user accessed the chatbot: e.g. Web, SDK
PROFILE_BROWSERBrowser through which user accessed the chatbot: e.g. Safari, Chrome, Mozilla
PROFILE_CITYCity of user accessed the chatbot (fetched from IP address): e.g. San Francisco, New York City
PROFILE_COUNTRYCountry of user that accessed the chatbot (fetched from IP address): e.g. India, Abu Dhabi
PROFILE_COUNTRY_CODECountry code of user that accessed the chatbot (fetched from IP address): e.g. US, CA, IN
PROFILE_DEVICEType of device from which the user accessed the chatbot: e.g. Mobile, Desktop, Tablet
PROFILE_IPIP address of the user: e.g. 192.168.1.1
PROFILE_LATITUDELatitude value of user's location: e.g. 39.73915
PROFILE_LONGITUDELongitude value of user's location: e.g. -104.9847
PROFILE_NAME(User) Profile name set up in backend. This will be random values so that user privacy is maintained: e.g. John Doe, Jane Smith
PROFILE_OSOperating system through which user accessed the chatbot: e.g. Windows 10.0, macOS 10.15.7
PROFILE_PAGEURLURL of the page from which the user accessed the chatbot. e.g. https://yellow.ai
PROFILE_DEVICETYPEType of device from which the user accessed the chatbot: e.g. Microsoft Windows, Apple Mac
PROFILE_REGIONRegion of user that accessed the chatbot (fetched from IP address): e.g. California, Florida
PROFILE_SOURCEDevice, OS, and Browser details of the user: e.g. Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36
PROFILE_TIMEZONETimezone of user's location: e.g. -04:00, +05:30
PROFILE_USERAGENT_BROWSERBrowser used by the agent to whom the user is connected to: e.g. Safari, Chrome, Mozilla
PROFILE_USERAGENT_DEVICEDevice used by the agent to whom the user is connected to: e.g. Mobile, Desktop, Tablet
PROFILE_USERAGENT_OSOS of the device used by the agent to whom the user is connected to: e.g. Windows 10.0, macOS 10.15.7
PROFILE_USERAGENT_PLATFORMPlatform used by the agent to whom the user is connected to: e.g. Web, SDK
PROFILE_USERAGENT_SOURCEDevice, OS, and Browser details of the agent to whom the user is connected to: e.g. Microsoft Windows, Apple macOS
PROFILE_WIDGETVERSIONVersion of the chat widget accessed by the user: e.g. V1, V2
SOURCEChannel in which the user is chatting with the bot: e.g. Whatsapp, Facebook, yellowmessenger
UIDUnique Identifier of User: e.g. 10182708542979041342360504723
VALUE
MESSAGEID
PROFILE_END_IP
PROFILE_START_IP
PROFILE_TITLE
PROFILE_UTM_CAMPAIGN
PROFILE_UTM_MEDIUM

Contained resolution analysis

FieldsDescription
Chat URLURL link of the conversation (transcript) between the user and bot/agent
TopicA conversation topic is the primary subject or query the user seeks assistance or information about
Topic DescriptionSummary of the topic discussed
User QuerySummary of the query the user asked the bot or agent
ResolutionSummary of the resolution provided by the bot or agent from the conversation
ContainedIndicates if the chat was solely handled by the bot or transferred to an agent. If True, the query was handled/contained by the bot. If False, both bot and agent handled the query
Analysis TypeThis value states whether the conversation that was analysed was between user & bot, or user & agent
AutomationIndicates if the resolution can be added to the bot's knowledge base and if it can be automated. For user-bot conversations, the value is empty. For user-agent conversations, it can be either True or False
Automation ReasonReason provided by the model for marking automation as True or False
Resolution StatusIndicates whether the user’s query was successfully addressed by the bot/agent (Possible values: Resolved or Unresolved)
User SentimentOverall sentiment of the user (Possible values: Positive/Negative/Neutral)
User IDUnique ID for each user
Session IDSession ID generated by the platform for each session
SourceChannel where the conversation happened (e.g., WhatsApp, Facebook, yellowmessenger, etc.)
Conversation Start TimeTime at which the conversation started
Conversation End TimeTime at which the conversation ended
TimestampThe date and time when the report was generated and added to data explorer

LLM usage metrics

FieldDescriptionValue
TIMESTAMPTimeDatetime
SENDERSender ID/UID of the userString
SESSION_IDSession ID of the userString
TRACE_IDTrace ID of the messageString
SOURCESource of the message (YM/WhatsApp/etc.)String
SUCCESSWhether the API call returned a response or notBoolean
PROVIDERLLM Service Provider (Open AI, Azure Open AI, etc.)String
MODELName of the modelString
RESOURCEName of the resource (only in the case of Azure Open AI)String
EXECUTION_TIMETime taken by the LLM API callMilliseconds
PROMPT_TOKENSNumber of tokens in the input promptNumber
COMPLETION_TOKENSNumber of tokens in the generated responseNumber
TOTAL_TOKENSSum of PROMPT_TOKENS and COMPLETION_TOKENSNumber
CUSTOM_LLM_KEYTrue if the client is using their own credentials; otherwise FalseBoolean
WORKFLOWWorkflow ID of the flow where the node is presentString
NODE_IDNode ID of the nodeString

WhatsApp consumption

FieldDescription
TIMESTAMPThe day the count is calculated
WABA_IDUnique WhatsApp Business Account ID provided by Meta
PHONE_NUMBERWhatsApp business phone number linked to the customer
BUSINESS_INITIATED_AUTHENTICATIONConversations for authenticating users with one-time passcodes, such as account verification, recovery, or integrity challenges
BUSINESS_INITIATED_MARKETINGConversations for marketing purposes like new product announcements, targeted promotions, or cart abandonment reminders
BUSINESS_INITIATED_UTILITYConversations for follow-ups on user actions or requests, such as order updates, account alerts, or feedback surveys
USER_INITIATED_SERVICEConversations for resolving customer inquiries
CONVERSATION24-hour message threads between you and your customers, opened and charged when your messages are delivered

info

Time is mentioned in milliseconds.