--- schema_version: "1" id: 1a9fc7b1a7f0f623792f04835b71b0caa961754c01b260931989a274276ff200 title: LiveChatTranscript collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_livechattranscript.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_livechattranscript.htm source_site: developer.salesforce.com content_type: documentation content_hash: b56b1e1e80e8dfdfb65b8c796716f41670c270a76488370f578aa88729b6695b description: This object is automatically created for each Live Agent chat session and stores information about the session. This object is available in API version 24.0 and later. --- # LiveChatTranscript This object is automatically created for each Live Agent chat session and stores information about the session. This object is available in API version 24.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field Name | Details | | --- | --- | | Abandoned | Type int Properties Filter, Group, Nillable, Sort Description The amount of time in seconds an incoming chat request remained unanswered by an agent before the chat was disconnected by the customer. | | AccountId | Type ID Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the account associated with the chat transcript. | | AverageResponseTimeOperator | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The agent’s average response time (in seconds) to chat messages from the visitor. | | AverageResponseTimeVisitor | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The visitor’s average response time (in seconds) to chat messages from the agent. | | Body | Type textarea Properties Create, Nillable, Update Description The contents of the chat. | | Browser | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The browser the visitor used for the chat. | | BrowserLanguage | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The language of the visitor’s browser. | | CaseID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the case associated with the chat transcript. | | ChatDuration | Type int Properties Filter, Group, Nillable, Sort Description The total duration of the chat in seconds. | | ChatKey | Type string Properties Create, Filter, Group, idLookup, Nillable, Sort Description The session ID of the chat before it is persisted. ChatKey can be used with advanced integrations in the Salesforce console. This field is available in API version 25.0 and later. | | ContactID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the contact associated with the chat transcript. | | EndedBy | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The way the chat was ended: by the operator, the visitor, or the system. | | EndTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The time the chat ended. | | IpAddress | Type string Properties Create, Filter, Nillable, Sort, Update Description The auto-populated visitor’s IP address. Do not edit. Create a custom field if you need an IP address field for your use case. | | IsChatbotSession | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Whether the visitor is chatting with a chatbot (true) or not (false). | | LastReferencedDate | Type date Properties Filter, Nillable, Sort, Update Description The timestamp for when the current user last viewed a record related to this record. | | LastViewedDate | Type date Properties Filter, Nillable, Sort, Update Description The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed. | | LeadID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the lead associated with the chat transcript. | | LiveChatButtonID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the LiveChatButton the chat session originated from. | | LiveChatDeploymentID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the LiveChatDeployment the chat session originated from. | | LiveChatVisitorID | Type reference Properties Create, Filter, Group, Sort Description The ID of the visitor associated with the chat transcript. | | Location | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The auto-populated best-guess approximation of the visitor’s location. Do not edit. | | MaxResponseTimeOperator | Type int Properties Filter, Group, Nillable, Sort Description The maximum time in seconds it took an agent to respond to a chat visitor’s message. | | MaxResponseTimeVisitor | Type int Properties Filter, Group, Nillable, Sort Description The maximum time in seconds it took a customer to respond to an agent’s message. | | Name | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The name of the transcript. | | OperatorMessageCount | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of messages sent by one or more agents during the chat. | | OwnerID | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the operator who participated in the chat last; for missed chats, this is a system user. | | Platform | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The visitor’s operating system platform. | | ReferrerUri | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The auto-populated URI where the chat request originated. Do not edit. | | RequestTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The time the visitor requested the chat. | | ScreenResolution | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The visitor’s screen resolution. | | SkillId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The auto-populated record ID of the primary Skill associated with the LiveChatButton the chat session originated from. Do not edit. To associate multiple skills with a LiveChatTranscript, use LiveChatTranscriptSkill junction objects. | | StartTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The time the chat started. | | Status | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The final status of the chat: completed, missed, or blocked. | | SupervisorTranscriptBody | Type textarea Properties Create, Nillable, Update Description The text body of the supervisor’s chat transcript. | | UserAgent | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The visitor’s user agent string. | | VisitorMessageCount | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of messages sent by the visitor during the chat. | | VisitorNetwork | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The network or service provider the chat visitor used for the chat. | | WaitTime | Type int Properties Filter, Group, Nillable, Sort Description The total amount of time in seconds a chat request was waiting to be accepted by an agent. | ## Usage Use this object to query and manage live chat transcripts. ## Associated Objects 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 and later. [LiveChatTranscriptChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 44.0) Change events are available for the object. [LiveChatTranscriptFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") (API version 47.0) Feed tracking is available for the object. [LiveChatTranscriptHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [LiveChatTranscriptOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") (API version 29.0) Sharing rules are available for the object. [LiveChatTranscriptShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.