Skip to main content
Server path: /genesys-conversations-digital | Type: Application | PCID required: Yes

Tools

ToolDescription
genesys_conversations_digital_delete_email_messages_draft_attachmentDelete attachment from draft
genesys_conversations_digital_get_cobrowsesessionGet cobrowse conversation
genesys_conversations_digital_get_cobrowsesessionsGet active cobrowse conversations for the logged in user
genesys_conversations_digital_get_emailGet email conversation
genesys_conversations_digital_get_email_messageGet conversation message
genesys_conversations_digital_get_email_messagesGet conversation messages
genesys_conversations_digital_get_email_messages_draftGet conversation draft reply
genesys_conversations_digital_get_email_participant_communication_wrapupGet the wrap-up for this conversation communication.
genesys_conversations_digital_get_email_participant_wrapupGet the wrap-up for this conversation participant.
genesys_conversations_digital_get_email_participant_wrapupcodesGet list of wrapup codes for this conversation participant
genesys_conversations_digital_get_email_settingsGet emails settings for a given conversation
genesys_conversations_digital_get_emailsGet the logged-in user’s active conversations and their Email participants state.
genesys_conversations_digital_get_internalmessageGet internal message conversation
genesys_conversations_digital_get_internalmessagesGet the logged-in user’s active conversations and their InternalMessage participants state.
genesys_conversations_digital_get_messageGet message conversation
genesys_conversations_digital_get_message_communication_messages_mediaGet message media list by status
genesys_conversations_digital_get_message_communication_messages_media_media_idGet media
genesys_conversations_digital_get_message_detailsGet message
genesys_conversations_digital_get_message_messageGet conversation message
genesys_conversations_digital_get_message_participant_communication_wrapupGet the wrap-up for this conversation communication.
genesys_conversations_digital_get_message_participant_wrapupGet the wrap-up for this conversation participant.
genesys_conversations_digital_get_message_participant_wrapupcodesGet list of wrapup codes for this conversation participant
genesys_conversations_digital_get_messagesGet the logged-in user’s active conversations and their Message participants state.
genesys_conversations_digital_get_messaging_integrationsGet a list of Integrations
genesys_conversations_digital_get_social_participant_communication_wrapupGet the wrap-up for this conversation communication.
genesys_conversations_digital_get_video_participant_communication_wrapupGet the wrap-up for this conversation communication.
genesys_conversations_digital_get_videos_meetingGets a record for a given meetingId
genesys_conversations_digital_patch_emailUpdate a conversation by disconnecting all of the participants
genesys_conversations_digital_patch_email_messages_draftReset conversation draft to its initial state and/or auto-fill draft content
genesys_conversations_digital_patch_email_participantUpdate conversation participant
genesys_conversations_digital_patch_email_participant_attributesUpdate the attributes on a conversation participant.
genesys_conversations_digital_patch_email_participant_communicationUpdate conversation participant’s communication by disconnecting it. This endpoint does not update wrapup.
genesys_conversations_digital_patch_email_participant_parkingstateUpdate conversation by setting its parking state
genesys_conversations_digital_patch_messageUpdate a conversation by disconnecting all of the participants
genesys_conversations_digital_patch_message_participantUpdate conversation participant
genesys_conversations_digital_patch_message_participant_attributesUpdate the attributes on a conversation participant.
genesys_conversations_digital_patch_message_participant_communicationUpdate conversation participant’s communication by disconnecting it. This endpoint does not update wrapup.
genesys_conversations_digital_post_email_inboundmessagesSend 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_messagesSend an email reply
genesys_conversations_digital_post_email_messages_draft_attachments_copyCopy attachments from an email message to the current draft.
genesys_conversations_digital_post_email_participant_communication_wrapupApply wrap-up for this conversation communication
genesys_conversations_digital_post_email_participant_replaceReplace this participant with the specified user and/or address
genesys_conversations_digital_post_email_reconnectReconnect the user to the most recently disconnected customer on a fully disconnected email conversation
genesys_conversations_digital_post_emailsCreate an email conversation
genesys_conversations_digital_post_emails_agentlessCreate an email conversation, per API
genesys_conversations_digital_post_faxesCreate Fax Conversation
genesys_conversations_digital_post_message_communication_messagesSend message
genesys_conversations_digital_post_message_communication_messages_media_uploadsCreate a URL to upload a message media file
genesys_conversations_digital_post_message_communication_socialmedia_messagesSend a social media message
genesys_conversations_digital_post_message_communication_typingSend message typing event
genesys_conversations_digital_post_message_inbound_open_eventSend an inbound Open Event Message
genesys_conversations_digital_post_message_inbound_open_messageSend inbound Open Message
genesys_conversations_digital_post_message_inbound_open_receiptSend an inbound Open Receipt Message
genesys_conversations_digital_post_message_inbound_open_structured_responseSend inbound Open Response
genesys_conversations_digital_post_message_participant_communication_wrapupApply wrap-up for this conversation communication
genesys_conversations_digital_post_message_participant_monitorListen in on the conversation from the point of view of a given participant.
genesys_conversations_digital_post_message_participant_replaceReplace this participant with the specified user and/or address
genesys_conversations_digital_post_messagesCreate an outbound messaging conversation.
genesys_conversations_digital_post_messages_agentlessSend an agentless outbound message
genesys_conversations_digital_post_social_participant_communication_wrapupApply wrap-up for this conversation communication
genesys_conversations_digital_post_video_participant_communication_wrapupApply wrap-up for this conversation communication
genesys_conversations_digital_post_videos_meetingsGenerate a meetingId for a given conferenceId
genesys_conversations_digital_put_email_messages_draftUpdate conversation draft reply

