/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 | — | Conversation Id |
attachmentId | string | Yes | — | Attachment Id |
genesys_conversations_digital_get_cobrowsesession
Get cobrowse conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation Id |
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 | — | Conversation Id |
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 |
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. |
genesys_conversations_digital_get_email_messages_draft
Get conversation draft reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation Id |
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. |
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. |
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 |
genesys_conversations_digital_get_email_settings
Get emails settings for a given conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation Id |
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 | — | Conversation Id |
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 | — | Conversation Id |
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 |
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 |
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) |
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) |
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. |
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. |
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 |
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 | — | 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. |
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. |
genesys_conversations_digital_get_videos_meeting
Gets a record for a given meetingId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
meetingId | string | Yes | — | Meeting Id |
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 | 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 | — | The name value |
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 | — | 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 |
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. |
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. |
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. |
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. |
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 | 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 | — | The name value |
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 | — | 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. |
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. |
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. |
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 | 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 | — | Conversation Id |
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 | — | 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 | 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 | — | Conversation Id |
attachments | any[] | Yes | — | A list of attachments that will be copied from the source message to the current draft |
sourceMessage | object | Yes | — | Source Message |
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 | 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 | — | 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. |
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 |
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 | — | 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 | 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 | — | 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 |
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 | 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 | — | Messaging Template |
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 | — | 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: {^}%`]”>[~<#| |
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 | 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 | — | 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. |
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 | 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 | — | 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 | 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 | — | 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 | 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 | — | 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. |
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 | 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 | — | Conversation Id |
participantId | string | Yes | — | Participant Id |
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. |
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 | — | 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 | 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 | — | 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 | 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 | — | 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 | 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 | — | Conversation Id |
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 | — | 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 | any[] | Yes | — | The recipients of the email message. |

