> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # genesys-conversations-digital > Genesys Digital Channels - chat, email, message, cobrowse, video, fax, and social conversation management **Server path:** `/genesys-conversations-digital` | **Type:** Application | **PCID required:** Yes ## Tools | Tool | Description | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`genesys_conversations_digital_delete_email_messages_draft_attachment`](#genesys_conversations_digital_delete_email_messages_draft_attachment) | Delete attachment from draft | | [`genesys_conversations_digital_get_cobrowsesession`](#genesys_conversations_digital_get_cobrowsesession) | Get cobrowse conversation | | [`genesys_conversations_digital_get_cobrowsesessions`](#genesys_conversations_digital_get_cobrowsesessions) | Get active cobrowse conversations for the logged in user | | [`genesys_conversations_digital_get_email`](#genesys_conversations_digital_get_email) | Get email conversation | | [`genesys_conversations_digital_get_email_message`](#genesys_conversations_digital_get_email_message) | Get conversation message | | [`genesys_conversations_digital_get_email_messages`](#genesys_conversations_digital_get_email_messages) | Get conversation messages | | [`genesys_conversations_digital_get_email_messages_draft`](#genesys_conversations_digital_get_email_messages_draft) | Get conversation draft reply | | [`genesys_conversations_digital_get_email_participant_communication_wrapup`](#genesys_conversations_digital_get_email_participant_communication_wrapup) | Get the wrap-up for this conversation communication. | | [`genesys_conversations_digital_get_email_participant_wrapup`](#genesys_conversations_digital_get_email_participant_wrapup) | Get the wrap-up for this conversation participant. | | [`genesys_conversations_digital_get_email_participant_wrapupcodes`](#genesys_conversations_digital_get_email_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant | | [`genesys_conversations_digital_get_email_settings`](#genesys_conversations_digital_get_email_settings) | Get emails settings for a given conversation | | [`genesys_conversations_digital_get_emails`](#genesys_conversations_digital_get_emails) | Get the logged-in user's active conversations and their Email participants state. | | [`genesys_conversations_digital_get_internalmessage`](#genesys_conversations_digital_get_internalmessage) | Get internal message conversation | | [`genesys_conversations_digital_get_internalmessages`](#genesys_conversations_digital_get_internalmessages) | Get the logged-in user's active conversations and their InternalMessage participants state. | | [`genesys_conversations_digital_get_message`](#genesys_conversations_digital_get_message) | Get message conversation | | [`genesys_conversations_digital_get_message_communication_messages_media`](#genesys_conversations_digital_get_message_communication_messages_media) | Get message media list by status | | [`genesys_conversations_digital_get_message_communication_messages_media_media_id`](#genesys_conversations_digital_get_message_communication_messages_media_media_id) | Get media | | [`genesys_conversations_digital_get_message_details`](#genesys_conversations_digital_get_message_details) | Get message | | [`genesys_conversations_digital_get_message_message`](#genesys_conversations_digital_get_message_message) | Get conversation message | | [`genesys_conversations_digital_get_message_participant_communication_wrapup`](#genesys_conversations_digital_get_message_participant_communication_wrapup) | Get the wrap-up for this conversation communication. | | [`genesys_conversations_digital_get_message_participant_wrapup`](#genesys_conversations_digital_get_message_participant_wrapup) | Get the wrap-up for this conversation participant. | | [`genesys_conversations_digital_get_message_participant_wrapupcodes`](#genesys_conversations_digital_get_message_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant | | [`genesys_conversations_digital_get_messages`](#genesys_conversations_digital_get_messages) | Get the logged-in user's active conversations and their Message participants state. | | [`genesys_conversations_digital_get_messaging_integrations`](#genesys_conversations_digital_get_messaging_integrations) | Get a list of Integrations | | [`genesys_conversations_digital_get_social_participant_communication_wrapup`](#genesys_conversations_digital_get_social_participant_communication_wrapup) | Get the wrap-up for this conversation communication. | | [`genesys_conversations_digital_get_video_participant_communication_wrapup`](#genesys_conversations_digital_get_video_participant_communication_wrapup) | Get the wrap-up for this conversation communication. | | [`genesys_conversations_digital_get_videos_meeting`](#genesys_conversations_digital_get_videos_meeting) | Gets a record for a given meetingId | | [`genesys_conversations_digital_patch_email`](#genesys_conversations_digital_patch_email) | Update a conversation by disconnecting all of the participants | | [`genesys_conversations_digital_patch_email_messages_draft`](#genesys_conversations_digital_patch_email_messages_draft) | Reset conversation draft to its initial state and/or auto-fill draft content | | [`genesys_conversations_digital_patch_email_participant`](#genesys_conversations_digital_patch_email_participant) | Update conversation participant | | [`genesys_conversations_digital_patch_email_participant_attributes`](#genesys_conversations_digital_patch_email_participant_attributes) | Update the attributes on a conversation participant. | | [`genesys_conversations_digital_patch_email_participant_communication`](#genesys_conversations_digital_patch_email_participant_communication) | Update conversation participant's communication by disconnecting it. This endpoint does not update wrapup. | | [`genesys_conversations_digital_patch_email_participant_parkingstate`](#genesys_conversations_digital_patch_email_participant_parkingstate) | Update conversation by setting its parking state | | [`genesys_conversations_digital_patch_message`](#genesys_conversations_digital_patch_message) | Update a conversation by disconnecting all of the participants | | [`genesys_conversations_digital_patch_message_participant`](#genesys_conversations_digital_patch_message_participant) | Update conversation participant | | [`genesys_conversations_digital_patch_message_participant_attributes`](#genesys_conversations_digital_patch_message_participant_attributes) | Update the attributes on a conversation participant. | | [`genesys_conversations_digital_patch_message_participant_communication`](#genesys_conversations_digital_patch_message_participant_communication) | Update conversation participant's communication by disconnecting it. This endpoint does not update wrapup. | | [`genesys_conversations_digital_patch_message_participant_parkingstate`](#genesys_conversations_digital_patch_message_participant_parkingstate) | Update conversation by setting its parking state | | [`genesys_conversations_digital_post_email_inboundmessages`](#genesys_conversations_digital_post_email_inboundmessages) | Send an email to an external conversation. An external conversation is one where the provider is not PureCloud based. This endpoint allows the sender of the external email to reply or send a new message to the existing conversation. The new message will be treated as part of the existing conversation and chained to it. | | [`genesys_conversations_digital_post_email_messages`](#genesys_conversations_digital_post_email_messages) | Send an email reply | | [`genesys_conversations_digital_post_email_messages_draft_attachments_copy`](#genesys_conversations_digital_post_email_messages_draft_attachments_copy) | Copy attachments from an email message to the current draft. | | [`genesys_conversations_digital_post_email_participant_communication_wrapup`](#genesys_conversations_digital_post_email_participant_communication_wrapup) | Apply wrap-up for this conversation communication | | [`genesys_conversations_digital_post_email_participant_replace`](#genesys_conversations_digital_post_email_participant_replace) | Replace this participant with the specified user and/or address | | [`genesys_conversations_digital_post_email_reconnect`](#genesys_conversations_digital_post_email_reconnect) | Reconnect the user to the most recently disconnected customer on a fully disconnected email conversation | | [`genesys_conversations_digital_post_emails`](#genesys_conversations_digital_post_emails) | Create an email conversation | | [`genesys_conversations_digital_post_emails_agentless`](#genesys_conversations_digital_post_emails_agentless) | Create an email conversation, per API | | [`genesys_conversations_digital_post_faxes`](#genesys_conversations_digital_post_faxes) | Create Fax Conversation | | [`genesys_conversations_digital_post_message_communication_messages`](#genesys_conversations_digital_post_message_communication_messages) | Send message | | [`genesys_conversations_digital_post_message_communication_messages_media_uploads`](#genesys_conversations_digital_post_message_communication_messages_media_uploads) | Create a URL to upload a message media file | | [`genesys_conversations_digital_post_message_communication_socialmedia_messages`](#genesys_conversations_digital_post_message_communication_socialmedia_messages) | Send a social media message | | [`genesys_conversations_digital_post_message_communication_typing`](#genesys_conversations_digital_post_message_communication_typing) | Send message typing event | | [`genesys_conversations_digital_post_message_inbound_open_event`](#genesys_conversations_digital_post_message_inbound_open_event) | Send an inbound Open Event Message | | [`genesys_conversations_digital_post_message_inbound_open_message`](#genesys_conversations_digital_post_message_inbound_open_message) | Send inbound Open Message | | [`genesys_conversations_digital_post_message_inbound_open_receipt`](#genesys_conversations_digital_post_message_inbound_open_receipt) | Send an inbound Open Receipt Message | | [`genesys_conversations_digital_post_message_inbound_open_structured_response`](#genesys_conversations_digital_post_message_inbound_open_structured_response) | Send inbound Open Response | | [`genesys_conversations_digital_post_message_participant_communication_wrapup`](#genesys_conversations_digital_post_message_participant_communication_wrapup) | Apply wrap-up for this conversation communication | | [`genesys_conversations_digital_post_message_participant_monitor`](#genesys_conversations_digital_post_message_participant_monitor) | Listen in on the conversation from the point of view of a given participant. | | [`genesys_conversations_digital_post_message_participant_replace`](#genesys_conversations_digital_post_message_participant_replace) | Replace this participant with the specified user and/or address | | [`genesys_conversations_digital_post_messages`](#genesys_conversations_digital_post_messages) | Create an outbound messaging conversation. | | [`genesys_conversations_digital_post_messages_agentless`](#genesys_conversations_digital_post_messages_agentless) | Send an agentless outbound message | | [`genesys_conversations_digital_post_social_participant_communication_wrapup`](#genesys_conversations_digital_post_social_participant_communication_wrapup) | Apply wrap-up for this conversation communication | | [`genesys_conversations_digital_post_video_participant_communication_wrapup`](#genesys_conversations_digital_post_video_participant_communication_wrapup) | Apply wrap-up for this conversation communication | | [`genesys_conversations_digital_post_videos_meetings`](#genesys_conversations_digital_post_videos_meetings) | Generate a meetingId for a given conferenceId | | [`genesys_conversations_digital_put_email_messages_draft`](#genesys_conversations_digital_put_email_messages_draft) | Update conversation draft reply | *** ## genesys\_conversations\_digital\_delete\_email\_messages\_draft\_attachment Delete attachment from draft **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | | `attachmentId` | string | Yes | — | Attachment Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "attachmentId": { "type": "string", "description": "Attachment Id" } }, "required": [ "PCID", "conversationId", "attachmentId" ] } ``` *** ## genesys\_conversations\_digital\_get\_cobrowsesession Get cobrowse conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_cobrowsesessions Get active cobrowse conversations for the logged in user ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" } }, "required": [ "PCID" ] } ``` *** ## genesys\_conversations\_digital\_get\_email Get email conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_message Get conversation message **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | | `messageId` | string | Yes | — | Message Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "messageId": { "type": "string", "description": "Message Id" } }, "required": [ "PCID", "conversationId", "messageId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_messages Get conversation messages **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `conversationId` | string | Yes | — | Conversation Id | | `includeAgentlessStitchedMessages` | boolean | No | — | Whether to include Agentless 'api' type of messages, on stitched conversations. If you provide a conversationId in the agentless email request (/api/v2/conversations/emails/agentless) that matches an existing conversation, then that's a stitched agentless message. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "includeAgentlessStitchedMessages": { "type": "boolean", "description": "Whether to include Agentless 'api' type of messages, on stitched conversations. If you provide a conversationId in the agentless email request (/api/v2/conversations/emails/agentless) that matches an existing conversation, then that's a stitched agentless message." } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_messages\_draft Get conversation draft reply **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_participant\_communication\_wrapup Get the wrap-up for this conversation communication. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_participant\_wrapup Get the wrap-up for this conversation participant. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_participant\_wrapupcodes Get list of wrapup codes for this conversation participant **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_get\_email\_settings Get emails settings for a given conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_emails Get the logged-in user's active conversations and their Email participants state. ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" } }, "required": [ "PCID" ] } ``` *** ## genesys\_conversations\_digital\_get\_internalmessage Get internal message conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_internalmessages Get the logged-in user's active conversations and their InternalMessage participants state. ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" } }, "required": [ "PCID" ] } ``` *** ## genesys\_conversations\_digital\_get\_message Get message conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_communication\_messages\_media Get message media list by status **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `status` | string | No | — | The status on which to filter the response. | | `pageNumber` | integer | No | — | Page number | | `pageSize` | integer | No | — | Page size | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "status": { "type": "string", "description": "The status on which to filter the response.", "enum": [ "uploading", "valid", "invalid" ] }, "pageNumber": { "type": "integer", "description": "Page number" }, "pageSize": { "type": "integer", "description": "Page size" } }, "required": [ "PCID", "conversationId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_communication\_messages\_media\_media\_id Get media **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | ---------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `mediaId` | string | Yes | — | Media Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "mediaId": { "type": "string", "description": "Media Id" } }, "required": [ "PCID", "conversationId", "communicationId", "mediaId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_details Get message **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | ------- | -------- | ------- | ------------------------------------------------------------- | | `messageId` | string | Yes | — | Message Id | | `useNormalizedMessage` | boolean | No | — | If true, response removes deprecated fields (textBody, media) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "messageId": { "type": "string", "description": "Message Id" }, "useNormalizedMessage": { "type": "boolean", "description": "If true, response removes deprecated fields (textBody, media)" } }, "required": [ "PCID", "messageId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_message Get conversation message **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | ------- | -------- | ------- | ------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `messageId` | string | Yes | — | Message Id | | `useNormalizedMessage` | boolean | No | — | If true, response removes deprecated fields (textBody, media) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "messageId": { "type": "string", "description": "Message Id" }, "useNormalizedMessage": { "type": "boolean", "description": "If true, response removes deprecated fields (textBody, media)" } }, "required": [ "PCID", "conversationId", "messageId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_participant\_communication\_wrapup Get the wrap-up for this conversation communication. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_participant\_wrapup Get the wrap-up for this conversation participant. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_get\_message\_participant\_wrapupcodes Get list of wrapup codes for this conversation participant **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_get\_messages Get the logged-in user's active conversations and their Message participants state. ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" } }, "required": [ "PCID" ] } ``` *** ## genesys\_conversations\_digital\_get\_messaging\_integrations Get a list of Integrations **Parameters:** | Parameter | Type | Required | Default | Description | | --------------------- | --------- | -------- | ------- | -------------------------------------------------------------- | | `pageSize` | integer | No | — | Page size | | `pageNumber` | integer | No | — | Page number | | `expand` | string\[] | No | — | Expand instructions for the return value. | | `supportedContent.id` | string | No | — | Filter integrations returned based on the supported content ID | | `messagingSetting.id` | string | No | — | Filter integrations returned based on the setting ID | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "pageSize": { "type": "integer", "description": "Page size" }, "pageNumber": { "type": "integer", "description": "Page number" }, "expand": { "type": "array", "items": { "type": "string", "enum": [ "supportedContent", "messagingSetting", "identityresolution" ] }, "description": "Expand instructions for the return value." }, "supportedContent.id": { "type": "string", "description": "Filter integrations returned based on the supported content ID" }, "messagingSetting.id": { "type": "string", "description": "Filter integrations returned based on the setting ID" } }, "required": [ "PCID" ] } ``` *** ## genesys\_conversations\_digital\_get\_social\_participant\_communication\_wrapup Get the wrap-up for this conversation communication. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_video\_participant\_communication\_wrapup Get the wrap-up for this conversation communication. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `provisional` | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "provisional": { "type": "boolean", "description": "Indicates whether or not to fetch provisional wrap-up code." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_get\_videos\_meeting Gets a record for a given meetingId **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------- | | `meetingId` | string | Yes | — | Meeting Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "meetingId": { "type": "string", "description": "Meeting Id" } }, "required": [ "PCID", "meetingId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email Update a conversation by disconnecting all of the participants **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `address` | string | No | — | The address of the conversation as seen from an external participant. For phone calls this will be the DNIS for inbound calls and the ANI for outbound calls. For other media types this will be the address of the destination participant for inbound and the address of the initiating participant for outbound. | | `conversationIds` | string\[] | No | — | A list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference. | | `divisions` | object\[] | No | — | Identifiers of divisions associated with this conversation | | `endTime` | string | No | — | The time when the conversation ended. This will be the time when the last participant left the conversation, or null when the conversation is still active. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `externalTag` | string | No | — | The external tag associated with the conversation. | | `id` | string | No | — | The globally unique identifier for the object. | | `inactivityTimeout` | string | No | — | The time in the future, after which this conversation would be considered inactive. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `maxParticipants` | integer | No | — | If this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference. | | `name` | string | No | — | The name value | | `participants` | object\[] | Yes | — | The list of all participants in the conversation. | | `recentTransfers` | object\[] | No | — | The list of the most recent 20 transfer commands applied to this conversation. | | `recordingState` | string | No | — | On update, 'paused' initiates a secure pause, 'active' resumes any paused recordings; otherwise indicates state of conversation recording. | | `securePause` | boolean | No | — | True when the recording of this conversation is in secure pause status. | | `selfUri` | string | No | — | The URI for this object | | `startTime` | string | Yes | — | The time when the conversation started. This will be the time when the first participant joined the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | On update, 'disconnected' will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present. | | `utilizationLabelId` | string | No | — | An optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "address": { "type": "string", "description": "The address of the conversation as seen from an external participant. For phone calls this will be the DNIS for inbound calls and the ANI for outbound calls. For other media types this will be the address of the destination participant for inbound and the address of the initiating participant for outbound." }, "conversationIds": { "type": "array", "items": { "type": "string" }, "description": "A list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference." }, "divisions": { "type": "array", "items": { "type": "object", "properties": { "division": { "type": "object", "description": "The division value" }, "entities": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "selfUri": { "type": "string" }, "dateDivisionUpdated": { "type": "string", "description": "The time the entity division was last updated. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The entities on the conversation within the division. These are the users, queues, work flows, etc. that can be on conversations and and be assigned to different divisions." } } }, "description": "Identifiers of divisions associated with this conversation" }, "endTime": { "type": "string", "description": "The time when the conversation ended. This will be the time when the last participant left the conversation, or null when the conversation is still active. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "externalTag": { "type": "string", "description": "The external tag associated with the conversation." }, "id": { "type": "string", "description": "The globally unique identifier for the object." }, "inactivityTimeout": { "type": "string", "description": "The time in the future, after which this conversation would be considered inactive. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "maxParticipants": { "type": "integer", "description": "If this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference." }, "name": { "type": "string", "description": "The name value" }, "participants": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "A globally unique identifier for this conversation." }, "startTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant joined the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "endTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant was connected to the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "A human readable name identifying the participant." }, "userUri": { "type": "string", "description": "If this participant represents a user, then this will be an URI that can be used to fetch the user." }, "userId": { "type": "string", "description": "If this participant represents a user, then this will be the globally unique identifier for the user." }, "externalContactId": { "type": "string", "description": "If this participant represents an external contact, then this will be the globally unique identifier for the external contact." }, "externalContactInitialDivisionId": { "type": "string", "description": "If this participant represents an external contact, then this will be the initial division for the external contact. This value will not be updated if the external contact is reassigned." }, "externalOrganizationId": { "type": "string", "description": "If this participant represents an external org, then this will be the globally unique identifier for the external org." }, "queueId": { "type": "string", "description": "If present, the queue id that the communication channel came in on." }, "groupId": { "type": "string", "description": "If present, group of users the participant represents." }, "teamId": { "type": "string", "description": "The team id that this participant is a member of when added to the conversation." }, "queueName": { "type": "string", "description": "If present, the queue name that the communication channel came in on." }, "purpose": { "type": "string", "description": "A well known string that specifies the purpose of this participant." }, "participantType": { "type": "string", "description": "A well known string that specifies the type of this participant." }, "consultParticipantId": { "type": "string", "description": "If this participant is part of a consult transfer, then this will be the participant id of the participant being transferred." }, "address": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "ani": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "aniName": { "type": "string", "description": "The ani-based name for this participant." }, "dnis": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "locale": { "type": "string", "description": "An ISO 639 language code specifying the locale for this participant" }, "wrapupRequired": { "type": "boolean", "description": "True iff this participant is required to enter wrapup for this conversation." }, "wrapupPrompt": { "type": "string", "enum": [ "mandatory", "optional", "agentRequested", "timeout", "forcedTimeout" ], "description": "This field controls how the UI prompts the agent for a wrapup." }, "wrapupTimeoutMs": { "type": "integer", "format": "int32", "description": "Specifies how long a timed ACW session will last." }, "wrapupSkipped": { "type": "boolean", "description": "The UI sets this field when the agent chooses to skip entering a wrapup for this participant." }, "wrapup": { "type": "object", "description": "The wrapup value" }, "mediaRoles": { "type": "array", "items": { "type": "string" }, "description": "List of roles this participant's media has had on the conversation, ie monitor, coach, etc." }, "conversationRoutingData": { "type": "object", "description": "Conversation Routing Data" }, "alertingTimeoutMs": { "type": "integer", "format": "int32", "description": "Specifies how long the agent has to answer an interaction before being marked as not responding." }, "monitoredParticipantId": { "type": "string", "description": "If this participant is a monitor, then this will be the id of the participant that is being monitored." }, "coachedParticipantId": { "type": "string", "description": "If this participant is a coach, then this will be the id of the participant that is being coached." }, "attributes": { "type": "object", "description": "Additional participant attributes" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "direction": { "type": "string", "description": "The direction of the call" }, "recording": { "type": "boolean", "description": "True if this call is being recorded." }, "recordingState": { "type": "string", "description": "State of recording on this call." }, "recordersState": { "type": "object" }, "muted": { "type": "boolean", "description": "True if this call is muted so that remote participants can't hear any audio from this end." }, "confined": { "type": "boolean", "description": "True if this call is held and the person on this side hears hold music." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "securePause": { "type": "boolean", "description": "True when the recording of this call is in secure pause status." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this call." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the call was placed on hold in the cloud clock if the call is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "documentId": { "type": "string", "description": "If call is an outbound fax of a document from content management, then this is the id in content management." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectReasons": { "type": "array", "description": "List of reasons that this call was disconnected. This will be set once the call disconnects." }, "faxStatus": { "type": "object" }, "provider": { "type": "string", "description": "The source provider for the call." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "uuiData": { "type": "string", "description": "User to User Information (UUI) data managed by SIP session application." }, "self": { "type": "object" }, "other": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "agentAssistantId": { "type": "string", "description": "UUID of virtual agent assistant that provide suggestions to the agent participant during the conversation." }, "transferSource": { "type": "string", "description": "Indicates how call reaches the agent." }, "queueMediaSettings": { "type": "object" }, "disposition": { "type": "object" } } }, "description": "The calls value" }, "callbacks": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's callback, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the call" }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the callback was placed on hold in the cloud clock if the callback is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "dialerPreview": { "type": "object" }, "voicemail": { "type": "object" }, "callbackNumbers": { "type": "array", "description": "The phone number(s) to use to place the callback." }, "callbackUserName": { "type": "string", "description": "The name of the user requesting a callback." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "externalCampaign": { "type": "boolean", "description": "True if the call for the callback uses external dialing." }, "skipEnabled": { "type": "boolean", "description": "True if the ability to skip a callback should be enabled." }, "timeoutSeconds": { "type": "integer", "description": "The number of seconds before the system automatically places a call for a callback. 0 means the automatic placement is disabled." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "callbackScheduledTime": { "type": "string", "description": "The timestamp when this communication is scheduled in the provider clock. If this value is missing it indicates the callback will be placed immediately. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "automatedCallbackConfigId": { "type": "string", "description": "The id of the config for automatically placing the callback (and handling the disposition). If null, the callback will not be placed automatically but routed to an agent as per normal." }, "provider": { "type": "string", "description": "The source provider for the callback." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "callerId": { "type": "string", "description": "The phone number displayed to recipients of the phone call. The value should conform to the E164 format." }, "callerIdName": { "type": "string", "description": "The name displayed to recipients of the phone call." }, "queueMediaSettings": { "type": "object" } } }, "description": "The callbacks value" }, "chats": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "roomId": { "type": "string", "description": "The room id for the chat." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this chat." }, "segments": { "type": "array", "description": "The time line of the participant's chat, divided into activity segments." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "direction": { "type": "string", "description": "The direction of the chat" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the chat was placed on hold in the cloud clock if the chat is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the email." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "avatarImageUrl": { "type": "string", "description": "If available, the URI to the avatar image of this communication." }, "journeyContext": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "queueMediaSettings": { "type": "object" } } }, "description": "The chats value" }, "cobrowsesessions": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "self": { "type": "object" }, "cobrowseSessionId": { "type": "string", "description": "The co-browse session ID." }, "cobrowseRole": { "type": "string", "description": "This value identifies the role of the co-browse client within the co-browse session (a client is a sharer or a viewer)." }, "controlling": { "type": "array", "description": "ID of co-browse participants for which this client has been granted control (list is empty if this client cannot control any shared pages)." }, "viewerUrl": { "type": "string", "description": "The URL that can be used to open co-browse session in web browser." }, "providerEventTime": { "type": "string", "description": "The time when the provider event which triggered this conversation update happened in the corrected provider clock (milliseconds since 1970-01-01 00:00:00 UTC). Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the co-browse session." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The cobrowsesessions value" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "subject": { "type": "string", "description": "The subject for the initial email that started this conversation." }, "messagesSent": { "type": "integer", "description": "The number of email messages sent by this participant." }, "segments": { "type": "array", "description": "The time line of the participant's email, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the email" }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this call." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the email was placed on hold in the cloud clock if the email is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "autoGenerated": { "type": "boolean", "description": "Indicates that the email was auto-generated like an Out of Office reply." }, "provider": { "type": "string", "description": "The source provider for the email." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "messageId": { "type": "string", "description": "A globally unique identifier for the stored content of this communication." }, "draftAttachments": { "type": "array", "description": "A list of uploaded attachments on the email draft." }, "spam": { "type": "boolean", "description": "Indicates if the inbound email was marked as spam." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "queueMediaSettings": { "type": "object" }, "parkTime": { "type": "string", "description": "Represents the time when an email was put into parked state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The emails value" }, "messages": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "segments": { "type": "array", "description": "The time line of the participant's message, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the message." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this message." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the message was placed on hold in the cloud clock if the message is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the message." }, "authenticated": { "type": "boolean", "description": "If true, the participant member is authenticated." }, "type": { "type": "string", "description": "Indicates the type of message platform from which the message originated." }, "recipientCountry": { "type": "string", "description": "Indicates the country where the recipient is associated in ISO 3166-1 alpha-2 format." }, "recipientType": { "type": "string", "description": "The type of the recipient. Eg: Provisioned phoneNumber is the recipient for sms message type." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "toAddress": { "type": "object" }, "fromAddress": { "type": "object" }, "messages": { "type": "array", "description": "The messages sent on this communication channel." }, "journeyContext": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "agentAssistantId": { "type": "string", "description": "UUID of virtual agent assistant that provide suggestions to the agent participant during the conversation." }, "byoSmsIntegrationId": { "type": "string", "description": "The internal id representing the customer supplied sms integration message." }, "queueMediaSettings": { "type": "object" }, "engagementSource": { "type": "string" }, "resumeTime": { "type": "string", "description": "Represents the time when a parked message will resume. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "parkTime": { "type": "string", "description": "Represents the time when an message was put into parked state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The messages value" }, "internalMessages": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's internal message, divided into activity segments." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the message." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "targetUserId": { "type": "string", "description": "The user ID for the participant on receiving side of the internal message conversation." }, "sourceUserId": { "type": "string", "description": "The user ID for the participant on sending side of the internal message conversation." }, "toAddress": { "type": "object" }, "fromAddress": { "type": "object" }, "messages": { "type": "array", "description": "The messages sent on this communication channel." } } }, "description": "Internal Messages" }, "screenMonitorings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "state": { "type": "string", "description": "The connection state of this communication." }, "segments": { "type": "array", "description": "The time line of the participant's Screen Monitoring media, divided into activity segments." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "provider": { "type": "string", "description": "The source provider of Screen Monitoring media." }, "targetUser": { "type": "object" }, "screenMonitoring": { "type": "object" }, "monitoringType": { "type": "string", "description": "The screen monitoring type." }, "count": { "type": "integer", "description": "Number of Screen Monitoring sessions the targetUserId is involved in." }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "Screen Monitorings" }, "screenshares": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "context": { "type": "string", "description": "The room id context (xmpp jid) for the conference session." }, "sharing": { "type": "boolean", "description": "Indicates whether this participant is sharing their screen." }, "peerCount": { "type": "integer", "description": "The number of peer participants from the perspective of the participant in the conference." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the screen share." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The screenshares value" }, "socialExpressions": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "socialMediaId": { "type": "string", "description": "A globally unique identifier for the social media." }, "socialMediaHub": { "type": "string", "description": "The social network of the communication" }, "socialUserName": { "type": "string", "description": "The user name for the communication." }, "previewText": { "type": "string", "description": "The text preview of the communication contents" }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this chat." }, "segments": { "type": "array", "description": "The time line of the participant's chat, divided into activity segments." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the chat was placed on hold in the cloud clock if the chat is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the social expression." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "Social Expressions" }, "videos": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "context": { "type": "string", "description": "The room id context (xmpp jid) for the conference session." }, "audioMuted": { "type": "boolean", "description": "Indicates whether this participant has muted their outgoing audio." }, "videoMuted": { "type": "boolean", "description": "Indicates whether this participant has muted/paused their outgoing video." }, "sharingScreen": { "type": "boolean", "description": "Indicates whether this participant is sharing their screen to the session." }, "peerCount": { "type": "integer", "description": "The number of peer participants from the perspective of the participant in the conference." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the video." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "msids": { "type": "array", "description": "List of media stream ids" }, "self": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The videos value" }, "evaluations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The globally unique identifier for the object." }, "name": { "type": "string" }, "conversation": { "type": "object" }, "evaluationForm": { "type": "object" }, "evaluator": { "type": "object" }, "agent": { "type": "object" }, "calibration": { "type": "object" }, "status": { "type": "string" }, "answers": { "type": "object" }, "agentHasRead": { "type": "boolean" }, "assignee": { "type": "object" }, "assigneeApplicable": { "type": "boolean", "description": "Indicates whether an assignee is applicable for the evaluation. Set to false when assignee is not applicable." }, "releaseDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "assignedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "createdDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "changedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "submittedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "revisionCreatedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "queue": { "type": "object" }, "mediaType": { "type": "array", "description": "List of different communication types used in conversation." }, "divisionIds": { "type": "array", "description": "Evaluation is assigned in the following division(s)." }, "rescore": { "type": "boolean", "description": "Is only true when evaluation is re-scored." }, "conversationDate": { "type": "string", "description": "Creation date of the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "conversationEndDate": { "type": "string", "description": "End date of conversation if it had completed before evaluation creation. Null if created before the conversation ended. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "neverRelease": { "type": "boolean", "description": "Signifies if the evaluation is never to be released. This cannot be set true if release date is also set." }, "assigned": { "type": "boolean", "description": "Set to false to unassign the evaluation. This cannot be set to false when assignee is also set." }, "dateAssigneeChanged": { "type": "string", "description": "Date when the assignee was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "resourceId": { "type": "string", "description": "Only used for email evaluations. Will be null for all other evaluations." }, "resourceType": { "type": "string", "description": "The type of resource. Only used for email evaluations. Will be null for evaluations on all other resources." }, "redacted": { "type": "boolean", "description": "Is only true when the user making the request does not have sufficient permissions to see evaluation" }, "agentTeam": { "type": "object" }, "isScoringIndex": { "type": "boolean" }, "authorizedActions": { "type": "array", "description": "List of user authorized actions on evaluation. Possible values: assign, edit, editScore, editAgentSignoff, delete, release, viewAudit" }, "hasAssistanceFailed": { "type": "boolean", "description": "Is true when evaluation assistance didn't execute successfully" }, "evaluationSource": { "type": "object" }, "aiScoring": { "type": "object" }, "selfUri": { "type": "string", "description": "The URI for this object" } } }, "description": "The evaluations value" }, "screenRecordingState": { "type": "string", "enum": [ "requested", "active", "paused", "stopped", "error", "timeout" ], "description": "The current screen recording state for this participant." }, "flaggedReason": { "type": "string", "enum": [ "general" ], "description": "The reason specifying why participant flagged the conversation." }, "startAcwTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant started after-call work. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "endAcwTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant ended after-call work. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "bargedParticipantId": { "type": "string", "description": "If this participant barged in a participant's call, then this will be the id of the targeted participant." } } }, "description": "The list of all participants in the conversation." }, "recentTransfers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the command." }, "state": { "type": "string", "enum": [ "Pending", "Active", "Complete", "Canceled", "Failed", "Timeout", "Unknown" ], "description": "The state of the command." }, "dateIssued": { "type": "string", "format": "date-time", "description": "The date/time that this command was issued. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "initiator": { "type": "object", "description": "The initiator value" }, "modifiedBy": { "type": "object", "description": "Modified By" }, "destination": { "type": "object", "description": "The destination value" }, "transferType": { "type": "string", "enum": [ "Attended", "Unattended" ], "description": "The type of transfer to perform." } } }, "description": "The list of the most recent 20 transfer commands applied to this conversation." }, "recordingState": { "type": "string", "description": "On update, 'paused' initiates a secure pause, 'active' resumes any paused recordings; otherwise indicates state of conversation recording.", "enum": [ "ACTIVE", "PAUSED", "NONE" ] }, "securePause": { "type": "boolean", "description": "True when the recording of this conversation is in secure pause status." }, "selfUri": { "type": "string", "description": "The URI for this object" }, "startTime": { "type": "string", "description": "The time when the conversation started. This will be the time when the first participant joined the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "On update, 'disconnected' will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "utilizationLabelId": { "type": "string", "description": "An optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level" } }, "required": [ "PCID", "conversationId", "participants", "startTime" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email\_messages\_draft Reset conversation draft to its initial state and/or auto-fill draft content **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `autoFill` | boolean | No | — | Auto Fill | | `discard` | boolean | No | — | The discard value | | `draftType` | string | No | — | The kind of draft that as to be treated. Used to prefix response subject or auto-include information | | `translate` | object | No | — | The translate value | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "autoFill": { "type": "boolean", "description": "Auto Fill" }, "discard": { "type": "boolean", "description": "The discard value" }, "draftType": { "type": "string", "description": "The kind of draft that as to be treated. Used to prefix response subject or auto-include information", "enum": [ "Reply", "ReplyAll", "Forward" ] }, "translate": { "type": "object", "description": "The translate value", "properties": { "from": { "type": "string", "description": "A translation for the word \"from\", for the expected language" }, "to": { "type": "string", "description": "A translation for the word \"to\", for the expected language" }, "cc": { "type": "string", "description": "A translation for the word \"cc\", for the expected language" }, "subject": { "type": "string", "description": "A translation for the word \"subject\", for the expected language" }, "replyPrefix": { "type": "string", "description": "A translation for the subject prefix \"Reply\", for the expected language" }, "forwardPrefix": { "type": "string", "description": "A translation for the subject prefix \"Forward\", for the expected language" }, "sent": { "type": "string", "description": "A translation for the word \"sent\", for the expected language" }, "language": { "type": "string", "description": "The code of the expected language" }, "timeZone": { "type": "string", "description": "Timezone used by the agent, used to format the sent email date and time. If not defined, will default to UTC. Time zones are represented as a string of the zone name as found in the IANA time zone database. For example: UTC, Etc/UTC, or Europe/London" } }, "required": [ "cc", "forwardPrefix", "from", "language", "replyPrefix", "sent", "subject", "to" ] } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email\_participant Update conversation participant **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `confined` | boolean | No | — | True to confine this conversation participant. Should only be used for ad-hoc conferences | | `held` | boolean | No | — | True to hold this conversation participant. | | `muted` | boolean | No | — | True to mute this conversation participant. | | `recording` | boolean | No | — | True to enable ad-hoc recording of this participant, otherwise false to disable recording. | | `resumeTime` | string | No | — | Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'. | | `wrapup` | object | No | — | The wrapup value | | `wrapupSkipped` | boolean | No | — | True to skip wrap-up for this participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "confined": { "type": "boolean", "description": "True to confine this conversation participant. Should only be used for ad-hoc conferences" }, "held": { "type": "boolean", "description": "True to hold this conversation participant." }, "muted": { "type": "boolean", "description": "True to mute this conversation participant." }, "recording": { "type": "boolean", "description": "True to enable ad-hoc recording of this participant, otherwise false to disable recording." }, "resumeTime": { "type": "string", "description": "Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "wrapup": { "type": "object", "description": "The wrapup value", "properties": { "code": { "type": "string", "description": "The user configured wrap up code id." }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." } } }, "wrapupSkipped": { "type": "boolean", "description": "True to skip wrap-up for this participant." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email\_participant\_attributes Update the attributes on a conversation participant. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------------------ | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `attributes` | object | No | — | The map of attribute keys to values. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "attributes": { "type": "object", "description": "The map of attribute keys to values." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email\_participant\_communication Update conversation participant's communication by disconnecting it. This endpoint does not update wrapup. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `confined` | boolean | No | — | True to confine this conversation participant. Should only be used for ad-hoc conferences | | `held` | boolean | No | — | True to hold this conversation participant. | | `muted` | boolean | No | — | True to mute this conversation participant. | | `recording` | boolean | No | — | True to enable ad-hoc recording of this participant, otherwise false to disable recording. | | `resumeTime` | string | No | — | Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'. | | `wrapup` | object | No | — | The wrapup value | | `wrapupSkipped` | boolean | No | — | True to skip wrap-up for this participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "confined": { "type": "boolean", "description": "True to confine this conversation participant. Should only be used for ad-hoc conferences" }, "held": { "type": "boolean", "description": "True to hold this conversation participant." }, "muted": { "type": "boolean", "description": "True to mute this conversation participant." }, "recording": { "type": "boolean", "description": "True to enable ad-hoc recording of this participant, otherwise false to disable recording." }, "resumeTime": { "type": "string", "description": "Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "wrapup": { "type": "object", "description": "The wrapup value", "properties": { "code": { "type": "string", "description": "The user configured wrap up code id." }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." } } }, "wrapupSkipped": { "type": "boolean", "description": "True to skip wrap-up for this participant." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_email\_participant\_parkingstate Update conversation by setting its parking state **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `resumeTime` | string | No | — | Timestamp for resume parked conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | Yes | — | State to set the participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "resumeTime": { "type": "string", "description": "Timestamp for resume parked conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "State to set the participant.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] } }, "required": [ "PCID", "conversationId", "participantId", "state" ] } ``` *** ## genesys\_conversations\_digital\_patch\_message Update a conversation by disconnecting all of the participants **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `address` | string | No | — | The address of the conversation as seen from an external participant. For phone calls this will be the DNIS for inbound calls and the ANI for outbound calls. For other media types this will be the address of the destination participant for inbound and the address of the initiating participant for outbound. | | `conversationIds` | string\[] | No | — | A list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference. | | `divisions` | object\[] | No | — | Identifiers of divisions associated with this conversation | | `endTime` | string | No | — | The time when the conversation ended. This will be the time when the last participant left the conversation, or null when the conversation is still active. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `externalTag` | string | No | — | The external tag associated with the conversation. | | `id` | string | No | — | The globally unique identifier for the object. | | `inactivityTimeout` | string | No | — | The time in the future, after which this conversation would be considered inactive. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `maxParticipants` | integer | No | — | If this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference. | | `name` | string | No | — | The name value | | `participants` | object\[] | Yes | — | The list of all participants in the conversation. | | `recentTransfers` | object\[] | No | — | The list of the most recent 20 transfer commands applied to this conversation. | | `recordingState` | string | No | — | On update, 'paused' initiates a secure pause, 'active' resumes any paused recordings; otherwise indicates state of conversation recording. | | `securePause` | boolean | No | — | True when the recording of this conversation is in secure pause status. | | `selfUri` | string | No | — | The URI for this object | | `startTime` | string | Yes | — | The time when the conversation started. This will be the time when the first participant joined the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | On update, 'disconnected' will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present. | | `utilizationLabelId` | string | No | — | An optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "address": { "type": "string", "description": "The address of the conversation as seen from an external participant. For phone calls this will be the DNIS for inbound calls and the ANI for outbound calls. For other media types this will be the address of the destination participant for inbound and the address of the initiating participant for outbound." }, "conversationIds": { "type": "array", "items": { "type": "string" }, "description": "A list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference." }, "divisions": { "type": "array", "items": { "type": "object", "properties": { "division": { "type": "object", "description": "The division value" }, "entities": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "selfUri": { "type": "string" }, "dateDivisionUpdated": { "type": "string", "description": "The time the entity division was last updated. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The entities on the conversation within the division. These are the users, queues, work flows, etc. that can be on conversations and and be assigned to different divisions." } } }, "description": "Identifiers of divisions associated with this conversation" }, "endTime": { "type": "string", "description": "The time when the conversation ended. This will be the time when the last participant left the conversation, or null when the conversation is still active. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "externalTag": { "type": "string", "description": "The external tag associated with the conversation." }, "id": { "type": "string", "description": "The globally unique identifier for the object." }, "inactivityTimeout": { "type": "string", "description": "The time in the future, after which this conversation would be considered inactive. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "maxParticipants": { "type": "integer", "description": "If this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference." }, "name": { "type": "string", "description": "The name value" }, "participants": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "A globally unique identifier for this conversation." }, "startTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant joined the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "endTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant was connected to the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "A human readable name identifying the participant." }, "userUri": { "type": "string", "description": "If this participant represents a user, then this will be an URI that can be used to fetch the user." }, "userId": { "type": "string", "description": "If this participant represents a user, then this will be the globally unique identifier for the user." }, "externalContactId": { "type": "string", "description": "If this participant represents an external contact, then this will be the globally unique identifier for the external contact." }, "externalContactInitialDivisionId": { "type": "string", "description": "If this participant represents an external contact, then this will be the initial division for the external contact. This value will not be updated if the external contact is reassigned." }, "externalOrganizationId": { "type": "string", "description": "If this participant represents an external org, then this will be the globally unique identifier for the external org." }, "queueId": { "type": "string", "description": "If present, the queue id that the communication channel came in on." }, "groupId": { "type": "string", "description": "If present, group of users the participant represents." }, "teamId": { "type": "string", "description": "The team id that this participant is a member of when added to the conversation." }, "queueName": { "type": "string", "description": "If present, the queue name that the communication channel came in on." }, "purpose": { "type": "string", "description": "A well known string that specifies the purpose of this participant." }, "participantType": { "type": "string", "description": "A well known string that specifies the type of this participant." }, "consultParticipantId": { "type": "string", "description": "If this participant is part of a consult transfer, then this will be the participant id of the participant being transferred." }, "address": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "ani": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "aniName": { "type": "string", "description": "The ani-based name for this participant." }, "dnis": { "type": "string", "description": "The address for the this participant. For a phone call this will be the ANI." }, "locale": { "type": "string", "description": "An ISO 639 language code specifying the locale for this participant" }, "wrapupRequired": { "type": "boolean", "description": "True iff this participant is required to enter wrapup for this conversation." }, "wrapupPrompt": { "type": "string", "enum": [ "mandatory", "optional", "agentRequested", "timeout", "forcedTimeout" ], "description": "This field controls how the UI prompts the agent for a wrapup." }, "wrapupTimeoutMs": { "type": "integer", "format": "int32", "description": "Specifies how long a timed ACW session will last." }, "wrapupSkipped": { "type": "boolean", "description": "The UI sets this field when the agent chooses to skip entering a wrapup for this participant." }, "wrapup": { "type": "object", "description": "The wrapup value" }, "mediaRoles": { "type": "array", "items": { "type": "string" }, "description": "List of roles this participant's media has had on the conversation, ie monitor, coach, etc." }, "conversationRoutingData": { "type": "object", "description": "Conversation Routing Data" }, "alertingTimeoutMs": { "type": "integer", "format": "int32", "description": "Specifies how long the agent has to answer an interaction before being marked as not responding." }, "monitoredParticipantId": { "type": "string", "description": "If this participant is a monitor, then this will be the id of the participant that is being monitored." }, "coachedParticipantId": { "type": "string", "description": "If this participant is a coach, then this will be the id of the participant that is being coached." }, "attributes": { "type": "object", "description": "Additional participant attributes" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "direction": { "type": "string", "description": "The direction of the call" }, "recording": { "type": "boolean", "description": "True if this call is being recorded." }, "recordingState": { "type": "string", "description": "State of recording on this call." }, "recordersState": { "type": "object" }, "muted": { "type": "boolean", "description": "True if this call is muted so that remote participants can't hear any audio from this end." }, "confined": { "type": "boolean", "description": "True if this call is held and the person on this side hears hold music." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "securePause": { "type": "boolean", "description": "True when the recording of this call is in secure pause status." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this call." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the call was placed on hold in the cloud clock if the call is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "documentId": { "type": "string", "description": "If call is an outbound fax of a document from content management, then this is the id in content management." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectReasons": { "type": "array", "description": "List of reasons that this call was disconnected. This will be set once the call disconnects." }, "faxStatus": { "type": "object" }, "provider": { "type": "string", "description": "The source provider for the call." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "uuiData": { "type": "string", "description": "User to User Information (UUI) data managed by SIP session application." }, "self": { "type": "object" }, "other": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "agentAssistantId": { "type": "string", "description": "UUID of virtual agent assistant that provide suggestions to the agent participant during the conversation." }, "transferSource": { "type": "string", "description": "Indicates how call reaches the agent." }, "queueMediaSettings": { "type": "object" }, "disposition": { "type": "object" } } }, "description": "The calls value" }, "callbacks": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's callback, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the call" }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the callback was placed on hold in the cloud clock if the callback is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "dialerPreview": { "type": "object" }, "voicemail": { "type": "object" }, "callbackNumbers": { "type": "array", "description": "The phone number(s) to use to place the callback." }, "callbackUserName": { "type": "string", "description": "The name of the user requesting a callback." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "externalCampaign": { "type": "boolean", "description": "True if the call for the callback uses external dialing." }, "skipEnabled": { "type": "boolean", "description": "True if the ability to skip a callback should be enabled." }, "timeoutSeconds": { "type": "integer", "description": "The number of seconds before the system automatically places a call for a callback. 0 means the automatic placement is disabled." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "callbackScheduledTime": { "type": "string", "description": "The timestamp when this communication is scheduled in the provider clock. If this value is missing it indicates the callback will be placed immediately. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "automatedCallbackConfigId": { "type": "string", "description": "The id of the config for automatically placing the callback (and handling the disposition). If null, the callback will not be placed automatically but routed to an agent as per normal." }, "provider": { "type": "string", "description": "The source provider for the callback." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "callerId": { "type": "string", "description": "The phone number displayed to recipients of the phone call. The value should conform to the E164 format." }, "callerIdName": { "type": "string", "description": "The name displayed to recipients of the phone call." }, "queueMediaSettings": { "type": "object" } } }, "description": "The callbacks value" }, "chats": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "roomId": { "type": "string", "description": "The room id for the chat." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this chat." }, "segments": { "type": "array", "description": "The time line of the participant's chat, divided into activity segments." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "direction": { "type": "string", "description": "The direction of the chat" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the chat was placed on hold in the cloud clock if the chat is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the email." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "avatarImageUrl": { "type": "string", "description": "If available, the URI to the avatar image of this communication." }, "journeyContext": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "queueMediaSettings": { "type": "object" } } }, "description": "The chats value" }, "cobrowsesessions": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "self": { "type": "object" }, "cobrowseSessionId": { "type": "string", "description": "The co-browse session ID." }, "cobrowseRole": { "type": "string", "description": "This value identifies the role of the co-browse client within the co-browse session (a client is a sharer or a viewer)." }, "controlling": { "type": "array", "description": "ID of co-browse participants for which this client has been granted control (list is empty if this client cannot control any shared pages)." }, "viewerUrl": { "type": "string", "description": "The URL that can be used to open co-browse session in web browser." }, "providerEventTime": { "type": "string", "description": "The time when the provider event which triggered this conversation update happened in the corrected provider clock (milliseconds since 1970-01-01 00:00:00 UTC). Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the co-browse session." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The cobrowsesessions value" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "subject": { "type": "string", "description": "The subject for the initial email that started this conversation." }, "messagesSent": { "type": "integer", "description": "The number of email messages sent by this participant." }, "segments": { "type": "array", "description": "The time line of the participant's email, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the email" }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this call." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the email was placed on hold in the cloud clock if the email is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "autoGenerated": { "type": "boolean", "description": "Indicates that the email was auto-generated like an Out of Office reply." }, "provider": { "type": "string", "description": "The source provider for the email." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "messageId": { "type": "string", "description": "A globally unique identifier for the stored content of this communication." }, "draftAttachments": { "type": "array", "description": "A list of uploaded attachments on the email draft." }, "spam": { "type": "boolean", "description": "Indicates if the inbound email was marked as spam." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "queueMediaSettings": { "type": "object" }, "parkTime": { "type": "string", "description": "Represents the time when an email was put into parked state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The emails value" }, "messages": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "segments": { "type": "array", "description": "The time line of the participant's message, divided into activity segments." }, "direction": { "type": "string", "description": "The direction of the message." }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this message." }, "errorInfo": { "type": "object" }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the message was placed on hold in the cloud clock if the message is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the message." }, "authenticated": { "type": "boolean", "description": "If true, the participant member is authenticated." }, "type": { "type": "string", "description": "Indicates the type of message platform from which the message originated." }, "recipientCountry": { "type": "string", "description": "Indicates the country where the recipient is associated in ISO 3166-1 alpha-2 format." }, "recipientType": { "type": "string", "description": "The type of the recipient. Eg: Provisioned phoneNumber is the recipient for sms message type." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "toAddress": { "type": "object" }, "fromAddress": { "type": "object" }, "messages": { "type": "array", "description": "The messages sent on this communication channel." }, "journeyContext": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." }, "agentAssistantId": { "type": "string", "description": "UUID of virtual agent assistant that provide suggestions to the agent participant during the conversation." }, "byoSmsIntegrationId": { "type": "string", "description": "The internal id representing the customer supplied sms integration message." }, "queueMediaSettings": { "type": "object" }, "engagementSource": { "type": "string" }, "resumeTime": { "type": "string", "description": "Represents the time when a parked message will resume. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "parkTime": { "type": "string", "description": "Represents the time when an message was put into parked state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "The messages value" }, "internalMessages": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's internal message, divided into activity segments." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the message." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "targetUserId": { "type": "string", "description": "The user ID for the participant on receiving side of the internal message conversation." }, "sourceUserId": { "type": "string", "description": "The user ID for the participant on sending side of the internal message conversation." }, "toAddress": { "type": "object" }, "fromAddress": { "type": "object" }, "messages": { "type": "array", "description": "The messages sent on this communication channel." } } }, "description": "Internal Messages" }, "screenMonitorings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "state": { "type": "string", "description": "The connection state of this communication." }, "segments": { "type": "array", "description": "The time line of the participant's Screen Monitoring media, divided into activity segments." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "provider": { "type": "string", "description": "The source provider of Screen Monitoring media." }, "targetUser": { "type": "object" }, "screenMonitoring": { "type": "object" }, "monitoringType": { "type": "string", "description": "The screen monitoring type." }, "count": { "type": "integer", "description": "Number of Screen Monitoring sessions the targetUserId is involved in." }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } } }, "description": "Screen Monitorings" }, "screenshares": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "context": { "type": "string", "description": "The room id context (xmpp jid) for the conference session." }, "sharing": { "type": "boolean", "description": "Indicates whether this participant is sharing their screen." }, "peerCount": { "type": "integer", "description": "The number of peer participants from the perspective of the participant in the conference." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the screen share." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "segments": { "type": "array", "description": "The time line of the participant's call, divided into activity segments." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The screenshares value" }, "socialExpressions": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "socialMediaId": { "type": "string", "description": "A globally unique identifier for the social media." }, "socialMediaHub": { "type": "string", "description": "The social network of the communication" }, "socialUserName": { "type": "string", "description": "The user name for the communication." }, "previewText": { "type": "string", "description": "The text preview of the communication contents" }, "recordingId": { "type": "string", "description": "A globally unique identifier for the recording associated with this chat." }, "segments": { "type": "array", "description": "The time line of the participant's chat, divided into activity segments." }, "held": { "type": "boolean", "description": "True if this call is held and the person on this side hears silence." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startHoldTime": { "type": "string", "description": "The timestamp the chat was placed on hold in the cloud clock if the chat is currently on hold. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the social expression." }, "scriptId": { "type": "string", "description": "The UUID of the script to use." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "Social Expressions" }, "videos": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string", "description": "The connection state of this communication." }, "initialState": { "type": "string", "description": "The initial connection state of this communication." }, "id": { "type": "string", "description": "A globally unique identifier for this communication." }, "context": { "type": "string", "description": "The room id context (xmpp jid) for the conference session." }, "audioMuted": { "type": "boolean", "description": "Indicates whether this participant has muted their outgoing audio." }, "videoMuted": { "type": "boolean", "description": "Indicates whether this participant has muted/paused their outgoing video." }, "sharingScreen": { "type": "boolean", "description": "Indicates whether this participant is sharing their screen to the session." }, "peerCount": { "type": "integer", "description": "The number of peer participants from the perspective of the participant in the conference." }, "disconnectType": { "type": "string", "description": "System defined string indicating what caused the communication to disconnect. Will be null until the communication disconnects." }, "startAlertingTime": { "type": "string", "description": "The timestamp the communication has when it is first put into an alerting state. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "connectedTime": { "type": "string", "description": "The timestamp when this communication was connected in the cloud clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "disconnectedTime": { "type": "string", "description": "The timestamp when this communication disconnected from the conversation in the provider clock. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provider": { "type": "string", "description": "The source provider for the video." }, "peerId": { "type": "string", "description": "The id of the peer communication corresponding to a matching leg for this communication." }, "msids": { "type": "array", "description": "List of media stream ids" }, "self": { "type": "object" }, "wrapup": { "type": "object" }, "afterCallWork": { "type": "object" }, "afterCallWorkRequired": { "type": "boolean", "description": "Indicates if after-call work is required for a communication. Only used when the ACW Setting is Agent Requested." } } }, "description": "The videos value" }, "evaluations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The globally unique identifier for the object." }, "name": { "type": "string" }, "conversation": { "type": "object" }, "evaluationForm": { "type": "object" }, "evaluator": { "type": "object" }, "agent": { "type": "object" }, "calibration": { "type": "object" }, "status": { "type": "string" }, "answers": { "type": "object" }, "agentHasRead": { "type": "boolean" }, "assignee": { "type": "object" }, "assigneeApplicable": { "type": "boolean", "description": "Indicates whether an assignee is applicable for the evaluation. Set to false when assignee is not applicable." }, "releaseDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "assignedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "createdDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "changedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "submittedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "revisionCreatedDate": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "queue": { "type": "object" }, "mediaType": { "type": "array", "description": "List of different communication types used in conversation." }, "divisionIds": { "type": "array", "description": "Evaluation is assigned in the following division(s)." }, "rescore": { "type": "boolean", "description": "Is only true when evaluation is re-scored." }, "conversationDate": { "type": "string", "description": "Creation date of the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "conversationEndDate": { "type": "string", "description": "End date of conversation if it had completed before evaluation creation. Null if created before the conversation ended. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "neverRelease": { "type": "boolean", "description": "Signifies if the evaluation is never to be released. This cannot be set true if release date is also set." }, "assigned": { "type": "boolean", "description": "Set to false to unassign the evaluation. This cannot be set to false when assignee is also set." }, "dateAssigneeChanged": { "type": "string", "description": "Date when the assignee was last changed. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "resourceId": { "type": "string", "description": "Only used for email evaluations. Will be null for all other evaluations." }, "resourceType": { "type": "string", "description": "The type of resource. Only used for email evaluations. Will be null for evaluations on all other resources." }, "redacted": { "type": "boolean", "description": "Is only true when the user making the request does not have sufficient permissions to see evaluation" }, "agentTeam": { "type": "object" }, "isScoringIndex": { "type": "boolean" }, "authorizedActions": { "type": "array", "description": "List of user authorized actions on evaluation. Possible values: assign, edit, editScore, editAgentSignoff, delete, release, viewAudit" }, "hasAssistanceFailed": { "type": "boolean", "description": "Is true when evaluation assistance didn't execute successfully" }, "evaluationSource": { "type": "object" }, "aiScoring": { "type": "object" }, "selfUri": { "type": "string", "description": "The URI for this object" } } }, "description": "The evaluations value" }, "screenRecordingState": { "type": "string", "enum": [ "requested", "active", "paused", "stopped", "error", "timeout" ], "description": "The current screen recording state for this participant." }, "flaggedReason": { "type": "string", "enum": [ "general" ], "description": "The reason specifying why participant flagged the conversation." }, "startAcwTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant started after-call work. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "endAcwTime": { "type": "string", "format": "date-time", "description": "The timestamp when this participant ended after-call work. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "bargedParticipantId": { "type": "string", "description": "If this participant barged in a participant's call, then this will be the id of the targeted participant." } } }, "description": "The list of all participants in the conversation." }, "recentTransfers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the command." }, "state": { "type": "string", "enum": [ "Pending", "Active", "Complete", "Canceled", "Failed", "Timeout", "Unknown" ], "description": "The state of the command." }, "dateIssued": { "type": "string", "format": "date-time", "description": "The date/time that this command was issued. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "initiator": { "type": "object", "description": "The initiator value" }, "modifiedBy": { "type": "object", "description": "Modified By" }, "destination": { "type": "object", "description": "The destination value" }, "transferType": { "type": "string", "enum": [ "Attended", "Unattended" ], "description": "The type of transfer to perform." } } }, "description": "The list of the most recent 20 transfer commands applied to this conversation." }, "recordingState": { "type": "string", "description": "On update, 'paused' initiates a secure pause, 'active' resumes any paused recordings; otherwise indicates state of conversation recording.", "enum": [ "ACTIVE", "PAUSED", "NONE" ] }, "securePause": { "type": "boolean", "description": "True when the recording of this conversation is in secure pause status." }, "selfUri": { "type": "string", "description": "The URI for this object" }, "startTime": { "type": "string", "description": "The time when the conversation started. This will be the time when the first participant joined the conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "On update, 'disconnected' will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "utilizationLabelId": { "type": "string", "description": "An optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level" } }, "required": [ "PCID", "conversationId", "participants", "startTime" ] } ``` *** ## genesys\_conversations\_digital\_patch\_message\_participant Update conversation participant **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `confined` | boolean | No | — | True to confine this conversation participant. Should only be used for ad-hoc conferences | | `held` | boolean | No | — | True to hold this conversation participant. | | `muted` | boolean | No | — | True to mute this conversation participant. | | `recording` | boolean | No | — | True to enable ad-hoc recording of this participant, otherwise false to disable recording. | | `resumeTime` | string | No | — | Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'. | | `wrapup` | object | No | — | The wrapup value | | `wrapupSkipped` | boolean | No | — | True to skip wrap-up for this participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "confined": { "type": "boolean", "description": "True to confine this conversation participant. Should only be used for ad-hoc conferences" }, "held": { "type": "boolean", "description": "True to hold this conversation participant." }, "muted": { "type": "boolean", "description": "True to mute this conversation participant." }, "recording": { "type": "boolean", "description": "True to enable ad-hoc recording of this participant, otherwise false to disable recording." }, "resumeTime": { "type": "string", "description": "Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "wrapup": { "type": "object", "description": "The wrapup value", "properties": { "code": { "type": "string", "description": "The user configured wrap up code id." }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." } } }, "wrapupSkipped": { "type": "boolean", "description": "True to skip wrap-up for this participant." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_message\_participant\_attributes Update the attributes on a conversation participant. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------------------ | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `attributes` | object | No | — | The map of attribute keys to values. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "attributes": { "type": "object", "description": "The map of attribute keys to values." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_message\_participant\_communication Update conversation participant's communication by disconnecting it. This endpoint does not update wrapup. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `confined` | boolean | No | — | True to confine this conversation participant. Should only be used for ad-hoc conferences | | `held` | boolean | No | — | True to hold this conversation participant. | | `muted` | boolean | No | — | True to mute this conversation participant. | | `recording` | boolean | No | — | True to enable ad-hoc recording of this participant, otherwise false to disable recording. | | `resumeTime` | string | No | — | Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | No | — | The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'. | | `wrapup` | object | No | — | The wrapup value | | `wrapupSkipped` | boolean | No | — | True to skip wrap-up for this participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "confined": { "type": "boolean", "description": "True to confine this conversation participant. Should only be used for ad-hoc conferences" }, "held": { "type": "boolean", "description": "True to hold this conversation participant." }, "muted": { "type": "boolean", "description": "True to mute this conversation participant." }, "recording": { "type": "boolean", "description": "True to enable ad-hoc recording of this participant, otherwise false to disable recording." }, "resumeTime": { "type": "string", "description": "Time to resume parked communication. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "The state to update to set for this participant's communications. Possible values are: 'connected' and 'disconnected'.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] }, "wrapup": { "type": "object", "description": "The wrapup value", "properties": { "code": { "type": "string", "description": "The user configured wrap up code id." }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." } } }, "wrapupSkipped": { "type": "boolean", "description": "True to skip wrap-up for this participant." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_patch\_message\_participant\_parkingstate Update conversation by setting its parking state **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `resumeTime` | string | No | — | Timestamp for resume parked conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `state` | string | Yes | — | State to set the participant. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "resumeTime": { "type": "string", "description": "Timestamp for resume parked conversation. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "state": { "type": "string", "description": "State to set the participant.", "enum": [ "alerting", "dialing", "contacting", "offering", "connected", "disconnected", "terminated", "converting", "uploading", "transmitting", "parked", "none" ] } }, "required": [ "PCID", "conversationId", "participantId", "state" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_inboundmessages Send an email to an external conversation. An external conversation is one where the provider is not PureCloud based. This endpoint allows the sender of the external email to reply or send a new message to the existing conversation. The new message will be treated as part of the existing conversation and chained to it. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `attributes` | object | No | — | The list of attributes to associate with the customer participant. | | `flowId` | string | No | — | The ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId | | `fromAddress` | string | No | — | The email address of the sender of the email. | | `fromName` | string | No | — | The name of the sender of the email. | | `languageId` | string | No | — | The ID of the language to use for routing. | | `priority` | integer | No | — | The priority to assign to the conversation for routing. | | `provider` | string | Yes | — | The name of the provider that is sourcing the email such as Oracle, Salesforce, etc. | | `queueId` | string | No | — | The ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId | | `skillIds` | string\[] | No | — | The list of skill ID's to use for routing. | | `subject` | string | No | — | The subject of the email | | `toAddress` | string | No | — | The email address of the recipient of the email. | | `toName` | string | No | — | The name of the recipient of the email. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "attributes": { "type": "object", "description": "The list of attributes to associate with the customer participant." }, "flowId": { "type": "string", "description": "The ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId" }, "fromAddress": { "type": "string", "description": "The email address of the sender of the email." }, "fromName": { "type": "string", "description": "The name of the sender of the email." }, "languageId": { "type": "string", "description": "The ID of the language to use for routing." }, "priority": { "type": "integer", "description": "The priority to assign to the conversation for routing." }, "provider": { "type": "string", "description": "The name of the provider that is sourcing the email such as Oracle, Salesforce, etc." }, "queueId": { "type": "string", "description": "The ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId" }, "skillIds": { "type": "array", "items": { "type": "string" }, "description": "The list of skill ID's to use for routing." }, "subject": { "type": "string", "description": "The subject of the email" }, "toAddress": { "type": "string", "description": "The email address of the recipient of the email." }, "toName": { "type": "string", "description": "The name of the recipient of the email." } }, "required": [ "PCID", "conversationId", "provider" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_messages Send an email reply **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `attachments` | object\[] | No | — | The attachments of the email message. | | `bcc` | object\[] | No | — | The recipients that were blind copied on the email message. | | `cc` | object\[] | No | — | The recipients that were copied on the email message. | | `draftType` | string | No | — | The type of draft that need to be treated. | | `emailSizeBytes` | integer | No | — | Indicates an estimation of the size of the current email as a whole, in its final, ready to be sent form. | | `from` | object | Yes | — | The from value | | `historyIncluded` | boolean | No | — | Indicates whether the history of previous emails of the conversation is included within the email bodies of this message. | | `htmlBody` | string | No | — | The html body of the email message. | | `id` | string | No | — | The globally unique identifier for the object. | | `maxEmailSizeBytes` | integer | No | — | Indicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration | | `name` | string | No | — | The name value | | `replyTo` | object | No | — | Reply To | | `selfUri` | string | No | — | The URI for this object | | `state` | string | No | — | The state of the current draft. | | `subject` | string | No | — | The subject of the email message. | | `textBody` | string | Yes | — | The text body of the email message. | | `time` | string | No | — | The time when the message was received or sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `to` | object\[] | Yes | — | The recipients of the email message. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "attachmentId": { "type": "string", "description": "The unique identifier for the attachment." }, "name": { "type": "string", "description": "The name of the attachment." }, "contentUri": { "type": "string", "description": "The content uri of the attachment. If set, this is commonly a public api download location." }, "contentType": { "type": "string", "description": "The type of file the attachment is." }, "contentLength": { "type": "integer", "format": "int32", "description": "The length of the attachment file." }, "inlineImage": { "type": "boolean", "description": "Whether or not the attachment was attached inline.," } } }, "description": "The attachments of the email message." }, "bcc": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients that were blind copied on the email message." }, "cc": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients that were copied on the email message." }, "draftType": { "type": "string", "description": "The type of draft that need to be treated.", "enum": [ "Reply", "ReplyAll", "Forward" ] }, "emailSizeBytes": { "type": "integer", "description": "Indicates an estimation of the size of the current email as a whole, in its final, ready to be sent form." }, "from": { "type": "object", "description": "The from value", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "historyIncluded": { "type": "boolean", "description": "Indicates whether the history of previous emails of the conversation is included within the email bodies of this message." }, "htmlBody": { "type": "string", "description": "The html body of the email message." }, "id": { "type": "string", "description": "The globally unique identifier for the object." }, "maxEmailSizeBytes": { "type": "integer", "description": "Indicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration" }, "name": { "type": "string", "description": "The name value" }, "replyTo": { "type": "object", "description": "Reply To", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "selfUri": { "type": "string", "description": "The URI for this object" }, "state": { "type": "string", "description": "The state of the current draft.", "enum": [ "Created", "Ready", "Edited" ] }, "subject": { "type": "string", "description": "The subject of the email message." }, "textBody": { "type": "string", "description": "The text body of the email message." }, "time": { "type": "string", "description": "The time when the message was received or sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "to": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients of the email message." } }, "required": [ "PCID", "conversationId", "from", "textBody", "to" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_messages\_draft\_attachments\_copy Copy attachments from an email message to the current draft. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `attachments` | object\[] | Yes | — | A list of attachments that will be copied from the source message to the current draft | | `sourceMessage` | object | Yes | — | Source Message | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "attachmentId": { "type": "string", "description": "The unique identifier for the attachment." }, "name": { "type": "string", "description": "The name of the attachment." }, "contentUri": { "type": "string", "description": "The content uri of the attachment. If set, this is commonly a public api download location." }, "contentType": { "type": "string", "description": "The type of file the attachment is." }, "contentLength": { "type": "integer", "format": "int32", "description": "The length of the attachment file." }, "inlineImage": { "type": "boolean", "description": "Whether or not the attachment was attached inline.," } } }, "description": "A list of attachments that will be copied from the source message to the current draft" }, "sourceMessage": { "type": "object", "description": "Source Message", "properties": { "id": { "type": "string", "description": "The id value" }, "name": { "type": "string", "description": "The name value" }, "selfUri": { "type": "string", "description": "Self Uri" } } } }, "required": [ "PCID", "conversationId", "attachments", "sourceMessage" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_participant\_communication\_wrapup Apply wrap-up for this conversation communication **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `code` | string | No | — | The user configured wrap up code id. | | `disableEndTimeUpdates` | boolean | No | — | Prevent updates to wrapup end time when set to true. | | `durationSeconds` | integer | No | — | The length of time in seconds that the agent spent doing after call work. | | `endTime` | string | No | — | The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `name` | string | No | — | The user configured wrap up code name. | | `notes` | string | No | — | Text entered by the agent to describe the call or disposition. | | `provisional` | boolean | No | — | Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later. | | `tags` | string\[] | No | — | List of tags selected by the agent to describe the call or disposition. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "code": { "type": "string", "description": "The user configured wrap up code id." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_participant\_replace Replace this participant with the specified user and/or address **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `address` | string | No | — | The user ID or queue ID of the transfer target. Address like a phone number can not be used for callbacks, but they can be used for other forms of communication. | | `keepInternalMessageAlive` | boolean | No | — | If true, the digital internal message will NOT be terminated. | | `queueId` | string | No | — | The queue ID of the transfer target. | | `transferType` | string | No | — | The type of transfer to perform. Attended, where the initiating agent maintains ownership of the conversation until the intended recipient accepts the transfer, or Unattended, where the initiating agent immediately disconnects. Default is Unattended. | | `userId` | string | No | — | The user ID of the transfer target. | | `userName` | string | No | — | The user name of the transfer target. | | `voicemail` | boolean | No | — | If true, transfer to the voicemail inbox of the participant that is being replaced. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "address": { "type": "string", "description": "The user ID or queue ID of the transfer target. Address like a phone number can not be used for callbacks, but they can be used for other forms of communication." }, "keepInternalMessageAlive": { "type": "boolean", "description": "If true, the digital internal message will NOT be terminated." }, "queueId": { "type": "string", "description": "The queue ID of the transfer target." }, "transferType": { "type": "string", "description": "The type of transfer to perform. Attended, where the initiating agent maintains ownership of the conversation until the intended recipient accepts the transfer, or Unattended, where the initiating agent immediately disconnects. Default is Unattended.", "enum": [ "Attended", "Unattended" ] }, "userId": { "type": "string", "description": "The user ID of the transfer target." }, "userName": { "type": "string", "description": "The user name of the transfer target." }, "voicemail": { "type": "boolean", "description": "If true, transfer to the voicemail inbox of the participant that is being replaced." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_post\_email\_reconnect Reconnect the user to the most recently disconnected customer on a fully disconnected email conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" } }, "required": [ "PCID", "conversationId" ] } ``` *** ## genesys\_conversations\_digital\_post\_emails Create an email conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `attributes` | object | No | — | The list of attributes to associate with the customer participant. | | `direction` | string | No | — | Specify OUTBOUND to send an email on behalf of a queue, or INBOUND to create an external conversation. An external conversation is one where the provider is not PureCloud based. | | `externalContactId` | string | No | — | The external contact with which the email should be associated. This field is only valid for OUTBOUND email. | | `flowId` | string | No | — | The ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId | | `fromAddress` | string | No | — | The email address of the sender of the email. | | `fromName` | string | No | — | The name of the sender of the email. | | `htmlBody` | string | No | — | An HTML body content of the email. | | `languageId` | string | No | — | The ID of the language to use for routing. | | `priority` | integer | No | — | The priority to assign to the conversation for routing. | | `provider` | string | Yes | — | The name of the provider that is sourcing the emails. The Provider "PureCloud Email" is reserved for native emails. | | `queueId` | string | No | — | The ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId | | `skillExpression` | string | No | — | The skill expression to use for routing the email conversation (when using queueId). | | `skillIds` | string\[] | No | — | The list of skill ID's to use for routing. | | `subject` | string | No | — | The subject of the email | | `textBody` | string | No | — | A text body content of the email. | | `toAddress` | string | No | — | The email address of the recipient of the email. | | `toName` | string | No | — | The name of the recipient of the email. | | `utilizationLabel` | string | No | — | Optional. The ID of the label to controls the number of agent interactions for INBOUND communications | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "attributes": { "type": "object", "description": "The list of attributes to associate with the customer participant." }, "direction": { "type": "string", "description": "Specify OUTBOUND to send an email on behalf of a queue, or INBOUND to create an external conversation. An external conversation is one where the provider is not PureCloud based.", "enum": [ "OUTBOUND", "INBOUND" ] }, "externalContactId": { "type": "string", "description": "The external contact with which the email should be associated. This field is only valid for OUTBOUND email." }, "flowId": { "type": "string", "description": "The ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId" }, "fromAddress": { "type": "string", "description": "The email address of the sender of the email." }, "fromName": { "type": "string", "description": "The name of the sender of the email." }, "htmlBody": { "type": "string", "description": "An HTML body content of the email." }, "languageId": { "type": "string", "description": "The ID of the language to use for routing." }, "priority": { "type": "integer", "description": "The priority to assign to the conversation for routing." }, "provider": { "type": "string", "description": "The name of the provider that is sourcing the emails. The Provider \"PureCloud Email\" is reserved for native emails." }, "queueId": { "type": "string", "description": "The ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId" }, "skillExpression": { "type": "string", "description": "The skill expression to use for routing the email conversation (when using queueId)." }, "skillIds": { "type": "array", "items": { "type": "string" }, "description": "The list of skill ID's to use for routing." }, "subject": { "type": "string", "description": "The subject of the email" }, "textBody": { "type": "string", "description": "A text body content of the email." }, "toAddress": { "type": "string", "description": "The email address of the recipient of the email." }, "toName": { "type": "string", "description": "The name of the recipient of the email." }, "utilizationLabel": { "type": "string", "description": "Optional. The ID of the label to controls the number of agent interactions for INBOUND communications" } }, "required": [ "PCID", "provider" ] } ``` *** ## genesys\_conversations\_digital\_post\_emails\_agentless Create an email conversation, per API **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | ------------------------------------------------------------------------- | | `conversationId` | string | No | — | The identifier of the conversation. This must be an email interaction. | | `fromAddress` | object | Yes | — | From Address | | `htmlBody` | string | No | — | The Content of the message, in HTML. Links, images and styles are allowed | | `replyToAddress` | object | No | — | Reply To Address | | `senderType` | string | Yes | — | The type of email domain used to send the agentless message. | | `subject` | string | No | — | The subject of the message. | | `textBody` | string | No | — | The Content of the message, in plain text. | | `toAddresses` | object\[] | Yes | — | The recipient of the message. We currently support one recipient only. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "The identifier of the conversation. This must be an email interaction." }, "fromAddress": { "type": "object", "description": "From Address", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "htmlBody": { "type": "string", "description": "The Content of the message, in HTML. Links, images and styles are allowed" }, "replyToAddress": { "type": "object", "description": "Reply To Address", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "senderType": { "type": "string", "description": "The type of email domain used to send the agentless message.", "enum": [ "Outbound" ] }, "subject": { "type": "string", "description": "The subject of the message." }, "textBody": { "type": "string", "description": "The Content of the message, in plain text." }, "toAddresses": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipient of the message. We currently support one recipient only." } }, "required": [ "PCID", "fromAddress", "senderType", "toAddresses" ] } ``` *** ## genesys\_conversations\_digital\_post\_faxes Create Fax Conversation **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `addresses` | string\[] | Yes | — | A list of outbound fax dialing addresses. E.g. +13175555555 or 3175555555 | | `contentType` | string | No | — | The content type that is going to be uploaded. If Content Management document is used for faxing, contentType will be ignored | | `coverSheet` | object | No | — | Cover Sheet | | `documentId` | string | No | — | DocumentId of Content Management artifact. If Content Management document is not used for faxing, documentId should be null | | `id` | string | No | — | The globally unique identifier for the object. | | `name` | string | No | — | The name value | | `selfUri` | string | No | — | The URI for this object | | `timeZoneOffsetMinutes` | integer | No | — | Time zone offset minutes from GMT | | `workspace` | object | No | — | The workspace value | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "addresses": { "type": "array", "items": { "type": "string" }, "description": "A list of outbound fax dialing addresses. E.g. +13175555555 or 3175555555" }, "contentType": { "type": "string", "description": "The content type that is going to be uploaded. If Content Management document is used for faxing, contentType will be ignored", "enum": [ "application/pdf", "image/tiff", "application/msword", "application/vnd.oasis.opendocument.text", "application/vnd.openxmlformats-officedocument.wordprocessingml.document" ] }, "coverSheet": { "type": "object", "description": "Cover Sheet", "properties": { "notes": { "type": "string", "description": "Text to be added to the coversheet" }, "locale": { "type": "string", "description": "Locale, e.g. = en-US" } } }, "documentId": { "type": "string", "description": "DocumentId of Content Management artifact. If Content Management document is not used for faxing, documentId should be null" }, "id": { "type": "string", "description": "The globally unique identifier for the object." }, "name": { "type": "string", "description": "The name value" }, "selfUri": { "type": "string", "description": "The URI for this object" }, "timeZoneOffsetMinutes": { "type": "integer", "description": "Time zone offset minutes from GMT" }, "workspace": { "type": "object", "description": "The workspace value", "properties": { "id": { "type": "string", "description": "The globally unique identifier for the object." }, "name": { "type": "string", "description": "The current name of the workspace." }, "type": { "type": "string", "description": "The type value", "enum": [ "USER", "GROUP" ] }, "isCurrentUserWorkspace": { "type": "boolean", "description": "Is Current User Workspace" }, "user": { "type": "object", "description": "The user value" }, "bucket": { "type": "string", "description": "The bucket value" }, "dateCreated": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "dateModified": { "type": "string", "description": "Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "summary": { "type": "object", "description": "The summary value" }, "acl": { "type": "array", "items": { "type": "string" }, "description": "The acl value" }, "description": { "type": "string", "description": "The description value" }, "selfUri": { "type": "string", "description": "The URI for this object" } }, "required": [ "name" ] } }, "required": [ "PCID", "addresses" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_communication\_messages Send message **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `useNormalizedMessage` | boolean | No | — | If true, response removes deprecated fields (textBody, media) | | `mediaIds` | string\[] | No | — | The media ids associated with the text message. See [https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload](https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload) for example usage. | | `messagingTemplate` | object | No | — | Messaging Template | | `textBody` | string | Yes | — | The body of the text message. Maximum character counts are: SMS - 765 characters, other channels - 2000 characters. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "useNormalizedMessage": { "type": "boolean", "description": "If true, response removes deprecated fields (textBody, media)" }, "mediaIds": { "type": "array", "items": { "type": "string" }, "description": "The media ids associated with the text message. See https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload for example usage." }, "messagingTemplate": { "type": "object", "description": "Messaging Template", "properties": { "responseId": { "type": "string", "description": "Unique identifier for a Response Management response to fetch and apply pre-configured message content when sending outbound responses." }, "parameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management response substitutions for the response's messaging template. (Deprecated) use bodyParameters instead." }, "headerParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management header parameter substitutions for the response's messaging template" }, "bodyParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management body parameter substitutions for the response's messaging template" }, "buttonUrlParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management button url parameter substitutions for the response's messaging template" }, "carouselParameters": { "type": "object", "description": "Template parameters for carousel components" } } }, "textBody": { "type": "string", "description": "The body of the text message. Maximum character counts are: SMS - 765 characters, other channels - 2000 characters." } }, "required": [ "PCID", "conversationId", "communicationId", "textBody" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_communication\_messages\_media\_uploads Create a URL to upload a message media file **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `contentLengthBytes` | integer | Yes | — | The length of the file to upload in bytes | | `contentMd5` | string | No | — | Content MD5 of the file to upload | | `fileName` | string | Yes | — | Name of the media file to upload. It must not start with a dot and not end with a forward slash. Whitespace and the following characters are not allowed: \{^}%\`]">\[\~\<#\| | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "contentLengthBytes": { "type": "integer", "description": "The length of the file to upload in bytes" }, "contentMd5": { "type": "string", "description": "Content MD5 of the file to upload" }, "fileName": { "type": "string", "description": "Name of the media file to upload. It must not start with a dot and not end with a forward slash. Whitespace and the following characters are not allowed: \\{^}%`]\">[~<#|" } }, "required": [ "PCID", "conversationId", "communicationId", "contentLengthBytes", "fileName" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_communication\_socialmedia\_messages Send a social media message **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `inReplyToMessageId` | string | Yes | — | The ID of the message to which this request is replying. | | `mediaIds` | string\[] | No | — | The media ids associated with the text message. See [https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload](https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload) for example usage. | | `textBody` | string | No | — | The body of the text message. Maximum character count is 2000 characters. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "inReplyToMessageId": { "type": "string", "description": "The ID of the message to which this request is replying." }, "mediaIds": { "type": "array", "items": { "type": "string" }, "description": "The media ids associated with the text message. See https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload for example usage." }, "textBody": { "type": "string", "description": "The body of the text message. Maximum character count is 2000 characters." } }, "required": [ "PCID", "conversationId", "communicationId", "inReplyToMessageId" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_communication\_typing Send message typing event **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `communicationId` | string | Yes | — | Communication Id | | `dateSent` | string | No | — | The time when the message typing event was sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `typing` | object | Yes | — | A Typing event. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "dateSent": { "type": "string", "description": "The time when the message typing event was sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "typing": { "type": "object", "description": "A Typing event.", "properties": { "type": { "type": "string", "description": "Describes the type of Typing event.", "enum": [ "On" ] }, "duration": { "type": "integer", "description": "The duration of the Typing event in milliseconds." } }, "required": [ "type" ] } }, "required": [ "PCID", "conversationId", "communicationId", "typing" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_inbound\_open\_event Send an inbound Open Event Message **Parameters:** | Parameter | Type | Required | Default | Description | | --------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | | `integrationId` | string | Yes | — | Integration Id | | `channel` | object | Yes | — | Open Channel-specific information that describes the message and the message channel/provider. | | `events` | object\[] | Yes | — | List of event elements. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "integrationId": { "type": "string", "description": "Integration Id" }, "channel": { "type": "object", "description": "Open Channel-specific information that describes the message and the message channel/provider.", "properties": { "from": { "type": "object", "description": "Information about the recipient the message is received from." }, "time": { "type": "string", "description": "Original time of the event. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } }, "required": [ "from", "time" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "eventType": { "type": "string", "enum": [ "Typing" ], "description": "Type of this event element" } }, "required": [ "eventType" ] }, "description": "List of event elements." } }, "required": [ "PCID", "integrationId", "channel", "events" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_inbound\_open\_message Send inbound Open Message **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `integrationId` | string | Yes | — | Integration Id | | `prefetchConversationId` | boolean | No | — | Indicates whether or not to prefetch conversationId | | `channel` | object | Yes | — | Open Channel-specific information that describes the message and the message channel/provider, with additional message information | | `content` | object\[] | No | — | List of content elements. | | `metadata` | object | No | — | Additional metadata about this message to capture non-channel specific data. | | `text` | string | No | — | Message text. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "integrationId": { "type": "string", "description": "Integration Id" }, "prefetchConversationId": { "type": "boolean", "description": "Indicates whether or not to prefetch conversationId" }, "channel": { "type": "object", "description": "Open Channel-specific information that describes the message and the message channel/provider, with additional message information", "properties": { "from": { "type": "object", "description": "Information about the recipient the message is received from." }, "time": { "type": "string", "description": "Original time of the event. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "messageId": { "type": "string", "description": "Unique provider ID of the message." }, "metadata": { "type": "object", "description": "Information about the channel." } }, "required": [ "from", "time" ] }, "content": { "type": "array", "items": { "type": "object", "properties": { "attachment": { "type": "object", "description": "Attachment object." } } }, "description": "List of content elements." }, "metadata": { "type": "object", "description": "Additional metadata about this message to capture non-channel specific data." }, "text": { "type": "string", "description": "Message text." } }, "required": [ "PCID", "integrationId", "channel" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_inbound\_open\_receipt Send an inbound Open Receipt Message **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------- | | `integrationId` | string | Yes | — | Integration Id | | `channel` | object | Yes | — | Open Channel-specific information that describes the message and the message channel/provider. | | `id` | string | Yes | — | The original unique message Id generated by the messaging platform, that this receipt message is referencing. | | `isFinalReceipt` | boolean | No | — | Indicates if this is the last message receipt for this message, or if another message receipt can be expected. | | `reasons` | object\[] | No | — | List of reasons for a message receipt that indicates the message has failed. Only used with Failed status. | | `status` | string | Yes | — | Message receipt status. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "integrationId": { "type": "string", "description": "Integration Id" }, "channel": { "type": "object", "description": "Open Channel-specific information that describes the message and the message channel/provider.", "properties": { "to": { "type": "object", "description": "Information about the recipient the message is sent to." }, "time": { "type": "string", "description": "Original time of the event. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" } }, "required": [ "time", "to" ] }, "id": { "type": "string", "description": "The original unique message Id generated by the messaging platform, that this receipt message is referencing." }, "isFinalReceipt": { "type": "boolean", "description": "Indicates if this is the last message receipt for this message, or if another message receipt can be expected." }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "MessageExpired", "RateLimited", "MessageNotAllowed", "GeneralError", "UnsupportedMessage", "UnknownMessage", "InvalidMessageStructure", "InvalidDestination", "ServerError", "MediaTypeNotAllowed", "InvalidMediaContentLength", "RecipientOptedOut", "DataFiltered" ], "description": "The reason code for the failed message receipt." }, "message": { "type": "string", "description": "Description of the reason for the failed message receipt." } }, "required": [ "message" ] }, "description": "List of reasons for a message receipt that indicates the message has failed. Only used with Failed status." }, "status": { "type": "string", "description": "Message receipt status.", "enum": [ "Sent", "Delivered", "Failed", "Published", "Removed" ] } }, "required": [ "PCID", "integrationId", "channel", "id", "status" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_inbound\_open\_structured\_response Send inbound Open Response **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `integrationId` | string | Yes | — | Integration Id | | `buttonResponse` | object | Yes | — | Button response object representing the click of a structured message button, such as a quick reply. | | `channel` | object | Yes | — | Open Channel-specific information that describes the message and the message channel/provider, with additional message information | | `originatingMessageId` | string | Yes | — | Id of original structured message that this messages responds to. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "integrationId": { "type": "string", "description": "Integration Id" }, "buttonResponse": { "type": "object", "description": "Button response object representing the click of a structured message button, such as a quick reply.", "properties": { "id": { "type": "string", "description": "An ID assigned to the button response (Deprecated)." }, "type": { "type": "string", "description": "Describes the button that resulted in the Button Response.", "enum": [ "Button", "QuickReply", "DatePicker" ] }, "text": { "type": "string", "description": "The response text from the button click." }, "payload": { "type": "string", "description": "The response payload associated with the clicked button." } }, "required": [ "payload", "text", "type" ] }, "channel": { "type": "object", "description": "Open Channel-specific information that describes the message and the message channel/provider, with additional message information", "properties": { "from": { "type": "object", "description": "Information about the recipient the message is received from." }, "time": { "type": "string", "description": "Original time of the event. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "messageId": { "type": "string", "description": "Unique provider ID of the message." }, "metadata": { "type": "object", "description": "Information about the channel." } }, "required": [ "from", "time" ] }, "originatingMessageId": { "type": "string", "description": "Id of original structured message that this messages responds to." } }, "required": [ "PCID", "integrationId", "buttonResponse", "channel", "originatingMessageId" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_participant\_communication\_wrapup Apply wrap-up for this conversation communication **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `code` | string | No | — | The user configured wrap up code id. | | `disableEndTimeUpdates` | boolean | No | — | Prevent updates to wrapup end time when set to true. | | `durationSeconds` | integer | No | — | The length of time in seconds that the agent spent doing after call work. | | `endTime` | string | No | — | The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `name` | string | No | — | The user configured wrap up code name. | | `notes` | string | No | — | Text entered by the agent to describe the call or disposition. | | `provisional` | boolean | No | — | Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later. | | `tags` | string\[] | No | — | List of tags selected by the agent to describe the call or disposition. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "code": { "type": "string", "description": "The user configured wrap up code id." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_participant\_monitor Listen in on the conversation from the point of view of a given participant. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | --------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_post\_message\_participant\_replace Replace this participant with the specified user and/or address **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `address` | string | No | — | The user ID or queue ID of the transfer target. Address like a phone number can not be used for callbacks, but they can be used for other forms of communication. | | `keepInternalMessageAlive` | boolean | No | — | If true, the digital internal message will NOT be terminated. | | `queueId` | string | No | — | The queue ID of the transfer target. | | `transferType` | string | No | — | The type of transfer to perform. Attended, where the initiating agent maintains ownership of the conversation until the intended recipient accepts the transfer, or Unattended, where the initiating agent immediately disconnects. Default is Unattended. | | `userId` | string | No | — | The user ID of the transfer target. | | `userName` | string | No | — | The user name of the transfer target. | | `voicemail` | boolean | No | — | If true, transfer to the voicemail inbox of the participant that is being replaced. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "address": { "type": "string", "description": "The user ID or queue ID of the transfer target. Address like a phone number can not be used for callbacks, but they can be used for other forms of communication." }, "keepInternalMessageAlive": { "type": "boolean", "description": "If true, the digital internal message will NOT be terminated." }, "queueId": { "type": "string", "description": "The queue ID of the transfer target." }, "transferType": { "type": "string", "description": "The type of transfer to perform. Attended, where the initiating agent maintains ownership of the conversation until the intended recipient accepts the transfer, or Unattended, where the initiating agent immediately disconnects. Default is Unattended.", "enum": [ "Attended", "Unattended" ] }, "userId": { "type": "string", "description": "The user ID of the transfer target." }, "userName": { "type": "string", "description": "The user name of the transfer target." }, "voicemail": { "type": "boolean", "description": "If true, transfer to the voicemail inbox of the participant that is being replaced." } }, "required": [ "PCID", "conversationId", "participantId" ] } ``` *** ## genesys\_conversations\_digital\_post\_messages Create an outbound messaging conversation. **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `externalContactId` | string | No | — | The external contact with which the message will be associated. | | `queueId` | string | Yes | — | The ID of the queue to be associated with the message. This will determine the fromAddress of the message, unless useUserFromAddress is true and the queue is configured to use the agent's Direct Routing address as the fromAddress. | | `toAddress` | string | Yes | — | The messaging address of the recipient of the message. For an SMS messenger type, the phone number address must be in E.164 format. E.g. +13175555555 or +34234234234. For open messenger type, any string within the outbound.open.messaging.to.address.characters.max limit can be used. For whatsapp messenger type, use a Whatsapp ID of a phone number. E.g for a E.164 formatted phone number `+13175555555`, a Whatsapp ID would be 13175555555 | | `toAddressMessengerType` | string | Yes | — | The messaging address messenger type. | | `useExistingConversation` | boolean | No | — | An override to use an existing conversation. If set to true, an existing conversation will be used if there is one within the conversation window. If set to false, create request fails if there is a conversation within the conversation window. | | `useUserFromAddress` | boolean | No | — | An override to attempt to use the user's configured direct routing address as the fromAddress. If set to true, users configured address with 'directrouting' integration will be used as fromAddress. If set to false or not set, the queueId will be used for determining fromAddress. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "externalContactId": { "type": "string", "description": "The external contact with which the message will be associated." }, "queueId": { "type": "string", "description": "The ID of the queue to be associated with the message. This will determine the fromAddress of the message, unless useUserFromAddress is true and the queue is configured to use the agent's Direct Routing address as the fromAddress." }, "toAddress": { "type": "string", "description": "The messaging address of the recipient of the message. For an SMS messenger type, the phone number address must be in E.164 format. E.g. +13175555555 or +34234234234. For open messenger type, any string within the outbound.open.messaging.to.address.characters.max limit can be used. For whatsapp messenger type, use a Whatsapp ID of a phone number. E.g for a E.164 formatted phone number `+13175555555`, a Whatsapp ID would be 13175555555" }, "toAddressMessengerType": { "type": "string", "description": "The messaging address messenger type.", "enum": [ "sms", "open", "whatsapp" ] }, "useExistingConversation": { "type": "boolean", "description": "An override to use an existing conversation. If set to true, an existing conversation will be used if there is one within the conversation window. If set to false, create request fails if there is a conversation within the conversation window." }, "useUserFromAddress": { "type": "boolean", "description": "An override to attempt to use the user's configured direct routing address as the fromAddress. If set to true, users configured address with 'directrouting' integration will be used as fromAddress. If set to false or not set, the queueId will be used for determining fromAddress." } }, "required": [ "PCID", "queueId", "toAddress", "toAddressMessengerType" ] } ``` *** ## genesys\_conversations\_digital\_post\_messages\_agentless Send an agentless outbound message **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `useNormalizedMessage` | boolean | No | — | If true, response removes deprecated fields (textBody, messagingTemplate) | | `fromAddress` | string | Yes | — | The messaging address of the sender of the message. For an SMS messenger type, this must be a currently provisioned SMS phone number. For a WhatsApp, Open and Apple messenger types use the provisioned integration’s ID. For WebMessaging use the DeploymentId | | `messagingTemplate` | object | No | — | Messaging Template | | `textBody` | string | No | — | The text of the message to send. This field is required in the case of SMS messenger type. Maximum character counts are: SMS - 765 characters, other channels - 2000 characters. | | `toAddress` | string | No | — | The messaging address of the recipient of the message. For an Apple Invitation and SMS messenger type, the phone number address must be in E.164 format. E.g. +13175555555 or +34234234234. For WhatsApp messenger type, use a WhatsApp ID of a phone number. E.g for a E.164 formatted phone number `+13175555555`, a WhatsApp ID would be 13175555555. For WebMessaging this cannot be used, instead use externalContactId | | `toAddressMessengerType` | string | Yes | — | The recipient messaging address messenger type. | | `useExistingActiveConversation` | boolean | No | — | Use an existing active conversation to send the agentless outbound message. Set this parameter to 'true' to use active conversation. Default value: false | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "useNormalizedMessage": { "type": "boolean", "description": "If true, response removes deprecated fields (textBody, messagingTemplate)" }, "fromAddress": { "type": "string", "description": "The messaging address of the sender of the message. For an SMS messenger type, this must be a currently provisioned SMS phone number. For a WhatsApp, Open and Apple messenger types use the provisioned integration’s ID. For WebMessaging use the DeploymentId" }, "messagingTemplate": { "type": "object", "description": "Messaging Template", "properties": { "responseId": { "type": "string", "description": "Unique identifier for a Response Management response to fetch and apply pre-configured message content when sending outbound responses." }, "parameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management response substitutions for the response's messaging template. (Deprecated) use bodyParameters instead." }, "headerParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management header parameter substitutions for the response's messaging template" }, "bodyParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management body parameter substitutions for the response's messaging template" }, "buttonUrlParameters": { "type": "array", "items": { "type": "object" }, "description": "A list of Response Management button url parameter substitutions for the response's messaging template" }, "carouselParameters": { "type": "object", "description": "Template parameters for carousel components" } } }, "textBody": { "type": "string", "description": "The text of the message to send. This field is required in the case of SMS messenger type. Maximum character counts are: SMS - 765 characters, other channels - 2000 characters." }, "toAddress": { "type": "string", "description": "The messaging address of the recipient of the message. For an Apple Invitation and SMS messenger type, the phone number address must be in E.164 format. E.g. +13175555555 or +34234234234. For WhatsApp messenger type, use a WhatsApp ID of a phone number. E.g for a E.164 formatted phone number `+13175555555`, a WhatsApp ID would be 13175555555. For WebMessaging this cannot be used, instead use externalContactId" }, "toAddressMessengerType": { "type": "string", "description": "The recipient messaging address messenger type.", "enum": [ "sms", "whatsapp", "open", "webmessaging", "apple" ] }, "useExistingActiveConversation": { "type": "boolean", "description": "Use an existing active conversation to send the agentless outbound message. Set this parameter to 'true' to use active conversation. Default value: false" } }, "required": [ "PCID", "fromAddress", "toAddressMessengerType" ] } ``` *** ## genesys\_conversations\_digital\_post\_social\_participant\_communication\_wrapup Apply wrap-up for this conversation communication **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `code` | string | No | — | The user configured wrap up code id. | | `disableEndTimeUpdates` | boolean | No | — | Prevent updates to wrapup end time when set to true. | | `durationSeconds` | integer | No | — | The length of time in seconds that the agent spent doing after call work. | | `endTime` | string | No | — | The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `name` | string | No | — | The user configured wrap up code name. | | `notes` | string | No | — | Text entered by the agent to describe the call or disposition. | | `provisional` | boolean | No | — | Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later. | | `tags` | string\[] | No | — | List of tags selected by the agent to describe the call or disposition. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "code": { "type": "string", "description": "The user configured wrap up code id." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_post\_video\_participant\_communication\_wrapup Apply wrap-up for this conversation communication **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `participantId` | string | Yes | — | Participant Id | | `communicationId` | string | Yes | — | Communication Id | | `code` | string | No | — | The user configured wrap up code id. | | `disableEndTimeUpdates` | boolean | No | — | Prevent updates to wrapup end time when set to true. | | `durationSeconds` | integer | No | — | The length of time in seconds that the agent spent doing after call work. | | `endTime` | string | No | — | The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `name` | string | No | — | The user configured wrap up code name. | | `notes` | string | No | — | Text entered by the agent to describe the call or disposition. | | `provisional` | boolean | No | — | Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later. | | `tags` | string\[] | No | — | List of tags selected by the agent to describe the call or disposition. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "participantId": { "type": "string", "description": "Participant Id" }, "communicationId": { "type": "string", "description": "Communication Id" }, "code": { "type": "string", "description": "The user configured wrap up code id." }, "disableEndTimeUpdates": { "type": "boolean", "description": "Prevent updates to wrapup end time when set to true." }, "durationSeconds": { "type": "integer", "description": "The length of time in seconds that the agent spent doing after call work." }, "endTime": { "type": "string", "description": "The timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "name": { "type": "string", "description": "The user configured wrap up code name." }, "notes": { "type": "string", "description": "Text entered by the agent to describe the call or disposition." }, "provisional": { "type": "boolean", "description": "Indicates if this is a pending save and should not require a code to be specified. This allows someone to save some temporary wrapup that will be used later." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "List of tags selected by the agent to describe the call or disposition." } }, "required": [ "PCID", "conversationId", "participantId", "communicationId" ] } ``` *** ## genesys\_conversations\_digital\_post\_videos\_meetings Generate a meetingId for a given conferenceId **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ------------------------------------------------------- | | `conferenceId` | string | No | — | The conferenceId for which to generate a meetingId | | `ephemeral` | boolean | Yes | — | Boolean flag for ephemeral status of the created record | | `expireTimeDays` | integer | No | — | Number of days the meetingId record will remain active | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conferenceId": { "type": "string", "description": "The conferenceId for which to generate a meetingId" }, "ephemeral": { "type": "boolean", "description": "Boolean flag for ephemeral status of the created record" }, "expireTimeDays": { "type": "integer", "description": "Number of days the meetingId record will remain active" } }, "required": [ "PCID", "ephemeral" ] } ``` *** ## genesys\_conversations\_digital\_put\_email\_messages\_draft Update conversation draft reply **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `conversationId` | string | Yes | — | Conversation Id | | `attachments` | object\[] | No | — | The attachments of the email message. | | `bcc` | object\[] | No | — | The recipients that were blind copied on the email message. | | `cc` | object\[] | No | — | The recipients that were copied on the email message. | | `draftType` | string | No | — | The type of draft that need to be treated. | | `emailSizeBytes` | integer | No | — | Indicates an estimation of the size of the current email as a whole, in its final, ready to be sent form. | | `from` | object | Yes | — | The from value | | `historyIncluded` | boolean | No | — | Indicates whether the history of previous emails of the conversation is included within the email bodies of this message. | | `htmlBody` | string | No | — | The html body of the email message. | | `id` | string | No | — | The globally unique identifier for the object. | | `maxEmailSizeBytes` | integer | No | — | Indicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration | | `name` | string | No | — | The name value | | `replyTo` | object | No | — | Reply To | | `selfUri` | string | No | — | The URI for this object | | `state` | string | No | — | The state of the current draft. | | `subject` | string | No | — | The subject of the email message. | | `textBody` | string | Yes | — | The text body of the email message. | | `time` | string | No | — | The time when the message was received or sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss\[.mmm]Z | | `to` | object\[] | Yes | — | The recipients of the email message. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "conversationId": { "type": "string", "description": "Conversation Id" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "attachmentId": { "type": "string", "description": "The unique identifier for the attachment." }, "name": { "type": "string", "description": "The name of the attachment." }, "contentUri": { "type": "string", "description": "The content uri of the attachment. If set, this is commonly a public api download location." }, "contentType": { "type": "string", "description": "The type of file the attachment is." }, "contentLength": { "type": "integer", "format": "int32", "description": "The length of the attachment file." }, "inlineImage": { "type": "boolean", "description": "Whether or not the attachment was attached inline.," } } }, "description": "The attachments of the email message." }, "bcc": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients that were blind copied on the email message." }, "cc": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients that were copied on the email message." }, "draftType": { "type": "string", "description": "The type of draft that need to be treated.", "enum": [ "Reply", "ReplyAll", "Forward" ] }, "emailSizeBytes": { "type": "integer", "description": "Indicates an estimation of the size of the current email as a whole, in its final, ready to be sent form." }, "from": { "type": "object", "description": "The from value", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "historyIncluded": { "type": "boolean", "description": "Indicates whether the history of previous emails of the conversation is included within the email bodies of this message." }, "htmlBody": { "type": "string", "description": "The html body of the email message." }, "id": { "type": "string", "description": "The globally unique identifier for the object." }, "maxEmailSizeBytes": { "type": "integer", "description": "Indicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration" }, "name": { "type": "string", "description": "The name value" }, "replyTo": { "type": "object", "description": "Reply To", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "selfUri": { "type": "string", "description": "The URI for this object" }, "state": { "type": "string", "description": "The state of the current draft.", "enum": [ "Created", "Ready", "Edited" ] }, "subject": { "type": "string", "description": "The subject of the email message." }, "textBody": { "type": "string", "description": "The text body of the email message." }, "time": { "type": "string", "description": "The time when the message was received or sent. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z" }, "to": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email value" }, "name": { "type": "string", "description": "The name value" } } }, "description": "The recipients of the email message." } }, "required": [ "PCID", "conversationId", "from", "textBody", "to" ] } ```