genesys_conversations_digital_delete_email_messages_draft_attachment

Delete attachment from draft Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
attachmentIdstringYesattachmentId

genesys_conversations_digital_get_cobrowsesession

Get cobrowse conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_cobrowsesessions

Get active cobrowse conversations for the logged in user

genesys_conversations_digital_get_email

Get email conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_email_message

Get conversation message Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
messageIdstringYesmessageId

genesys_conversations_digital_get_email_messages

Get conversation messages Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_email_messages_draft

Get conversation draft reply Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_email_participant_communication_wrapup

Get the wrap-up for this conversation communication. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_email_participant_wrapup

Get the wrap-up for this conversation participant. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_email_participant_wrapupcodes

Get list of wrapup codes for this conversation participant Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId

genesys_conversations_digital_get_email_settings

Get emails settings for a given conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_emails

Get the logged-in user’s active conversations and their Email participants state.

genesys_conversations_digital_get_internalmessage

Get internal message conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_internalmessages

Get the logged-in user’s active conversations and their InternalMessage participants state.

genesys_conversations_digital_get_message

Get message conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_get_message_communication_messages_media

Get message media list by status Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
statusstringNoThe status on which to filter the response.
pageNumberintegerNoPage number
pageSizeintegerNoPage size

genesys_conversations_digital_get_message_communication_messages_media_media_id

Get media Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
mediaIdstringYesmediaId

genesys_conversations_digital_get_message_details

Get message Parameters:
ParameterTypeRequiredDefaultDescription
messageIdstringYesmessageId
useNormalizedMessagebooleanNoIf true, response removes deprecated fields (textBody, media)

genesys_conversations_digital_get_message_message

Get conversation message Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
messageIdstringYesmessageId
useNormalizedMessagebooleanNoIf true, response removes deprecated fields (textBody, media)

genesys_conversations_digital_get_message_participant_communication_wrapup

Get the wrap-up for this conversation communication. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_message_participant_wrapup

Get the wrap-up for this conversation participant. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_message_participant_wrapupcodes

Get list of wrapup codes for this conversation participant Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId

genesys_conversations_digital_get_messages

Get the logged-in user’s active conversations and their Message participants state.

genesys_conversations_digital_get_messaging_integrations

