REST Resource: projects.conversations.participants

Resource: Participant

Represents a conversation participant (human agent, virtual agent, end-user).

JSON representation
{
  "name": string,
  "role": enum (Role),
  "sipRecordingMediaLabel": string
}
Fields
name

string

Optional. The unique identifier of this participant. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>/participants/<Participant ID>.

role

enum (Role)

Immutable. The role this participant plays in the conversation. This field must be set during participant creation and is then immutable.

sipRecordingMediaLabel

string

Optional. Label applied to streams representing this participant in SIPREC XML metadata and SDP. This is used to assign transcriptions from that media stream to this participant. This field can be updated.

Role

Enumeration of the roles a participant can play in a conversation.

Enums
ROLE_UNSPECIFIED Participant role not set.
HUMAN_AGENT Participant is a human agent.
AUTOMATED_AGENT Participant is an automated agent, such as a Dialogflow agent.
END_USER Participant is an end user that has called or chatted with Dialogflow services.

Methods

analyzeContent

Adds a text (chat, for example), or audio (phone recording, for example) message from a participant into the conversation.

create

Creates a new participant in a conversation.

get

Retrieves a conversation participant.

list

Returns the list of all participants in the specified conversation.

patch

Updates the specified participant.