/genesys-conversations-digital | Type: Application | PCID required: Yes
Tools
genesys_conversations_digital_delete_email_messages_draft_attachment
Delete attachment from draft Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
attachmentId | string | Yes | — | attachmentId |
genesys_conversations_digital_get_cobrowsesession
Get cobrowse conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
genesys_conversations_digital_get_cobrowsesessions
Get active cobrowse conversations for the logged in usergenesys_conversations_digital_get_email
Get email conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
genesys_conversations_digital_get_email_message
Get conversation message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
messageId | string | Yes | — | messageId |
genesys_conversations_digital_get_email_messages
Get conversation messages Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
genesys_conversations_digital_get_email_messages_draft
Get conversation draft reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | 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 | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
provisional | boolean | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
provisional | boolean | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
genesys_conversations_digital_get_email_settings
Get emails settings for a given conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
genesys_conversations_digital_get_message_communication_messages_media
Get message media list by status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
status | string | No | — | The status on which to filter the response. |
pageNumber | integer | No | — | Page number |
pageSize | integer | No | — | Page size |
genesys_conversations_digital_get_message_communication_messages_media_media_id
Get media Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
mediaId | string | Yes | — | mediaId |
genesys_conversations_digital_get_message_details
Get message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
messageId | string | Yes | — | messageId |
useNormalizedMessage | boolean | No | — | If true, response removes deprecated fields (textBody, media) |
genesys_conversations_digital_get_message_message
Get conversation message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
messageId | string | Yes | — | messageId |
useNormalizedMessage | boolean | No | — | If true, response removes deprecated fields (textBody, media) |
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 | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
provisional | boolean | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
provisional | boolean | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
expand | any[] | 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 |
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 | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
provisional | boolean | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
provisional | boolean | No | — | Indicates whether or not to fetch provisional wrap-up code. |
genesys_conversations_digital_get_videos_meeting
Gets a record for a given meetingId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
meetingId | string | Yes | — | meetingId |
genesys_conversations_digital_patch_email
Update a conversation by disconnecting all of the participants Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
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 | any[] | 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 | any[] | 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 | — | name |
participants | any[] | Yes | — | The list of all participants in the conversation. |
recentTransfers | any[] | 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 |
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 | — | conversationId |
autoFill | boolean | No | — | autoFill |
discard | boolean | No | — | discard |
draftType | string | No | — | The kind of draft that as to be treated. Used to prefix response subject or auto-include information |
translate | object | No | — | translate |
genesys_conversations_digital_patch_email_participant
Update conversation participant Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
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. |
state | string | No | — | The state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’. |
wrapup | object | No | — | wrapup |
wrapupSkipped | boolean | No | — | True to skip wrap-up for this participant. |
genesys_conversations_digital_patch_email_participant_attributes
Update the attributes on a conversation participant. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
attributes | object | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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. |
state | string | No | — | The state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’. |
wrapup | object | No | — | wrapup |
wrapupSkipped | boolean | No | — | True to skip wrap-up for this participant. |
genesys_conversations_digital_patch_email_participant_parkingstate
Update conversation by setting its parking state Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
state | string | Yes | — | State to set the participant. |
genesys_conversations_digital_patch_message
Update a conversation by disconnecting all of the participants Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
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 | any[] | 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 | any[] | 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 | — | name |
participants | any[] | Yes | — | The list of all participants in the conversation. |
recentTransfers | any[] | 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 |
genesys_conversations_digital_patch_message_participant
Update conversation participant Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
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. |
state | string | No | — | The state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’. |
wrapup | object | No | — | wrapup |
wrapupSkipped | boolean | No | — | True to skip wrap-up for this participant. |
genesys_conversations_digital_patch_message_participant_attributes
Update the attributes on a conversation participant. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
attributes | object | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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. |
state | string | No | — | The state to update to set for this participant’s communications. Possible values are: ‘connected’ and ‘disconnected’. |
wrapup | object | No | — | wrapup |
wrapupSkipped | boolean | No | — | True 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
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 | any[] | 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. |
genesys_conversations_digital_post_email_messages
Send an email reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
attachments | any[] | No | — | The attachments of the email message. |
bcc | any[] | No | — | The recipients that were blind copied on the email message. |
cc | any[] | 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 | — | from |
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 | — | name |
replyTo | object | No | — | replyTo |
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 | any[] | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
attachments | any[] | Yes | — | A list of attachments that will be copied from the source message to the current draft |
sourceMessage | object | Yes | — | 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 | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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 | any[] | No | — | List 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
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. |
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 | — | 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 |
skillIds | any[] | 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 |
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 | — | fromAddress |
htmlBody | string | No | — | The Content of the message, in HTML. Links, images and styles are allowed |
replyToAddress | object | No | — | replyToAddress |
senderType | string | Yes | — | The direction of the message. |
subject | string | No | — | The subject of the message. |
textBody | string | No | — | The Content of the message, in plain text. |
toAddresses | any[] | Yes | — | The recipient of the message. We currently support one recipient only. |
genesys_conversations_digital_post_faxes
Create Fax Conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
addresses | any[] | 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 | — | coverSheet |
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 | — | name |
selfUri | string | No | — | The URI for this object |
timeZoneOffsetMinutes | integer | No | — | Time zone offset minutes from GMT |
workspace | object | No | — | workspace |
genesys_conversations_digital_post_message_communication_messages
Send message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
useNormalizedMessage | boolean | No | — | If true, response removes deprecated fields (textBody, media) |
mediaIds | any[] | No | — | The media ids associated with the text message. See https://developer.genesys.cloud/api/rest/v2/conversations/messaging-media-upload for example usage. |
messagingTemplate | object | No | — | messagingTemplate |
textBody | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
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: {^}%`]”>[~<#| |
genesys_conversations_digital_post_message_communication_socialmedia_messages
Send a social media message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
inReplyToMessageId | string | Yes | — | The ID of the message to which this request is replying. |
mediaIds | any[] | No | — | The media ids associated with the text message. See 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. |
genesys_conversations_digital_post_message_communication_typing
Send message typing event Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
communicationId | string | Yes | — | communicationId |
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. |
genesys_conversations_digital_post_message_inbound_open_event
Send an inbound Open Event Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
integrationId | string | Yes | — | integrationId |
channel | object | Yes | — | Open Channel-specific information that describes the message and the message channel/provider. |
events | any[] | Yes | — | List of event elements. |
genesys_conversations_digital_post_message_inbound_open_message
Send inbound Open Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
integrationId | string | Yes | — | integrationId |
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 | any[] | No | — | List of content elements. |
metadata | object | No | — | Additional metadata about this message to capture non-channel specific data. |
text | string | No | — | Message text. |
genesys_conversations_digital_post_message_inbound_open_receipt
Send an inbound Open Receipt Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
integrationId | string | Yes | — | integrationId |
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 | any[] | 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. |
genesys_conversations_digital_post_message_inbound_open_structured_response
Send inbound Open Response Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
integrationId | string | Yes | — | integrationId |
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. |
genesys_conversations_digital_post_message_participant_communication_wrapup
Apply wrap-up for this conversation communication Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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 | any[] | No | — | List 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | 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 | — | conversationId |
participantId | string | Yes | — | participantId |
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. |
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. |
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 messenger type use the provisioned WhatsApp integration’s ID |
messagingTemplate | object | No | — | messagingTemplate |
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 | 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 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 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 |
genesys_conversations_digital_post_social_participant_communication_wrapup
Apply wrap-up for this conversation communication Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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 | any[] | No | — | List 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
participantId | string | Yes | — | participantId |
communicationId | string | Yes | — | communicationId |
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 | any[] | No | — | List 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:| 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 |
genesys_conversations_digital_put_email_messages_draft
Update conversation draft reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | conversationId |
attachments | any[] | No | — | The attachments of the email message. |
bcc | any[] | No | — | The recipients that were blind copied on the email message. |
cc | any[] | 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 | — | from |
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 | — | name |
replyTo | object | No | — | replyTo |
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 | any[] | Yes | — | The recipients of the email message. |