Get a list of Integrations Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number
expandany[]NoExpand instructions for the return value.
supportedContent.idstringNoFilter integrations returned based on the supported content ID
messagingSetting.idstringNoFilter integrations returned based on the setting ID

genesys_conversations_digital_get_social_participant_communication_wrapup

Get the wrap-up for this conversation communication. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_video_participant_communication_wrapup

Get the wrap-up for this conversation communication. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
provisionalbooleanNoIndicates whether or not to fetch provisional wrap-up code.

genesys_conversations_digital_get_videos_meeting

Gets a record for a given meetingId Parameters:
ParameterTypeRequiredDefaultDescription
meetingIdstringYesmeetingId

genesys_conversations_digital_patch_email

Update a conversation by disconnecting all of the participants Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
addressstringNoThe 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.
conversationIdsany[]NoA list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference.
divisionsany[]NoIdentifiers of divisions associated with this conversation
endTimestringNoThe 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
externalTagstringNoThe external tag associated with the conversation.
idstringNoThe globally unique identifier for the object.
inactivityTimeoutstringNoThe 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
maxParticipantsintegerNoIf this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference.
namestringNoname
participantsany[]YesThe list of all participants in the conversation.
recentTransfersany[]NoThe list of the most recent 20 transfer commands applied to this conversation.
recordingStatestringNoOn update, ‘paused’ initiates a secure pause, ‘active’ resumes any paused recordings; otherwise indicates state of conversation recording.
securePausebooleanNoTrue when the recording of this conversation is in secure pause status.
selfUristringNoThe URI for this object
startTimestringYesThe 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
statestringNoOn update, ‘disconnected’ will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present.
utilizationLabelIdstringNoAn optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level

genesys_conversations_digital_patch_email_messages_draft

Reset conversation draft to its initial state and/or auto-fill draft content Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
autoFillbooleanNoautoFill
discardbooleanNodiscard
draftTypestringNoThe kind of draft that as to be treated. Used to prefix response subject or auto-include information
translateobjectNotranslate

genesys_conversations_digital_patch_email_participant

Update conversation participant Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
confinedbooleanNoTrue to confine this conversation participant. Should only be used for ad-hoc conferences
heldbooleanNoTrue to hold this conversation participant.
mutedbooleanNoTrue to mute this conversation participant.
recordingbooleanNoTrue to enable ad-hoc recording of this participant, otherwise false to disable recording.
statestringNoThe state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’.
wrapupobjectNowrapup
wrapupSkippedbooleanNoTrue to skip wrap-up for this participant.

genesys_conversations_digital_patch_email_participant_attributes

Update the attributes on a conversation participant. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
attributesobjectNoThe map of attribute keys to values.

genesys_conversations_digital_patch_email_participant_communication

Update conversation participant’s communication by disconnecting it. This endpoint does not update wrapup. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
confinedbooleanNoTrue to confine this conversation participant. Should only be used for ad-hoc conferences
heldbooleanNoTrue to hold this conversation participant.
mutedbooleanNoTrue to mute this conversation participant.
recordingbooleanNoTrue to enable ad-hoc recording of this participant, otherwise false to disable recording.
statestringNoThe state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’.
wrapupobjectNowrapup
wrapupSkippedbooleanNoTrue to skip wrap-up for this participant.

genesys_conversations_digital_patch_email_participant_parkingstate

Update conversation by setting its parking state Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
statestringYesState to set the participant.

genesys_conversations_digital_patch_message

