LiveChatTranscriptEvent
Captures specific events that occur over the lifetime of a chat.
Introduced in API version 24.0.
create(), delete(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()
- Type: reference
- Properties: Create, Filter, Group, Nillable, Sort
- Description: The ID of the agent associated with the event.
- Relationship name: Agent
- Relationship type: relationship
- Refers to: User
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort
- Introduced: API version 28.0
- Description: Details associated with the event.
- Type: reference
- Properties: Create, Filter, Group, Sort
- Description: The ID of the live chat transcript associated with the event.
- Relationship name: LiveChatTranscript
- Relationship type: masterdetail
- Refers to: LiveChatTranscript
- Type: string
- Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
- Description: The name of the event.
- Type: datetime
- Properties: Create, Filter, Sort
- Description: The time at which the event happened.
- Type: picklist
- Properties: Create, Filter, Group, Restricted picklist, Sort
- Description: The kind of event that occurred.
- Possible values:
- Accept — Accept — Accepted
- AgentBlocked — AgentBlocked — Blocked by Agent
- AlertCriticalWaitChat — AlertCriticalWaitChat — Critical Wait Alert Time Reached
- CancelBlocked — CancelBlocked — Cancel (Blocked)
- CancelNoAgent — CancelNoAgent — Cancel (No Agent)
- CancelNoQueue — CancelNoQueue — Cancel (No Queue)
- CancelVisitor — CancelVisitor — Canceled by Visitor
- ChasitorIdleTimeout — ChasitorIdleTimeout — Visitor Idle Time-Out
- ChasitorIdleTimeoutWarningCleared — ChasitorIdleTimeoutWarningCleared — Visitor Idle Time-Out Warning Cleared
- ChasitorIdleTimeoutWarningTriggered — ChasitorIdleTimeoutWarningTriggered — Visitor Idle Time-Out Warning Appeared
- ChatRequest — ChatRequest — Chat Requested
- ChatResumedAfterTransfer — ChatResumedAfterTransfer — Chat resumed
- ChatbotEndChat — ChatbotEndChat — Chatbot end chat
- ChatbotEndedChatByAction — ChatbotEndedChatByAction — Conversation ended by automated action
- ChatbotEstablished — ChatbotEstablished — Accepted by Chatbot
- ChatbotNotEstablished — ChatbotNotEstablished — Chatbot Request Failed
- ChoiceRoute — ChoiceRoute — Routed (Choice)
- ClearCriticalWaitChat — ClearCriticalWaitChat — Critical Wait Alert Cleared
- ConferenceRequest — ConferenceRequest — Chat Conference Requested
- ConferenceRequestCanceled — ConferenceRequestCanceled — Chat Conference Canceled
- ConferenceRequestDeclined — ConferenceRequestDeclined — Chat Conference Declined
- ConnectionTimeout — ConnectionTimeout — Visitor connection timed out. Available in API version 38.0 and later.
- ConnectionWarning — ConnectionWarning — Warning that visitor hasn’t been connected for some time and that the connection times out soon. Available in API version 38.0 and later.
- DeclineManual — DeclineManual — Decline (Manual)
- DeclineTimeout — DeclineTimeout — Decline (Timeout)
- EndAgent — EndAgent — Ended by Agent
- EndVisitor — EndVisitor — Ended by Visitor
- Enqueue — Enqueue — Queued
- FileCanceledAgent — FileCanceledAgent — File Transfer Canceled by Agent
- FileCanceledChasitor — FileCanceledChasitor — File Transfer Canceled by Visitor
- FileTransferFailure — FileTransferFailure — File Transfer Failure
- FileTransferRequested — FileTransferRequested — File Transfer Requested by Agent
- FileTransferSuccess — FileTransferSuccess — File Transfer Success
- FileTransferToChasitor — FileTransferToChasitor — File Transfer Initiated by Agent
- FlagLoweredAgent — FlagLoweredAgent — Flag Lowered by Agent
- FlagLoweredSupervisor — FlagLoweredSupervisor — Flag Lowered by Supervisor
- FlagRaised — FlagRaised — Flag Raised
- LeaveAgent — LeaveAgent — Agent Left
- LeaveVisitor — LeaveVisitor — Visitor Left
- OperatorJoinedConference — OperatorJoinedConference — Agent Joined Conference
- OperatorLeftConference — OperatorLeftConference — Agent Left Conference
- Other — Other
- PushAssignment — PushAssignment — Routed (Push)
- SensitiveDataAgent — SensitiveDataAgent — Sensitive data blocked (Agent)
- SensitiveDataSupervisor — SensitiveDataSupervisor — Sensitive data blocked (Supervisor)
- SensitiveDataVisitor — SensitiveDataVisitor — Sensitive data blocked (Visitor)
- Transfer — Transfer — Transfer Accepted
- TransferCancelled — TransferCancelled — Transfer Request Canceled
- TransferDeclined — TransferDeclined — Transfer Request Declined
- TransferRequest — TransferRequest — Transfer Requested
- TransferToBotFailed — TransferToBotFailed — Transfer to bot failed
- TransferToButtonFailed — TransferToButtonFailed — Transfer to button failed
- TransferToQueueFailed — TransferToQueueFailed — Transfer to queue failed
- TransferredToBot — TransferredToBot — Transferred to bot
- TransferredToButton — TransferredToButton — Transferred to button
- TransferredToQueue — TransferredToQueue — Transferred to queue
- TransferredToSbrSkill — TransferredToSbrSkill — Transferred to skill
- TransferredToSbrSkillFailed — TransferredToSbrSkillFailed — Transfer to skill failed
- Unassigned — Unassigned
Use this object to query and manage live chat transcript events.
LiveChatTranscriptEvent records are inserted after the chat is closed and the LiveTranscript record updated). However, the trigger on the LiveChatTranscriptEvent sObject fires separately on each LiveChatTranscriptEvent record within the same transaction.
All the LiveChatTranscriptEvent records are inserted in a single transaction but one by one. For example, the trigger is executed for each individual record.
To avoid hitting any governors and limits, design your functionality considering this behavior. You can execute the logic by filtering the records based on the Type field of LiveChatTranscriptEvent.
This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version.
- LiveChatTranscriptChangeEvent: Introduced in API version 62.0.