AgentWorkConversationalData

Stores conversation data for agent work sessions, such as agent interactions, transfer information, and operational metrics.

Introduced in API version 66.0.

describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

  • You must have the Agentforce Contact Center Admin (Salesforce Voice) permission set enabled in your org.
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    Identifier for the recording associated with the agent channel conversation.

    This field is a relationship field.

  • Relationship name: AgentChannelRecording

  • Relationship type: relationship

  • Refers to: VoiceCallRecording

  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: Timestamp for when the agent connected to the conversation.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: Timestamp when the service rep and customer conversations are merged after consultation.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: Timestamp for when the agent disconnected from the conversation.
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    ID of an agent or a rep involved in the conversation.

    This field is a polymorphic relationship field.

  • Relationship name: Agent

  • Relationship type: polymorphic

  • Refers to: User, ExternalConversationBotDef, BotDefinition, AiAgent

  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Description: Type of agent handling the conversation.
  • Possible values:
    • ExternalBot — ExternalBot
    • Human — Human
    • InternalBot — InternalBot
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    ID of the AgentWork record associated with the conversational data.

    This field is a relationship field.

  • Relationship name: AgentWork

  • Relationship type: relationship

  • Refers to: AgentWork

  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 68.0
  • Description: Average inter-arrival jitter of RTP packets on the agent leg over the entire call duration, measured in milliseconds. Higher values indicate inconsistent packet timing, which can cause audio choppiness. This field is available in API version 68.0 and later, and only in Salesforce Voice (Native Telephony).
  • Type: percent
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 68.0
  • Description: Average percentage of RTP packets lost on the agent leg over the entire call duration. Higher values indicate sustained network degradation, which can cause audio gaps. This field is available in API version 68.0 and later, and only in Salesforce Voice (Native Telephony).
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    Identifier of the channel session for the conversation.

    This field is a relationship field.

  • Relationship name: ChannelSessionRecord

  • Relationship type: relationship

  • Refers to: VoiceCall

  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: Duration of the longest pause during the conversation, measured in seconds.
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 68.0
  • Description: Maximum inter-arrival jitter of RTP packets on the agent leg, measured in milliseconds over rolling 5-second windows. Captures sudden, temporary timing spikes that cause brief audio choppiness, even if the overall call average appears stable. This field is available in API version 68.0 and later, and only in Salesforce Voice (Native Telephony).
  • Type: percent
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 68.0
  • Description: Maximum percentage of RTP packets lost on the agent leg, measured over rolling 5-second windows. Captures sharp bursts of packet loss that call-wide averages can mask. This field is available in API version 68.0 and later, and only in Salesforce Voice (Native Telephony).
  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: Name of the agent work conversational data record.
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    ID of the next record in a sequence of conversations.

    This field is a relationship field.

  • Relationship name: NextAgentWorkConv

  • Relationship type: relationship

  • Refers to: AgentWorkConversationalData

  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: Timestamp for when ownership of the conversation ended.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: Timestamp for when ownership of this conversation started.
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: Total number of times the conversation was paused.
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    ID of the previous record in a sequence of conversations.

    This field is a relationship field.

  • Relationship name: PrevAgentWorkConv

  • Relationship type: relationship

  • Refers to: AgentWorkConversationalData

  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: Value of the Mean Opinion Score (MOS) that measures voice call quality.
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: Total duration of all pauses during the conversation, measured in seconds.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Description: Type of transfer for the conversation.
  • Possible values:
    • Cold — Cold
    • Warm — Warm