Update a conversation by disconnecting all of the participants Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
addressstringNoThe 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.
conversationIdsany[]NoA list of conversations to merge into this conversation to create a conference. This field is null except when being used to create a conference.
divisionsany[]NoIdentifiers of divisions associated with this conversation
endTimestringNoThe 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
externalTagstringNoThe external tag associated with the conversation.
idstringNoThe globally unique identifier for the object.
inactivityTimeoutstringNoThe 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
maxParticipantsintegerNoIf this is a conference conversation, then this field indicates the maximum number of participants allowed to participant in the conference.
namestringNoname
participantsany[]YesThe list of all participants in the conversation.
recentTransfersany[]NoThe list of the most recent 20 transfer commands applied to this conversation.
recordingStatestringNoOn update, ‘paused’ initiates a secure pause, ‘active’ resumes any paused recordings; otherwise indicates state of conversation recording.
securePausebooleanNoTrue when the recording of this conversation is in secure pause status.
selfUristringNoThe URI for this object
startTimestringYesThe 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
statestringNoOn update, ‘disconnected’ will disconnect the conversation. No other values are valid. When reading conversations, this field will never have a value present.
utilizationLabelIdstringNoAn optional label that categorizes the conversation. Max-utilization settings can be configured at a per-label level

genesys_conversations_digital_patch_message_participant

Update conversation participant Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
confinedbooleanNoTrue to confine this conversation participant. Should only be used for ad-hoc conferences
heldbooleanNoTrue to hold this conversation participant.
mutedbooleanNoTrue to mute this conversation participant.
recordingbooleanNoTrue to enable ad-hoc recording of this participant, otherwise false to disable recording.
statestringNoThe state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’.
wrapupobjectNowrapup
wrapupSkippedbooleanNoTrue to skip wrap-up for this participant.

genesys_conversations_digital_patch_message_participant_attributes

Update the attributes on a conversation participant. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
attributesobjectNoThe map of attribute keys to values.

genesys_conversations_digital_patch_message_participant_communication

Update conversation participant’s communication by disconnecting it. This endpoint does not update wrapup. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
confinedbooleanNoTrue to confine this conversation participant. Should only be used for ad-hoc conferences
heldbooleanNoTrue to hold this conversation participant.
mutedbooleanNoTrue to mute this conversation participant.
recordingbooleanNoTrue to enable ad-hoc recording of this participant, otherwise false to disable recording.
statestringNoThe state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’.
wrapupobjectNowrapup
wrapupSkippedbooleanNoTrue to skip wrap-up for this participant.

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:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
attributesobjectNoThe list of attributes to associate with the customer participant.
flowIdstringNoThe ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId
fromAddressstringNoThe email address of the sender of the email.
fromNamestringNoThe name of the sender of the email.
languageIdstringNoThe ID of the language to use for routing.
priorityintegerNoThe priority to assign to the conversation for routing.
providerstringYesThe name of the provider that is sourcing the email such as Oracle, Salesforce, etc.
queueIdstringNoThe ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId
skillIdsany[]NoThe list of skill ID’s to use for routing.
subjectstringNoThe subject of the email
toAddressstringNoThe email address of the recipient of the email.
toNamestringNoThe name of the recipient of the email.

genesys_conversations_digital_post_email_messages

Send an email reply Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
attachmentsany[]NoThe attachments of the email message.
bccany[]NoThe recipients that were blind copied on the email message.
ccany[]NoThe recipients that were copied on the email message.
draftTypestringNoThe type of draft that need to be treated.
emailSizeBytesintegerNoIndicates an estimation of the size of the current email as a whole, in its final, ready to be sent form.
fromobjectYesfrom
historyIncludedbooleanNoIndicates whether the history of previous emails of the conversation is included within the email bodies of this message.
htmlBodystringNoThe html body of the email message.
idstringNoThe globally unique identifier for the object.
maxEmailSizeBytesintegerNoIndicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration
namestringNoname
replyToobjectNoreplyTo
selfUristringNoThe URI for this object
statestringNoThe state of the current draft.
subjectstringNoThe subject of the email message.
textBodystringYesThe text body of the email message.
timestringNoThe 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
toany[]YesThe recipients of the email message.

genesys_conversations_digital_post_email_messages_draft_attachments_copy

Copy attachments from an email message to the current draft. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
attachmentsany[]YesA list of attachments that will be copied from the source message to the current draft
sourceMessageobjectYessourceMessage

genesys_conversations_digital_post_email_participant_communication_wrapup

Apply wrap-up for this conversation communication Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
codestringNoThe user configured wrap up code id.
disableEndTimeUpdatesbooleanNoPrevent updates to wrapup end time when set to true.
durationSecondsintegerNoThe length of time in seconds that the agent spent doing after call work.
endTimestringNoThe timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoThe user configured wrap up code name.
notesstringNoText entered by the agent to describe the call or disposition.
provisionalbooleanNoIndicates 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.
tagsany[]NoList of tags selected by the agent to describe the call or disposition.

genesys_conversations_digital_post_email_participant_replace

Replace this participant with the specified user and/or address Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
addressstringNoThe 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.
keepInternalMessageAlivebooleanNoIf true, the digital internal message will NOT be terminated.
queueIdstringNoThe queue ID of the transfer target.
transferTypestringNoThe 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.
userIdstringNoThe user ID of the transfer target.
userNamestringNoThe user name of the transfer target.
voicemailbooleanNoIf true, transfer to the voicemail inbox of the participant that is being replaced.

genesys_conversations_digital_post_email_reconnect

Reconnect the user to the most recently disconnected customer on a fully disconnected email conversation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId

genesys_conversations_digital_post_emails

Create an email conversation Parameters:
ParameterTypeRequiredDefaultDescription
attributesobjectNoThe list of attributes to associate with the customer participant.
directionstringNoSpecify 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.
externalContactIdstringNoThe external contact with which the email should be associated. This field is only valid for OUTBOUND email.
flowIdstringNoThe ID of the flow to use for routing email conversation. This field is mutually exclusive with queueId
fromAddressstringNoThe email address of the sender of the email.
fromNamestringNoThe name of the sender of the email.
htmlBodystringNoAn HTML body content of the email.
languageIdstringNoThe ID of the language to use for routing.
priorityintegerNoThe priority to assign to the conversation for routing.
providerstringYesThe name of the provider that is sourcing the emails. The Provider “PureCloud Email” is reserved for native emails.
queueIdstringNoThe ID of the queue to use for routing the email conversation. This field is mutually exclusive with flowId
skillIdsany[]NoThe list of skill ID’s to use for routing.
subjectstringNoThe subject of the email
textBodystringNoA text body content of the email.
toAddressstringNoThe email address of the recipient of the email.
toNamestringNoThe name of the recipient of the email.
utilizationLabelstringNoOptional. The ID of the label to controls the number of agent interactions for INBOUND communications

genesys_conversations_digital_post_emails_agentless

Create an email conversation, per API Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringNoThe identifier of the conversation. This must be an email interaction.
fromAddressobjectYesfromAddress
htmlBodystringNoThe Content of the message, in HTML. Links, images and styles are allowed
replyToAddressobjectNoreplyToAddress
senderTypestringYesThe direction of the message.
subjectstringNoThe subject of the message.
textBodystringNoThe Content of the message, in plain text.
toAddressesany[]YesThe recipient of the message. We currently support one recipient only.

genesys_conversations_digital_post_faxes

Create Fax Conversation Parameters:
ParameterTypeRequiredDefaultDescription
addressesany[]YesA list of outbound fax dialing addresses. E.g. +13175555555 or 3175555555
contentTypestringNoThe content type that is going to be uploaded. If Content Management document is used for faxing, contentType will be ignored
coverSheetobjectNocoverSheet
documentIdstringNoDocumentId of Content Management artifact. If Content Management document is not used for faxing, documentId should be null
idstringNoThe globally unique identifier for the object.
namestringNoname
selfUristringNoThe URI for this object
timeZoneOffsetMinutesintegerNoTime zone offset minutes from GMT
workspaceobjectNoworkspace

genesys_conversations_digital_post_message_communication_messages

Send message Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
useNormalizedMessagebooleanNoIf true, response removes deprecated fields (textBody, media)
mediaIdsany[]NoThe media ids associated with the text message. See https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload for example usage.
messagingTemplateobjectNomessagingTemplate
textBodystringYesThe body of the text message. Maximum character counts are: SMS - 765 characters, other channels - 2000 characters.

genesys_conversations_digital_post_message_communication_messages_media_uploads

Create a URL to upload a message media file Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
contentLengthBytesintegerYesThe length of the file to upload in bytes
contentMd5stringNoContent MD5 of the file to upload
fileNamestringYesName 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: &#123;^}%`]”>[~<#|

genesys_conversations_digital_post_message_communication_socialmedia_messages

Send a social media message Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
inReplyToMessageIdstringYesThe ID of the message to which this request is replying.
mediaIdsany[]NoThe media ids associated with the text message. See https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload for example usage.
textBodystringNoThe body of the text message. Maximum character count is 2000 characters.

genesys_conversations_digital_post_message_communication_typing

Send message typing event Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
communicationIdstringYescommunicationId
dateSentstringNoThe 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
typingobjectYesA Typing event.

genesys_conversations_digital_post_message_inbound_open_event

Send an inbound Open Event Message Parameters:
ParameterTypeRequiredDefaultDescription
integrationIdstringYesintegrationId
channelobjectYesOpen Channel-specific information that describes the message and the message channel/provider.
eventsany[]YesList of event elements.

genesys_conversations_digital_post_message_inbound_open_message

Send inbound Open Message Parameters:
ParameterTypeRequiredDefaultDescription
integrationIdstringYesintegrationId
prefetchConversationIdbooleanNoIndicates whether or not to prefetch conversationId
channelobjectYesOpen Channel-specific information that describes the message and the message channel/provider, with additional message information
contentany[]NoList of content elements.
metadataobjectNoAdditional metadata about this message to capture non-channel specific data.
textstringNoMessage text.

genesys_conversations_digital_post_message_inbound_open_receipt

Send an inbound Open Receipt Message Parameters:
ParameterTypeRequiredDefaultDescription
integrationIdstringYesintegrationId
channelobjectYesOpen Channel-specific information that describes the message and the message channel/provider.
idstringYesThe original unique message Id generated by the messaging platform, that this receipt message is referencing.
isFinalReceiptbooleanNoIndicates if this is the last message receipt for this message, or if another message receipt can be expected.
reasonsany[]NoList of reasons for a message receipt that indicates the message has failed. Only used with Failed status.
statusstringYesMessage receipt status.

genesys_conversations_digital_post_message_inbound_open_structured_response

Send inbound Open Response Parameters:
ParameterTypeRequiredDefaultDescription
integrationIdstringYesintegrationId
buttonResponseobjectYesButton response object representing the click of a structured message button, such as a quick reply.
channelobjectYesOpen Channel-specific information that describes the message and the message channel/provider, with additional message information
originatingMessageIdstringYesId of original structured message that this messages responds to.

genesys_conversations_digital_post_message_participant_communication_wrapup

Apply wrap-up for this conversation communication Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
codestringNoThe user configured wrap up code id.
disableEndTimeUpdatesbooleanNoPrevent updates to wrapup end time when set to true.
durationSecondsintegerNoThe length of time in seconds that the agent spent doing after call work.
endTimestringNoThe timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoThe user configured wrap up code name.
notesstringNoText entered by the agent to describe the call or disposition.
provisionalbooleanNoIndicates 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.
tagsany[]NoList of tags selected by the agent to describe the call or disposition.

genesys_conversations_digital_post_message_participant_monitor

Listen in on the conversation from the point of view of a given participant. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId

genesys_conversations_digital_post_message_participant_replace

Replace this participant with the specified user and/or address Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
addressstringNoThe 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.
keepInternalMessageAlivebooleanNoIf true, the digital internal message will NOT be terminated.
queueIdstringNoThe queue ID of the transfer target.
transferTypestringNoThe 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.
userIdstringNoThe user ID of the transfer target.
userNamestringNoThe user name of the transfer target.
voicemailbooleanNoIf true, transfer to the voicemail inbox of the participant that is being replaced.

genesys_conversations_digital_post_messages

Create an outbound messaging conversation. Parameters:
ParameterTypeRequiredDefaultDescription
externalContactIdstringNoThe external contact with which the message will be associated.
queueIdstringYesThe 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.
toAddressstringYesThe 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
toAddressMessengerTypestringYesThe messaging address messenger type.
useExistingConversationbooleanNoAn 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.
useUserFromAddressbooleanNoAn 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.

genesys_conversations_digital_post_messages_agentless

Send an agentless outbound message Parameters:
ParameterTypeRequiredDefaultDescription
useNormalizedMessagebooleanNoIf true, response removes deprecated fields (textBody, messagingTemplate)
fromAddressstringYesThe 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 messenger type use the provisioned WhatsApp integration’s ID
messagingTemplateobjectNomessagingTemplate
textBodystringNoThe 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.
toAddressstringYesThe 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 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
toAddressMessengerTypestringYesThe recipient messaging address messenger type.
useExistingActiveConversationbooleanNoUse an existing active conversation to send the agentless outbound message. Set this parameter to ‘true’ to use active conversation. Default value: false

genesys_conversations_digital_post_social_participant_communication_wrapup

Apply wrap-up for this conversation communication Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
codestringNoThe user configured wrap up code id.
disableEndTimeUpdatesbooleanNoPrevent updates to wrapup end time when set to true.
durationSecondsintegerNoThe length of time in seconds that the agent spent doing after call work.
endTimestringNoThe timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoThe user configured wrap up code name.
notesstringNoText entered by the agent to describe the call or disposition.
provisionalbooleanNoIndicates 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.
tagsany[]NoList of tags selected by the agent to describe the call or disposition.

genesys_conversations_digital_post_video_participant_communication_wrapup

Apply wrap-up for this conversation communication Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
participantIdstringYesparticipantId
communicationIdstringYescommunicationId
codestringNoThe user configured wrap up code id.
disableEndTimeUpdatesbooleanNoPrevent updates to wrapup end time when set to true.
durationSecondsintegerNoThe length of time in seconds that the agent spent doing after call work.
endTimestringNoThe timestamp when the wrapup was finished. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoThe user configured wrap up code name.
notesstringNoText entered by the agent to describe the call or disposition.
provisionalbooleanNoIndicates 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.
tagsany[]NoList of tags selected by the agent to describe the call or disposition.

genesys_conversations_digital_post_videos_meetings

Generate a meetingId for a given conferenceId Parameters:
ParameterTypeRequiredDefaultDescription
conferenceIdstringNoThe conferenceId for which to generate a meetingId
ephemeralbooleanYesBoolean flag for ephemeral status of the created record
expireTimeDaysintegerNoNumber of days the meetingId record will remain active

genesys_conversations_digital_put_email_messages_draft

Update conversation draft reply Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesconversationId
attachmentsany[]NoThe attachments of the email message.
bccany[]NoThe recipients that were blind copied on the email message.
ccany[]NoThe recipients that were copied on the email message.
draftTypestringNoThe type of draft that need to be treated.
emailSizeBytesintegerNoIndicates an estimation of the size of the current email as a whole, in its final, ready to be sent form.
fromobjectYesfrom
historyIncludedbooleanNoIndicates whether the history of previous emails of the conversation is included within the email bodies of this message.
htmlBodystringNoThe html body of the email message.
idstringNoThe globally unique identifier for the object.
maxEmailSizeBytesintegerNoIndicates the maximum allowed size for an email to be send via SMTP server, based on the email domain configuration
namestringNoname
replyToobjectNoreplyTo
selfUristringNoThe URI for this object
statestringNoThe state of the current draft.
subjectstringNoThe subject of the email message.
textBodystringYesThe text body of the email message.
timestringNoThe 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
toany[]YesThe recipients of the email message.