---
title: ConversationsApi
---
## PureCloud::ConversationsApi
All URIs are relative to *https://api.mypurecloud.com*
Method | Description
------------- | ------------- | -------------
[**delete_analytics_conversations_details_job**](ConversationsApi.html#delete_analytics_conversations_details_job) | Delete/cancel an async request
[**delete_conversation_participant_code**](ConversationsApi.html#delete_conversation_participant_code) | Delete a code used to add a communication to this participant
[**delete_conversation_participant_flaggedreason**](ConversationsApi.html#delete_conversation_participant_flaggedreason) | Remove flagged reason from conversation participant.
[**delete_conversations_call_participant_consult**](ConversationsApi.html#delete_conversations_call_participant_consult) | Cancel the transfer
[**delete_conversations_email_messages_draft_attachment**](ConversationsApi.html#delete_conversations_email_messages_draft_attachment) | Delete attachment from draft
[**delete_conversations_messaging_integrations_facebook_integration_id**](ConversationsApi.html#delete_conversations_messaging_integrations_facebook_integration_id) | Delete a Facebook messaging integration
[**delete_conversations_messaging_integrations_line_integration_id**](ConversationsApi.html#delete_conversations_messaging_integrations_line_integration_id) | Delete a LINE messenger integration
[**delete_conversations_messaging_integrations_twitter_integration_id**](ConversationsApi.html#delete_conversations_messaging_integrations_twitter_integration_id) | Delete a Twitter messaging integration
[**delete_conversations_messaging_integrations_whatsapp_integration_id**](ConversationsApi.html#delete_conversations_messaging_integrations_whatsapp_integration_id) | Delete a WhatsApp messaging integration
[**get_analytics_conversation_details**](ConversationsApi.html#get_analytics_conversation_details) | Get a conversation by id
[**get_analytics_conversations_details**](ConversationsApi.html#get_analytics_conversations_details) | Gets multiple conversations by id
[**get_analytics_conversations_details_job**](ConversationsApi.html#get_analytics_conversations_details_job) | Get status for async query for conversation details
[**get_analytics_conversations_details_job_results**](ConversationsApi.html#get_analytics_conversations_details_job_results) | Fetch a page of results for an async query
[**get_conversation**](ConversationsApi.html#get_conversation) | Get conversation
[**get_conversation_participant_secureivrsession**](ConversationsApi.html#get_conversation_participant_secureivrsession) | Fetch info on a secure session
[**get_conversation_participant_secureivrsessions**](ConversationsApi.html#get_conversation_participant_secureivrsessions) | Get a list of secure sessions for this participant.
[**get_conversation_participant_wrapup**](ConversationsApi.html#get_conversation_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversation_participant_wrapupcodes**](ConversationsApi.html#get_conversation_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations**](ConversationsApi.html#get_conversations) | Get active conversations for the logged in user
[**get_conversations_call**](ConversationsApi.html#get_conversations_call) | Get call conversation
[**get_conversations_call_participant_wrapup**](ConversationsApi.html#get_conversations_call_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_call_participant_wrapupcodes**](ConversationsApi.html#get_conversations_call_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_callback**](ConversationsApi.html#get_conversations_callback) | Get callback conversation
[**get_conversations_callback_participant_wrapup**](ConversationsApi.html#get_conversations_callback_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_callback_participant_wrapupcodes**](ConversationsApi.html#get_conversations_callback_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_callbacks**](ConversationsApi.html#get_conversations_callbacks) | Get active callback conversations for the logged in user
[**get_conversations_calls**](ConversationsApi.html#get_conversations_calls) | Get active call conversations for the logged in user
[**get_conversations_calls_history**](ConversationsApi.html#get_conversations_calls_history) | Get call history
[**get_conversations_calls_maximumconferenceparties**](ConversationsApi.html#get_conversations_calls_maximumconferenceparties) | Get the maximum number of participants that this user can have on a conference
[**get_conversations_chat**](ConversationsApi.html#get_conversations_chat) | Get chat conversation
[**get_conversations_chat_message**](ConversationsApi.html#get_conversations_chat_message) | Get a web chat conversation message
[**get_conversations_chat_messages**](ConversationsApi.html#get_conversations_chat_messages) | Get the messages of a chat conversation.
[**get_conversations_chat_participant_wrapup**](ConversationsApi.html#get_conversations_chat_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_chat_participant_wrapupcodes**](ConversationsApi.html#get_conversations_chat_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_chats**](ConversationsApi.html#get_conversations_chats) | Get active chat conversations for the logged in user
[**get_conversations_cobrowsesession**](ConversationsApi.html#get_conversations_cobrowsesession) | Get cobrowse conversation
[**get_conversations_cobrowsesession_participant_wrapup**](ConversationsApi.html#get_conversations_cobrowsesession_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_cobrowsesession_participant_wrapupcodes**](ConversationsApi.html#get_conversations_cobrowsesession_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_cobrowsesessions**](ConversationsApi.html#get_conversations_cobrowsesessions) | Get active cobrowse conversations for the logged in user
[**get_conversations_email**](ConversationsApi.html#get_conversations_email) | Get email conversation
[**get_conversations_email_message**](ConversationsApi.html#get_conversations_email_message) | Get conversation message
[**get_conversations_email_messages**](ConversationsApi.html#get_conversations_email_messages) | Get conversation messages
[**get_conversations_email_messages_draft**](ConversationsApi.html#get_conversations_email_messages_draft) | Get conversation draft reply
[**get_conversations_email_participant_wrapup**](ConversationsApi.html#get_conversations_email_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_email_participant_wrapupcodes**](ConversationsApi.html#get_conversations_email_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_emails**](ConversationsApi.html#get_conversations_emails) | Get active email conversations for the logged in user
[**get_conversations_message**](ConversationsApi.html#get_conversations_message) | Get message conversation
[**get_conversations_message_communication_messages_media_media_id**](ConversationsApi.html#get_conversations_message_communication_messages_media_media_id) | Get media
[**get_conversations_message_message**](ConversationsApi.html#get_conversations_message_message) | Get message
[**get_conversations_message_participant_wrapup**](ConversationsApi.html#get_conversations_message_participant_wrapup) | Get the wrap-up for this conversation participant.
[**get_conversations_message_participant_wrapupcodes**](ConversationsApi.html#get_conversations_message_participant_wrapupcodes) | Get list of wrapup codes for this conversation participant
[**get_conversations_messages**](ConversationsApi.html#get_conversations_messages) | Get active message conversations for the logged in user
[**get_conversations_messaging_integrations**](ConversationsApi.html#get_conversations_messaging_integrations) | Get a list of Integrations
[**get_conversations_messaging_integrations_facebook**](ConversationsApi.html#get_conversations_messaging_integrations_facebook) | Get a list of Facebook Integrations
[**get_conversations_messaging_integrations_facebook_integration_id**](ConversationsApi.html#get_conversations_messaging_integrations_facebook_integration_id) | Get a Facebook messaging integration
[**get_conversations_messaging_integrations_line**](ConversationsApi.html#get_conversations_messaging_integrations_line) | Get a list of LINE messenger Integrations
[**get_conversations_messaging_integrations_line_integration_id**](ConversationsApi.html#get_conversations_messaging_integrations_line_integration_id) | Get a LINE messenger integration
[**get_conversations_messaging_integrations_twitter**](ConversationsApi.html#get_conversations_messaging_integrations_twitter) | Get a list of Twitter Integrations
[**get_conversations_messaging_integrations_twitter_integration_id**](ConversationsApi.html#get_conversations_messaging_integrations_twitter_integration_id) | Get a Twitter messaging integration
[**get_conversations_messaging_integrations_whatsapp**](ConversationsApi.html#get_conversations_messaging_integrations_whatsapp) | Get a list of WhatsApp Integrations
[**get_conversations_messaging_integrations_whatsapp_integration_id**](ConversationsApi.html#get_conversations_messaging_integrations_whatsapp_integration_id) | Get a WhatsApp messaging integration
[**get_conversations_messaging_sticker**](ConversationsApi.html#get_conversations_messaging_sticker) | Get a list of Messaging Stickers
[**patch_conversation_participant**](ConversationsApi.html#patch_conversation_participant) | Update a participant.
[**patch_conversation_participant_attributes**](ConversationsApi.html#patch_conversation_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_call**](ConversationsApi.html#patch_conversations_call) | Update a conversation by setting it's recording state, merging in other conversations to create a conference, or disconnecting all of the participants
[**patch_conversations_call_participant**](ConversationsApi.html#patch_conversations_call_participant) | Update conversation participant
[**patch_conversations_call_participant_attributes**](ConversationsApi.html#patch_conversations_call_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_call_participant_communication**](ConversationsApi.html#patch_conversations_call_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_call_participant_consult**](ConversationsApi.html#patch_conversations_call_participant_consult) | Change who can speak
[**patch_conversations_callback**](ConversationsApi.html#patch_conversations_callback) | Update a conversation by disconnecting all of the participants
[**patch_conversations_callback_participant**](ConversationsApi.html#patch_conversations_callback_participant) | Update conversation participant
[**patch_conversations_callback_participant_attributes**](ConversationsApi.html#patch_conversations_callback_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_callback_participant_communication**](ConversationsApi.html#patch_conversations_callback_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_chat**](ConversationsApi.html#patch_conversations_chat) | Update a conversation by disconnecting all of the participants
[**patch_conversations_chat_participant**](ConversationsApi.html#patch_conversations_chat_participant) | Update conversation participant
[**patch_conversations_chat_participant_attributes**](ConversationsApi.html#patch_conversations_chat_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_chat_participant_communication**](ConversationsApi.html#patch_conversations_chat_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_cobrowsesession**](ConversationsApi.html#patch_conversations_cobrowsesession) | Update a conversation by disconnecting all of the participants
[**patch_conversations_cobrowsesession_participant**](ConversationsApi.html#patch_conversations_cobrowsesession_participant) | Update conversation participant
[**patch_conversations_cobrowsesession_participant_attributes**](ConversationsApi.html#patch_conversations_cobrowsesession_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_cobrowsesession_participant_communication**](ConversationsApi.html#patch_conversations_cobrowsesession_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_email**](ConversationsApi.html#patch_conversations_email) | Update a conversation by disconnecting all of the participants
[**patch_conversations_email_participant**](ConversationsApi.html#patch_conversations_email_participant) | Update conversation participant
[**patch_conversations_email_participant_attributes**](ConversationsApi.html#patch_conversations_email_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_email_participant_communication**](ConversationsApi.html#patch_conversations_email_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_message**](ConversationsApi.html#patch_conversations_message) | Update a conversation by disconnecting all of the participants
[**patch_conversations_message_participant**](ConversationsApi.html#patch_conversations_message_participant) | Update conversation participant
[**patch_conversations_message_participant_attributes**](ConversationsApi.html#patch_conversations_message_participant_attributes) | Update the attributes on a conversation participant.
[**patch_conversations_message_participant_communication**](ConversationsApi.html#patch_conversations_message_participant_communication) | Update conversation participant's communication by disconnecting it.
[**patch_conversations_messaging_integrations_whatsapp_integration_id**](ConversationsApi.html#patch_conversations_messaging_integrations_whatsapp_integration_id) | Activate a WhatsApp messaging integration.
[**post_analytics_conversation_details_properties**](ConversationsApi.html#post_analytics_conversation_details_properties) | Index conversation properties
[**post_analytics_conversations_aggregates_query**](ConversationsApi.html#post_analytics_conversations_aggregates_query) | Query for conversation aggregates
[**post_analytics_conversations_details_jobs**](ConversationsApi.html#post_analytics_conversations_details_jobs) | Query for conversation details asynchronously
[**post_analytics_conversations_details_query**](ConversationsApi.html#post_analytics_conversations_details_query) | Query for conversation details
[**post_conversation_disconnect**](ConversationsApi.html#post_conversation_disconnect) | Performs a full conversation teardown. Issues disconnect requests for any connected media. Applies a system wrap-up code to any participants that are pending wrap-up. This is not intended to be the normal way of ending interactions but is available in the event of problems with the application to allow a resyncronization of state across all components. It is recommended that users submit a support case if they are relying on this endpoint systematically as there is likely something that needs investigation.
[**post_conversation_participant_callbacks**](ConversationsApi.html#post_conversation_participant_callbacks) | Create a new callback for the specified participant on the conversation.
[**post_conversation_participant_digits**](ConversationsApi.html#post_conversation_participant_digits) | Sends DTMF to the participant
[**post_conversation_participant_replace**](ConversationsApi.html#post_conversation_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversation_participant_secureivrsessions**](ConversationsApi.html#post_conversation_participant_secureivrsessions) | Create secure IVR session. Only a participant in the conversation can invoke a secure IVR.
[**post_conversations_call**](ConversationsApi.html#post_conversations_call) | Place a new call as part of a callback conversation.
[**post_conversations_call_participant_consult**](ConversationsApi.html#post_conversations_call_participant_consult) | Initiate and update consult transfer
[**post_conversations_call_participant_monitor**](ConversationsApi.html#post_conversations_call_participant_monitor) | Listen in on the conversation from the point of view of a given participant.
[**post_conversations_call_participant_replace**](ConversationsApi.html#post_conversations_call_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_call_participants**](ConversationsApi.html#post_conversations_call_participants) | Add participants to a conversation
[**post_conversations_callback_participant_replace**](ConversationsApi.html#post_conversations_callback_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_callbacks**](ConversationsApi.html#post_conversations_callbacks) | Create a Callback
[**post_conversations_calls**](ConversationsApi.html#post_conversations_calls) | Create a call conversation
[**post_conversations_chat_communication_messages**](ConversationsApi.html#post_conversations_chat_communication_messages) | Send a message on behalf of a communication in a chat conversation.
[**post_conversations_chat_communication_typing**](ConversationsApi.html#post_conversations_chat_communication_typing) | Send a typing-indicator on behalf of a communication in a chat conversation.
[**post_conversations_chat_participant_replace**](ConversationsApi.html#post_conversations_chat_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_chats**](ConversationsApi.html#post_conversations_chats) | Create a web chat conversation
[**post_conversations_cobrowsesession_participant_replace**](ConversationsApi.html#post_conversations_cobrowsesession_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_email_inboundmessages**](ConversationsApi.html#post_conversations_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.
[**post_conversations_email_messages**](ConversationsApi.html#post_conversations_email_messages) | Send an email reply
[**post_conversations_email_messages_draft_attachments_copy**](ConversationsApi.html#post_conversations_email_messages_draft_attachments_copy) | Copy attachments from an email message to the current draft.
[**post_conversations_email_participant_replace**](ConversationsApi.html#post_conversations_email_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_emails**](ConversationsApi.html#post_conversations_emails) | Create an email conversation
[**post_conversations_faxes**](ConversationsApi.html#post_conversations_faxes) | Create Fax Conversation
[**post_conversations_message_communication_messages**](ConversationsApi.html#post_conversations_message_communication_messages) | Send message
[**post_conversations_message_communication_messages_media**](ConversationsApi.html#post_conversations_message_communication_messages_media) | Create media
[**post_conversations_message_messages_bulk**](ConversationsApi.html#post_conversations_message_messages_bulk) | Get messages in batch
[**post_conversations_message_participant_replace**](ConversationsApi.html#post_conversations_message_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_messages**](ConversationsApi.html#post_conversations_messages) | Create an outbound messaging conversation.
[**post_conversations_messages_agentless**](ConversationsApi.html#post_conversations_messages_agentless) | Send an agentless outbound message
[**post_conversations_messaging_integrations_facebook**](ConversationsApi.html#post_conversations_messaging_integrations_facebook) | Create a Facebook Integration
[**post_conversations_messaging_integrations_line**](ConversationsApi.html#post_conversations_messaging_integrations_line) | Create a LINE messenger Integration
[**post_conversations_messaging_integrations_twitter**](ConversationsApi.html#post_conversations_messaging_integrations_twitter) | Create a Twitter Integration
[**post_conversations_messaging_integrations_whatsapp**](ConversationsApi.html#post_conversations_messaging_integrations_whatsapp) | Create a WhatsApp Integration
[**put_conversation_participant_flaggedreason**](ConversationsApi.html#put_conversation_participant_flaggedreason) | Set flagged reason on conversation participant to indicate bad conversation quality.
[**put_conversations_call_participant_communication_uuidata**](ConversationsApi.html#put_conversations_call_participant_communication_uuidata) | Set uuiData to be sent on future commands.
[**put_conversations_email_messages_draft**](ConversationsApi.html#put_conversations_email_messages_draft) | Update conversation draft reply
[**put_conversations_messaging_integrations_line_integration_id**](ConversationsApi.html#put_conversations_messaging_integrations_line_integration_id) | Update a LINE messenger integration
{: class="table table-striped"}
## delete_analytics_conversations_details_job(job_id)
Delete/cancel an async request
Wraps DELETE /api/v2/analytics/conversations/details/jobs/{jobId}
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
job_id = "job_id_example" # String | jobId
begin
#Delete/cancel an async request
api_instance.delete_analytics_conversations_details_job(job_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_analytics_conversations_details_job: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**job_id** | **String**| jobId | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversation_participant_code(conversation_id, participant_id, add_communication_code)
Delete a code used to add a communication to this participant
Wraps DELETE /api/v2/conversations/{conversationId}/participants/{participantId}/codes/{addCommunicationCode}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
add_communication_code = "add_communication_code_example" # String | addCommunicationCode
begin
#Delete a code used to add a communication to this participant
api_instance.delete_conversation_participant_code(conversation_id, participant_id, add_communication_code)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversation_participant_code: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**add_communication_code** | **String**| addCommunicationCode | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversation_participant_flaggedreason(conversation_id, participant_id)
Remove flagged reason from conversation participant.
Wraps DELETE /api/v2/conversations/{conversationId}/participants/{participantId}/flaggedreason
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
begin
#Remove flagged reason from conversation participant.
api_instance.delete_conversation_participant_flaggedreason(conversation_id, participant_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversation_participant_flaggedreason: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversations_call_participant_consult(conversation_id, participant_id)
Cancel the transfer
Wraps DELETE /api/v2/conversations/calls/{conversationId}/participants/{participantId}/consult
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Cancel the transfer
api_instance.delete_conversations_call_participant_consult(conversation_id, participant_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_call_participant_consult: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversations_email_messages_draft_attachment(conversation_id, attachment_id)
Delete attachment from draft
Wraps DELETE /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/{attachmentId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
attachment_id = "attachment_id_example" # String | attachmentId
begin
#Delete attachment from draft
api_instance.delete_conversations_email_messages_draft_attachment(conversation_id, attachment_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_email_messages_draft_attachment: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**attachment_id** | **String**| attachmentId | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversations_messaging_integrations_facebook_integration_id(integration_id)
Delete a Facebook messaging integration
Wraps DELETE /api/v2/conversations/messaging/integrations/facebook/{integrationId}
Requires ANY permissions:
* messaging:integration:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Delete a Facebook messaging integration
api_instance.delete_conversations_messaging_integrations_facebook_integration_id(integration_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_messaging_integrations_facebook_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversations_messaging_integrations_line_integration_id(integration_id)
Delete a LINE messenger integration
Wraps DELETE /api/v2/conversations/messaging/integrations/line/{integrationId}
Requires ANY permissions:
* messaging:integration:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Delete a LINE messenger integration
api_instance.delete_conversations_messaging_integrations_line_integration_id(integration_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_messaging_integrations_line_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## delete_conversations_messaging_integrations_twitter_integration_id(integration_id)
Delete a Twitter messaging integration
Wraps DELETE /api/v2/conversations/messaging/integrations/twitter/{integrationId}
Requires ANY permissions:
* messaging:integration:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Delete a Twitter messaging integration
api_instance.delete_conversations_messaging_integrations_twitter_integration_id(integration_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_messaging_integrations_twitter_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WhatsAppIntegration**](WhatsAppIntegration.html) delete_conversations_messaging_integrations_whatsapp_integration_id(integration_id)
Delete a WhatsApp messaging integration
Wraps DELETE /api/v2/conversations/messaging/integrations/whatsapp/{integrationId}
Requires ANY permissions:
* messaging:integration:delete
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Delete a WhatsApp messaging integration
result = api_instance.delete_conversations_messaging_integrations_whatsapp_integration_id(integration_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->delete_conversations_messaging_integrations_whatsapp_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
[**WhatsAppIntegration**](WhatsAppIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AnalyticsConversationWithoutAttributes**](AnalyticsConversationWithoutAttributes.html) get_analytics_conversation_details(conversation_id)
Get a conversation by id
Wraps GET /api/v2/analytics/conversations/{conversationId}/details
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get a conversation by id
result = api_instance.get_analytics_conversation_details(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_analytics_conversation_details: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**AnalyticsConversationWithoutAttributes**](AnalyticsConversationWithoutAttributes.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AnalyticsConversationWithoutAttributesMultiGetResponse**](AnalyticsConversationWithoutAttributesMultiGetResponse.html) get_analytics_conversations_details(opts)
Gets multiple conversations by id
Wraps GET /api/v2/analytics/conversations/details
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
id: ["id_example"] # Array | Comma-separated conversation ids
}
begin
#Gets multiple conversations by id
result = api_instance.get_analytics_conversations_details(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_analytics_conversations_details: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**Array<String>**](String.html)| Comma-separated conversation ids | [optional] |
{: class="table table-striped"}
### Return type
[**AnalyticsConversationWithoutAttributesMultiGetResponse**](AnalyticsConversationWithoutAttributesMultiGetResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AsyncQueryStatus**](AsyncQueryStatus.html) get_analytics_conversations_details_job(job_id)
Get status for async query for conversation details
Wraps GET /api/v2/analytics/conversations/details/jobs/{jobId}
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
job_id = "job_id_example" # String | jobId
begin
#Get status for async query for conversation details
result = api_instance.get_analytics_conversations_details_job(job_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_analytics_conversations_details_job: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**job_id** | **String**| jobId | |
{: class="table table-striped"}
### Return type
[**AsyncQueryStatus**](AsyncQueryStatus.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AnalyticsConversationAsyncQueryResponse**](AnalyticsConversationAsyncQueryResponse.html) get_analytics_conversations_details_job_results(job_id, opts)
Fetch a page of results for an async query
Wraps GET /api/v2/analytics/conversations/details/jobs/{jobId}/results
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
job_id = "job_id_example" # String | jobId
opts = {
cursor: "cursor_example", # String | Indicates where to resume query results (not required for first page)
page_size: 56 # Integer | The desired maximum number of results
}
begin
#Fetch a page of results for an async query
result = api_instance.get_analytics_conversations_details_job_results(job_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_analytics_conversations_details_job_results: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**job_id** | **String**| jobId | |
**cursor** | **String**| Indicates where to resume query results (not required for first page) | [optional] |
**page_size** | **Integer**| The desired maximum number of results | [optional] |
{: class="table table-striped"}
### Return type
[**AnalyticsConversationAsyncQueryResponse**](AnalyticsConversationAsyncQueryResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) get_conversation(conversation_id)
Get conversation
Wraps GET /api/v2/conversations/{conversationId}
Requires ANY permissions:
* conversation:communication:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
begin
#Get conversation
result = api_instance.get_conversation(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversation: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**SecureSession**](SecureSession.html) get_conversation_participant_secureivrsession(conversation_id, participant_id, secure_session_id)
Fetch info on a secure session
Wraps GET /api/v2/conversations/{conversationId}/participants/{participantId}/secureivrsessions/{secureSessionId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
secure_session_id = "secure_session_id_example" # String | secure IVR session ID
begin
#Fetch info on a secure session
result = api_instance.get_conversation_participant_secureivrsession(conversation_id, participant_id, secure_session_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversation_participant_secureivrsession: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**secure_session_id** | **String**| secure IVR session ID | |
{: class="table table-striped"}
### Return type
[**SecureSession**](SecureSession.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**SecureSessionEntityListing**](SecureSessionEntityListing.html) get_conversation_participant_secureivrsessions(conversation_id, participant_id)
Get a list of secure sessions for this participant.
Wraps GET /api/v2/conversations/{conversationId}/participants/{participantId}/secureivrsessions
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
begin
#Get a list of secure sessions for this participant.
result = api_instance.get_conversation_participant_secureivrsessions(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversation_participant_secureivrsessions: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
{: class="table table-striped"}
### Return type
[**SecureSessionEntityListing**](SecureSessionEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversation_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversation_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversation_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversation_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversation_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversation_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ConversationEntityListing**](ConversationEntityListing.html) get_conversations(opts)
Get active conversations for the logged in user
Wraps GET /api/v2/conversations
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
communication_type: "communication_type_example" # String | Call or Chat communication filtering
}
begin
#Get active conversations for the logged in user
result = api_instance.get_conversations(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**communication_type** | **String**| Call or Chat communication filtering | [optional] |
{: class="table table-striped"}
### Return type
[**ConversationEntityListing**](ConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CallConversation**](CallConversation.html) get_conversations_call(conversation_id)
Get call conversation
Wraps GET /api/v2/conversations/calls/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get call conversation
result = api_instance.get_conversations_call(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_call: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**CallConversation**](CallConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_call_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/calls/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_call_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_call_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_call_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/calls/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_call_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_call_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CallbackConversation**](CallbackConversation.html) get_conversations_callback(conversation_id)
Get callback conversation
Wraps GET /api/v2/conversations/callbacks/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get callback conversation
result = api_instance.get_conversations_callback(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_callback: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**CallbackConversation**](CallbackConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_callback_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_callback_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_callback_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_callback_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_callback_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_callback_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CallbackConversationEntityListing**](CallbackConversationEntityListing.html) get_conversations_callbacks
Get active callback conversations for the logged in user
Wraps GET /api/v2/conversations/callbacks
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active callback conversations for the logged in user
result = api_instance.get_conversations_callbacks
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_callbacks: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**CallbackConversationEntityListing**](CallbackConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CallConversationEntityListing**](CallConversationEntityListing.html) get_conversations_calls
Get active call conversations for the logged in user
Wraps GET /api/v2/conversations/calls
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active call conversations for the logged in user
result = api_instance.get_conversations_calls
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_calls: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**CallConversationEntityListing**](CallConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CallHistoryConversationEntityListing**](CallHistoryConversationEntityListing.html) get_conversations_calls_history(opts)
Get call history
Wraps GET /api/v2/conversations/calls/history
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size, maximum 50
page_number: 1, # Integer | Page number
interval: "interval_example", # String | Interval string; format is ISO-8601. Separate start and end times with forward slash '/'
expand: ["expand_example"] # Array | Which fields, if any, to expand.
}
begin
#Get call history
result = api_instance.get_conversations_calls_history(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_calls_history: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size, maximum 50 | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
**interval** | **String**| Interval string; format is ISO-8601. Separate start and end times with forward slash '/' | [optional] |
**expand** | [**Array<String>**](String.html)| Which fields, if any, to expand. | [optional]
**Values**: externalorganization, externalcontact, user, queue, group |
{: class="table table-striped"}
### Return type
[**CallHistoryConversationEntityListing**](CallHistoryConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MaxParticipants**](MaxParticipants.html) get_conversations_calls_maximumconferenceparties
Get the maximum number of participants that this user can have on a conference
Wraps GET /api/v2/conversations/calls/maximumconferenceparties
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get the maximum number of participants that this user can have on a conference
result = api_instance.get_conversations_calls_maximumconferenceparties
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_calls_maximumconferenceparties: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**MaxParticipants**](MaxParticipants.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ChatConversation**](ChatConversation.html) get_conversations_chat(conversation_id)
Get chat conversation
Wraps GET /api/v2/conversations/chats/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get chat conversation
result = api_instance.get_conversations_chat(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chat: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**ChatConversation**](ChatConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WebChatMessage**](WebChatMessage.html) get_conversations_chat_message(conversation_id, message_id)
Get a web chat conversation message
The current user must be involved with the conversation to get its messages.
Wraps GET /api/v2/conversations/chats/{conversationId}/messages/{messageId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
message_id = "message_id_example" # String | messageId
begin
#Get a web chat conversation message
result = api_instance.get_conversations_chat_message(conversation_id, message_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chat_message: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**message_id** | **String**| messageId | |
{: class="table table-striped"}
### Return type
[**WebChatMessage**](WebChatMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WebChatMessageEntityList**](WebChatMessageEntityList.html) get_conversations_chat_messages(conversation_id, opts)
Get the messages of a chat conversation.
The current user must be involved with the conversation to get its messages.
Wraps GET /api/v2/conversations/chats/{conversationId}/messages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
opts = {
after: "after_example", # String | If specified, get the messages chronologically after the id of this message
before: "before_example", # String | If specified, get the messages chronologically before the id of this message
sort_order: "ascending", # String | Sort order
max_results: 100 # Integer | Limit the returned number of messages, up to a maximum of 100
}
begin
#Get the messages of a chat conversation.
result = api_instance.get_conversations_chat_messages(conversation_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chat_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**after** | **String**| If specified, get the messages chronologically after the id of this message | [optional] |
**before** | **String**| If specified, get the messages chronologically before the id of this message | [optional] |
**sort_order** | **String**| Sort order | [optional] [default to ascending]
**Values**: ascending, descending |
**max_results** | **Integer**| Limit the returned number of messages, up to a maximum of 100 | [optional] [default to 100] |
{: class="table table-striped"}
### Return type
[**WebChatMessageEntityList**](WebChatMessageEntityList.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_chat_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/chats/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_chat_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chat_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_chat_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/chats/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_chat_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chat_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ChatConversationEntityListing**](ChatConversationEntityListing.html) get_conversations_chats
Get active chat conversations for the logged in user
Wraps GET /api/v2/conversations/chats
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active chat conversations for the logged in user
result = api_instance.get_conversations_chats
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_chats: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**ChatConversationEntityListing**](ChatConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CobrowseConversation**](CobrowseConversation.html) get_conversations_cobrowsesession(conversation_id)
Get cobrowse conversation
Wraps GET /api/v2/conversations/cobrowsesessions/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get cobrowse conversation
result = api_instance.get_conversations_cobrowsesession(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_cobrowsesession: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**CobrowseConversation**](CobrowseConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_cobrowsesession_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_cobrowsesession_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_cobrowsesession_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_cobrowsesession_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_cobrowsesession_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_cobrowsesession_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CobrowseConversationEntityListing**](CobrowseConversationEntityListing.html) get_conversations_cobrowsesessions
Get active cobrowse conversations for the logged in user
Wraps GET /api/v2/conversations/cobrowsesessions
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active cobrowse conversations for the logged in user
result = api_instance.get_conversations_cobrowsesessions
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_cobrowsesessions: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**CobrowseConversationEntityListing**](CobrowseConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailConversation**](EmailConversation.html) get_conversations_email(conversation_id)
Get email conversation
Wraps GET /api/v2/conversations/emails/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get email conversation
result = api_instance.get_conversations_email(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**EmailConversation**](EmailConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessage**](EmailMessage.html) get_conversations_email_message(conversation_id, message_id)
Get conversation message
Wraps GET /api/v2/conversations/emails/{conversationId}/messages/{messageId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
message_id = "message_id_example" # String | messageId
begin
#Get conversation message
result = api_instance.get_conversations_email_message(conversation_id, message_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email_message: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**message_id** | **String**| messageId | |
{: class="table table-striped"}
### Return type
[**EmailMessage**](EmailMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessageListing**](EmailMessageListing.html) get_conversations_email_messages(conversation_id)
Get conversation messages
Wraps GET /api/v2/conversations/emails/{conversationId}/messages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get conversation messages
result = api_instance.get_conversations_email_messages(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**EmailMessageListing**](EmailMessageListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessage**](EmailMessage.html) get_conversations_email_messages_draft(conversation_id)
Get conversation draft reply
Wraps GET /api/v2/conversations/emails/{conversationId}/messages/draft
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get conversation draft reply
result = api_instance.get_conversations_email_messages_draft(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email_messages_draft: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**EmailMessage**](EmailMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_email_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/emails/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_email_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_email_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/emails/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_email_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_email_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailConversationEntityListing**](EmailConversationEntityListing.html) get_conversations_emails
Get active email conversations for the logged in user
Wraps GET /api/v2/conversations/emails
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active email conversations for the logged in user
result = api_instance.get_conversations_emails
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_emails: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**EmailConversationEntityListing**](EmailConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageConversation**](MessageConversation.html) get_conversations_message(conversation_id)
Get message conversation
Wraps GET /api/v2/conversations/messages/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
begin
#Get message conversation
result = api_instance.get_conversations_message(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_message: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
{: class="table table-striped"}
### Return type
[**MessageConversation**](MessageConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageMediaData**](MessageMediaData.html) get_conversations_message_communication_messages_media_media_id(conversation_id, communication_id, media_id)
Get media
Wraps GET /api/v2/conversations/messages/{conversationId}/communications/{communicationId}/messages/media/{mediaId}
Requires ANY permissions:
* conversation:message:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
communication_id = "communication_id_example" # String | communicationId
media_id = "media_id_example" # String | mediaId
begin
#Get media
result = api_instance.get_conversations_message_communication_messages_media_media_id(conversation_id, communication_id, media_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_message_communication_messages_media_media_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**communication_id** | **String**| communicationId | |
**media_id** | **String**| mediaId | |
{: class="table table-striped"}
### Return type
[**MessageMediaData**](MessageMediaData.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageData**](MessageData.html) get_conversations_message_message(conversation_id, message_id)
Get message
Wraps GET /api/v2/conversations/messages/{conversationId}/messages/{messageId}
Requires ANY permissions:
* conversation:message:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
message_id = "message_id_example" # String | messageId
begin
#Get message
result = api_instance.get_conversations_message_message(conversation_id, message_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_message_message: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**message_id** | **String**| messageId | |
{: class="table table-striped"}
### Return type
[**MessageData**](MessageData.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AssignedWrapupCode**](AssignedWrapupCode.html) get_conversations_message_participant_wrapup(conversation_id, participant_id, opts)
Get the wrap-up for this conversation participant.
Wraps GET /api/v2/conversations/messages/{conversationId}/participants/{participantId}/wrapup
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
provisional: false # BOOLEAN | Indicates if the wrap-up code is provisional.
}
begin
#Get the wrap-up for this conversation participant.
result = api_instance.get_conversations_message_participant_wrapup(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_message_participant_wrapup: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**provisional** | **BOOLEAN**| Indicates if the wrap-up code is provisional. | [optional] [default to false] |
{: class="table table-striped"}
### Return type
[**AssignedWrapupCode**](AssignedWrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Array<WrapupCode>**](WrapupCode.html) get_conversations_message_participant_wrapupcodes(conversation_id, participant_id)
Get list of wrapup codes for this conversation participant
Wraps GET /api/v2/conversations/messages/{conversationId}/participants/{participantId}/wrapupcodes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Get list of wrapup codes for this conversation participant
result = api_instance.get_conversations_message_participant_wrapupcodes(conversation_id, participant_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_message_participant_wrapupcodes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
[**Array<WrapupCode>**](WrapupCode.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageConversationEntityListing**](MessageConversationEntityListing.html) get_conversations_messages
Get active message conversations for the logged in user
Wraps GET /api/v2/conversations/messages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
begin
#Get active message conversations for the logged in user
result = api_instance.get_conversations_messages
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messages: #{e}"
end
```
### Parameters
This endpoint does not need any parameter.
{: class="table table-striped"}
### Return type
[**MessageConversationEntityListing**](MessageConversationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessagingIntegrationEntityListing**](MessagingIntegrationEntityListing.html) get_conversations_messaging_integrations(opts)
Get a list of Integrations
Wraps GET /api/v2/conversations/messaging/integrations
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of Integrations
result = api_instance.get_conversations_messaging_integrations(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**MessagingIntegrationEntityListing**](MessagingIntegrationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**FacebookIntegrationEntityListing**](FacebookIntegrationEntityListing.html) get_conversations_messaging_integrations_facebook(opts)
Get a list of Facebook Integrations
Wraps GET /api/v2/conversations/messaging/integrations/facebook
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of Facebook Integrations
result = api_instance.get_conversations_messaging_integrations_facebook(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_facebook: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**FacebookIntegrationEntityListing**](FacebookIntegrationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**FacebookIntegration**](FacebookIntegration.html) get_conversations_messaging_integrations_facebook_integration_id(integration_id)
Get a Facebook messaging integration
Wraps GET /api/v2/conversations/messaging/integrations/facebook/{integrationId}
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Get a Facebook messaging integration
result = api_instance.get_conversations_messaging_integrations_facebook_integration_id(integration_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_facebook_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
[**FacebookIntegration**](FacebookIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**LineIntegrationEntityListing**](LineIntegrationEntityListing.html) get_conversations_messaging_integrations_line(opts)
Get a list of LINE messenger Integrations
Wraps GET /api/v2/conversations/messaging/integrations/line
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of LINE messenger Integrations
result = api_instance.get_conversations_messaging_integrations_line(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_line: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**LineIntegrationEntityListing**](LineIntegrationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**LineIntegration**](LineIntegration.html) get_conversations_messaging_integrations_line_integration_id(integration_id)
Get a LINE messenger integration
Wraps GET /api/v2/conversations/messaging/integrations/line/{integrationId}
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Get a LINE messenger integration
result = api_instance.get_conversations_messaging_integrations_line_integration_id(integration_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_line_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
[**LineIntegration**](LineIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**TwitterIntegrationEntityListing**](TwitterIntegrationEntityListing.html) get_conversations_messaging_integrations_twitter(opts)
Get a list of Twitter Integrations
Wraps GET /api/v2/conversations/messaging/integrations/twitter
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of Twitter Integrations
result = api_instance.get_conversations_messaging_integrations_twitter(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_twitter: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**TwitterIntegrationEntityListing**](TwitterIntegrationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**TwitterIntegration**](TwitterIntegration.html) get_conversations_messaging_integrations_twitter_integration_id(integration_id)
Get a Twitter messaging integration
Wraps GET /api/v2/conversations/messaging/integrations/twitter/{integrationId}
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Get a Twitter messaging integration
result = api_instance.get_conversations_messaging_integrations_twitter_integration_id(integration_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_twitter_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
[**TwitterIntegration**](TwitterIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WhatsAppIntegrationEntityListing**](WhatsAppIntegrationEntityListing.html) get_conversations_messaging_integrations_whatsapp(opts)
Get a list of WhatsApp Integrations
Wraps GET /api/v2/conversations/messaging/integrations/whatsapp
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of WhatsApp Integrations
result = api_instance.get_conversations_messaging_integrations_whatsapp(opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_whatsapp: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**WhatsAppIntegrationEntityListing**](WhatsAppIntegrationEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WhatsAppIntegration**](WhatsAppIntegration.html) get_conversations_messaging_integrations_whatsapp_integration_id(integration_id)
Get a WhatsApp messaging integration
Wraps GET /api/v2/conversations/messaging/integrations/whatsapp/{integrationId}
Requires ANY permissions:
* messaging:integration:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
begin
#Get a WhatsApp messaging integration
result = api_instance.get_conversations_messaging_integrations_whatsapp_integration_id(integration_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_integrations_whatsapp_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
{: class="table table-striped"}
### Return type
[**WhatsAppIntegration**](WhatsAppIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessagingStickerEntityListing**](MessagingStickerEntityListing.html) get_conversations_messaging_sticker(messenger_type, opts)
Get a list of Messaging Stickers
Wraps GET /api/v2/conversations/messaging/stickers/{messengerType}
Requires ANY permissions:
* conversation:message:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
messenger_type = "messenger_type_example" # String | Messenger Type
opts = {
page_size: 25, # Integer | Page size
page_number: 1 # Integer | Page number
}
begin
#Get a list of Messaging Stickers
result = api_instance.get_conversations_messaging_sticker(messenger_type, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->get_conversations_messaging_sticker: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**messenger_type** | **String**| Messenger Type | |
**page_size** | **Integer**| Page size | [optional] [default to 25] |
**page_number** | **Integer**| Page number | [optional] [default to 1] |
{: class="table table-striped"}
### Return type
[**MessagingStickerEntityListing**](MessagingStickerEntityListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversation_participant(conversation_id, participant_id, body)
Update a participant.
Update conversation participant.
Wraps PATCH /api/v2/conversations/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Update request
begin
#Update a participant.
api_instance.patch_conversation_participant(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversation_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Update request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversation_participant_attributes(conversation_id, participant_id, body)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
body = PureCloud::ParticipantAttributes.new # ParticipantAttributes | Participant attributes
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversation_participant_attributes(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversation_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| Participant attributes | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_call(conversation_id, body)
Update a conversation by setting it's recording state, merging in other conversations to create a conference, or disconnecting all of the participants
Wraps PATCH /api/v2/conversations/calls/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by setting it's recording state, merging in other conversations to create a conference, or disconnecting all of the participants
result = api_instance.patch_conversations_call(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_call: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_call_participant(conversation_id, participant_id, body)
Update conversation participant
Wraps PATCH /api/v2/conversations/calls/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant request
begin
#Update conversation participant
api_instance.patch_conversations_call_participant(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_call_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_call_participant_attributes(conversation_id, participant_id, body)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/calls/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ParticipantAttributes.new # ParticipantAttributes | Participant attributes
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_call_participant_attributes(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_call_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| Participant attributes | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_call_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/calls/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_call_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_call_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ConsultTransferResponse**](ConsultTransferResponse.html) patch_conversations_call_participant_consult(conversation_id, participant_id, body)
Change who can speak
Wraps PATCH /api/v2/conversations/calls/{conversationId}/participants/{participantId}/consult
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ConsultTransferUpdate.new # ConsultTransferUpdate | new speak to
begin
#Change who can speak
result = api_instance.patch_conversations_call_participant_consult(conversation_id, participant_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_call_participant_consult: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ConsultTransferUpdate**](ConsultTransferUpdate.html)| new speak to | |
{: class="table table-striped"}
### Return type
[**ConsultTransferResponse**](ConsultTransferResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_callback(conversation_id, body)
Update a conversation by disconnecting all of the participants
Wraps PATCH /api/v2/conversations/callbacks/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by disconnecting all of the participants
result = api_instance.patch_conversations_callback(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_callback: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_callback_participant(conversation_id, participant_id, body)
Update conversation participant
Wraps PATCH /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant
api_instance.patch_conversations_callback_participant(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_callback_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_callback_participant_attributes(conversation_id, participant_id, body)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ParticipantAttributes.new # ParticipantAttributes | Attributes
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_callback_participant_attributes(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_callback_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| Attributes | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_callback_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_callback_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_callback_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_chat(conversation_id, body)
Update a conversation by disconnecting all of the participants
Wraps PATCH /api/v2/conversations/chats/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by disconnecting all of the participants
result = api_instance.patch_conversations_chat(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_chat: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_chat_participant(conversation_id, participant_id, body)
Update conversation participant
Wraps PATCH /api/v2/conversations/chats/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Update request
begin
#Update conversation participant
api_instance.patch_conversations_chat_participant(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_chat_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Update request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_chat_participant_attributes(conversation_id, participant_id, body)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/chats/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ParticipantAttributes.new # ParticipantAttributes | Participant attributes
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_chat_participant_attributes(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_chat_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| Participant attributes | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_chat_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/chats/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_chat_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_chat_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_cobrowsesession(conversation_id, body)
Update a conversation by disconnecting all of the participants
Wraps PATCH /api/v2/conversations/cobrowsesessions/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by disconnecting all of the participants
result = api_instance.patch_conversations_cobrowsesession(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_cobrowsesession: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_cobrowsesession_participant(conversation_id, participant_id, opts)
Update conversation participant
Wraps PATCH /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
body: PureCloud::MediaParticipantRequest.new # MediaParticipantRequest |
}
begin
#Update conversation participant
api_instance.patch_conversations_cobrowsesession_participant(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_cobrowsesession_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_cobrowsesession_participant_attributes(conversation_id, participant_id, opts)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
body: PureCloud::ParticipantAttributes.new # ParticipantAttributes |
}
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_cobrowsesession_participant_attributes(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_cobrowsesession_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_cobrowsesession_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_cobrowsesession_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_cobrowsesession_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_email(conversation_id, body)
Update a conversation by disconnecting all of the participants
Wraps PATCH /api/v2/conversations/emails/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by disconnecting all of the participants
result = api_instance.patch_conversations_email(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_email: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_email_participant(conversation_id, participant_id, body)
Update conversation participant
Wraps PATCH /api/v2/conversations/emails/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Update request
begin
#Update conversation participant
api_instance.patch_conversations_email_participant(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_email_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Update request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_email_participant_attributes(conversation_id, participant_id, body)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/emails/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ParticipantAttributes.new # ParticipantAttributes | Participant attributes
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_email_participant_attributes(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_email_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| Participant attributes | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_email_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/emails/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_email_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_email_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) patch_conversations_message(conversation_id, body)
Update a conversation by disconnecting all of the participants
Wraps PATCH /api/v2/conversations/messages/{conversationId}
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Update a conversation by disconnecting all of the participants
result = api_instance.patch_conversations_message(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_message: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_message_participant(conversation_id, participant_id, opts)
Update conversation participant
Wraps PATCH /api/v2/conversations/messages/{conversationId}/participants/{participantId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
body: PureCloud::MediaParticipantRequest.new # MediaParticipantRequest |
}
begin
#Update conversation participant
api_instance.patch_conversations_message_participant(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_message_participant: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## patch_conversations_message_participant_attributes(conversation_id, participant_id, opts)
Update the attributes on a conversation participant.
Wraps PATCH /api/v2/conversations/messages/{conversationId}/participants/{participantId}/attributes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
body: PureCloud::ParticipantAttributes.new # ParticipantAttributes |
}
begin
#Update the attributes on a conversation participant.
api_instance.patch_conversations_message_participant_attributes(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_message_participant_attributes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ParticipantAttributes**](ParticipantAttributes.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) patch_conversations_message_participant_communication(conversation_id, participant_id, communication_id, body)
Update conversation participant's communication by disconnecting it.
Wraps PATCH /api/v2/conversations/messages/{conversationId}/participants/{participantId}/communications/{communicationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::MediaParticipantRequest.new # MediaParticipantRequest | Participant
begin
#Update conversation participant's communication by disconnecting it.
result = api_instance.patch_conversations_message_participant_communication(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_message_participant_communication: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**MediaParticipantRequest**](MediaParticipantRequest.html)| Participant | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WhatsAppIntegration**](WhatsAppIntegration.html) patch_conversations_messaging_integrations_whatsapp_integration_id(integration_id, body)
Activate a WhatsApp messaging integration.
The following steps are required in order to fully activate a Whatsapp Integration: Initially, you will need to get an activation code by sending: an action set to Activate, and an authenticationMethod choosing from Sms or Voice. Finally, once you have been informed of an activation code on selected authenticationMethod, you will need to confirm the code by sending: an action set to Confirm, and the confirmationCode you have received from Whatsapp.
Wraps PATCH /api/v2/conversations/messaging/integrations/whatsapp/{integrationId}
Requires ANY permissions:
* messaging:integration:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
body = PureCloud::WhatsAppIntegrationUpdateRequest.new # WhatsAppIntegrationUpdateRequest | WhatsAppIntegrationUpdateRequest
begin
#Activate a WhatsApp messaging integration.
result = api_instance.patch_conversations_messaging_integrations_whatsapp_integration_id(integration_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->patch_conversations_messaging_integrations_whatsapp_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
**body** | [**WhatsAppIntegrationUpdateRequest**](WhatsAppIntegrationUpdateRequest.html)| WhatsAppIntegrationUpdateRequest | |
{: class="table table-striped"}
### Return type
[**WhatsAppIntegration**](WhatsAppIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**PropertyIndexRequest**](PropertyIndexRequest.html) post_analytics_conversation_details_properties(conversation_id, body)
Index conversation properties
Wraps POST /api/v2/analytics/conversations/{conversationId}/details/properties
Requires ANY permissions:
* analytics:conversationProperties:index
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::PropertyIndexRequest.new # PropertyIndexRequest | request
begin
#Index conversation properties
result = api_instance.post_analytics_conversation_details_properties(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_analytics_conversation_details_properties: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**PropertyIndexRequest**](PropertyIndexRequest.html)| request | |
{: class="table table-striped"}
### Return type
[**PropertyIndexRequest**](PropertyIndexRequest.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ConversationAggregateQueryResponse**](ConversationAggregateQueryResponse.html) post_analytics_conversations_aggregates_query(body)
Query for conversation aggregates
Wraps POST /api/v2/analytics/conversations/aggregates/query
Requires ANY permissions:
* analytics:conversationAggregate:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::ConversationAggregationQuery.new # ConversationAggregationQuery | query
begin
#Query for conversation aggregates
result = api_instance.post_analytics_conversations_aggregates_query(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_analytics_conversations_aggregates_query: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**ConversationAggregationQuery**](ConversationAggregationQuery.html)| query | |
{: class="table table-striped"}
### Return type
[**ConversationAggregateQueryResponse**](ConversationAggregateQueryResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AsyncQueryResponse**](AsyncQueryResponse.html) post_analytics_conversations_details_jobs(body)
Query for conversation details asynchronously
Wraps POST /api/v2/analytics/conversations/details/jobs
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::AsyncConversationQuery.new # AsyncConversationQuery | query
begin
#Query for conversation details asynchronously
result = api_instance.post_analytics_conversations_details_jobs(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_analytics_conversations_details_jobs: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**AsyncConversationQuery**](AsyncConversationQuery.html)| query | |
{: class="table table-striped"}
### Return type
[**AsyncQueryResponse**](AsyncQueryResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**AnalyticsConversationQueryResponse**](AnalyticsConversationQueryResponse.html) post_analytics_conversations_details_query(body)
Query for conversation details
Wraps POST /api/v2/analytics/conversations/details/query
Requires ANY permissions:
* analytics:conversationDetail:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::ConversationQuery.new # ConversationQuery | query
begin
#Query for conversation details
result = api_instance.post_analytics_conversations_details_query(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_analytics_conversations_details_query: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**ConversationQuery**](ConversationQuery.html)| query | |
{: class="table table-striped"}
### Return type
[**AnalyticsConversationQueryResponse**](AnalyticsConversationQueryResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## String** post_conversation_disconnect(conversation_id)
Performs a full conversation teardown. Issues disconnect requests for any connected media. Applies a system wrap-up code to any participants that are pending wrap-up. This is not intended to be the normal way of ending interactions but is available in the event of problems with the application to allow a resyncronization of state across all components. It is recommended that users submit a support case if they are relying on this endpoint systematically as there is likely something that needs investigation.
Wraps POST /api/v2/conversations/{conversationId}/disconnect
Requires ANY permissions:
* conversation:communication:disconnect
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
begin
#Performs a full conversation teardown. Issues disconnect requests for any connected media. Applies a system wrap-up code to any participants that are pending wrap-up. This is not intended to be the normal way of ending interactions but is available in the event of problems with the application to allow a resyncronization of state across all components. It is recommended that users submit a support case if they are relying on this endpoint systematically as there is likely something that needs investigation.
result = api_instance.post_conversation_disconnect(conversation_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversation_disconnect: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
{: class="table table-striped"}
### Return type
**String**
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversation_participant_callbacks(conversation_id, participant_id, opts)
Create a new callback for the specified participant on the conversation.
Wraps POST /api/v2/conversations/{conversationId}/participants/{participantId}/callbacks
Requires ANY permissions:
* conversation:callback:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
opts = {
body: PureCloud::CreateCallbackOnConversationCommand.new # CreateCallbackOnConversationCommand |
}
begin
#Create a new callback for the specified participant on the conversation.
api_instance.post_conversation_participant_callbacks(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversation_participant_callbacks: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**CreateCallbackOnConversationCommand**](CreateCallbackOnConversationCommand.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversation_participant_digits(conversation_id, participant_id, opts)
Sends DTMF to the participant
Wraps POST /api/v2/conversations/{conversationId}/participants/{participantId}/digits
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
opts = {
body: PureCloud::Digits.new # Digits | Digits
}
begin
#Sends DTMF to the participant
api_instance.post_conversation_participant_digits(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversation_participant_digits: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**Digits**](Digits.html)| Digits | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversation_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversation_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversation_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**SecureSession**](SecureSession.html) post_conversation_participant_secureivrsessions(conversation_id, participant_id, opts)
Create secure IVR session. Only a participant in the conversation can invoke a secure IVR.
Wraps POST /api/v2/conversations/{conversationId}/participants/{participantId}/secureivrsessions
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
opts = {
body: PureCloud::CreateSecureSession.new # CreateSecureSession |
}
begin
#Create secure IVR session. Only a participant in the conversation can invoke a secure IVR.
result = api_instance.post_conversation_participant_secureivrsessions(conversation_id, participant_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversation_participant_secureivrsessions: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
**body** | [**CreateSecureSession**](CreateSecureSession.html)| | [optional] |
{: class="table table-striped"}
### Return type
[**SecureSession**](SecureSession.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) post_conversations_call(conversation_id, body)
Place a new call as part of a callback conversation.
Wraps POST /api/v2/conversations/calls/{conversationId}
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::CallCommand.new # CallCommand | Conversation
begin
#Place a new call as part of a callback conversation.
result = api_instance.post_conversations_call(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_call: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**CallCommand**](CallCommand.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ConsultTransferResponse**](ConsultTransferResponse.html) post_conversations_call_participant_consult(conversation_id, participant_id, body)
Initiate and update consult transfer
Wraps POST /api/v2/conversations/calls/{conversationId}/participants/{participantId}/consult
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::ConsultTransfer.new # ConsultTransfer | Destination address & initial speak to
begin
#Initiate and update consult transfer
result = api_instance.post_conversations_call_participant_consult(conversation_id, participant_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_call_participant_consult: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**ConsultTransfer**](ConsultTransfer.html)| Destination address & initial speak to | |
{: class="table table-striped"}
### Return type
[**ConsultTransferResponse**](ConsultTransferResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_call_participant_monitor(conversation_id, participant_id)
Listen in on the conversation from the point of view of a given participant.
Wraps POST /api/v2/conversations/calls/{conversationId}/participants/{participantId}/monitor
Requires ANY permissions:
* conversation:call:monitor
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
begin
#Listen in on the conversation from the point of view of a given participant.
api_instance.post_conversations_call_participant_monitor(conversation_id, participant_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_call_participant_monitor: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_call_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/calls/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_call_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_call_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Conversation**](Conversation.html) post_conversations_call_participants(conversation_id, body)
Add participants to a conversation
Wraps POST /api/v2/conversations/calls/{conversationId}/participants
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::Conversation.new # Conversation | Conversation
begin
#Add participants to a conversation
result = api_instance.post_conversations_call_participants(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_call_participants: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**Conversation**](Conversation.html)| Conversation | |
{: class="table table-striped"}
### Return type
[**Conversation**](Conversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_callback_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/callbacks/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_callback_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_callback_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CreateCallbackResponse**](CreateCallbackResponse.html) post_conversations_callbacks(body)
Create a Callback
Wraps POST /api/v2/conversations/callbacks
Requires ANY permissions:
* conversation:callback:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::CreateCallbackCommand.new # CreateCallbackCommand | Callback
begin
#Create a Callback
result = api_instance.post_conversations_callbacks(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_callbacks: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**CreateCallbackCommand**](CreateCallbackCommand.html)| Callback | |
{: class="table table-striped"}
### Return type
[**CreateCallbackResponse**](CreateCallbackResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**CreateCallResponse**](CreateCallResponse.html) post_conversations_calls(body)
Create a call conversation
Wraps POST /api/v2/conversations/calls
Requires ANY permissions:
* conversation:conference:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::CreateCallRequest.new # CreateCallRequest | Call request
begin
#Create a call conversation
result = api_instance.post_conversations_calls(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_calls: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**CreateCallRequest**](CreateCallRequest.html)| Call request | |
{: class="table table-striped"}
### Return type
[**CreateCallResponse**](CreateCallResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WebChatMessage**](WebChatMessage.html) post_conversations_chat_communication_messages(conversation_id, communication_id, body)
Send a message on behalf of a communication in a chat conversation.
Wraps POST /api/v2/conversations/chats/{conversationId}/communications/{communicationId}/messages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::CreateWebChatMessageRequest.new # CreateWebChatMessageRequest | Message
begin
#Send a message on behalf of a communication in a chat conversation.
result = api_instance.post_conversations_chat_communication_messages(conversation_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_chat_communication_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**communication_id** | **String**| communicationId | |
**body** | [**CreateWebChatMessageRequest**](CreateWebChatMessageRequest.html)| Message | |
{: class="table table-striped"}
### Return type
[**WebChatMessage**](WebChatMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WebChatTyping**](WebChatTyping.html) post_conversations_chat_communication_typing(conversation_id, communication_id)
Send a typing-indicator on behalf of a communication in a chat conversation.
Wraps POST /api/v2/conversations/chats/{conversationId}/communications/{communicationId}/typing
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
communication_id = "communication_id_example" # String | communicationId
begin
#Send a typing-indicator on behalf of a communication in a chat conversation.
result = api_instance.post_conversations_chat_communication_typing(conversation_id, communication_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_chat_communication_typing: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**communication_id** | **String**| communicationId | |
{: class="table table-striped"}
### Return type
[**WebChatTyping**](WebChatTyping.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_chat_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/chats/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_chat_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_chat_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**ChatConversation**](ChatConversation.html) post_conversations_chats(body)
Create a web chat conversation
Wraps POST /api/v2/conversations/chats
Requires ANY permissions:
* conversation:webchat:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::CreateWebChatRequest.new # CreateWebChatRequest | Create web chat request
begin
#Create a web chat conversation
result = api_instance.post_conversations_chats(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_chats: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**CreateWebChatRequest**](CreateWebChatRequest.html)| Create web chat request | |
{: class="table table-striped"}
### Return type
[**ChatConversation**](ChatConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_cobrowsesession_participant_replace(conversation_id, participant_id, opts)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/cobrowsesessions/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
opts = {
body: PureCloud::TransferRequest.new # TransferRequest |
}
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_cobrowsesession_participant_replace(conversation_id, participant_id, opts)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_cobrowsesession_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| | [optional] |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailConversation**](EmailConversation.html) post_conversations_email_inboundmessages(conversation_id, body)
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.
Wraps POST /api/v2/conversations/emails/{conversationId}/inboundmessages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::InboundMessageRequest.new # InboundMessageRequest | Send external email reply
begin
#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.
result = api_instance.post_conversations_email_inboundmessages(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_email_inboundmessages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**InboundMessageRequest**](InboundMessageRequest.html)| Send external email reply | |
{: class="table table-striped"}
### Return type
[**EmailConversation**](EmailConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessage**](EmailMessage.html) post_conversations_email_messages(conversation_id, body)
Send an email reply
Wraps POST /api/v2/conversations/emails/{conversationId}/messages
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::EmailMessage.new # EmailMessage | Reply
begin
#Send an email reply
result = api_instance.post_conversations_email_messages(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_email_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**EmailMessage**](EmailMessage.html)| Reply | |
{: class="table table-striped"}
### Return type
[**EmailMessage**](EmailMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessage**](EmailMessage.html) post_conversations_email_messages_draft_attachments_copy(conversation_id, body)
Copy attachments from an email message to the current draft.
Wraps POST /api/v2/conversations/emails/{conversationId}/messages/draft/attachments/copy
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::CopyAttachmentsRequest.new # CopyAttachmentsRequest | Copy Attachment Request
begin
#Copy attachments from an email message to the current draft.
result = api_instance.post_conversations_email_messages_draft_attachments_copy(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_email_messages_draft_attachments_copy: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**CopyAttachmentsRequest**](CopyAttachmentsRequest.html)| Copy Attachment Request | |
{: class="table table-striped"}
### Return type
[**EmailMessage**](EmailMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_email_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/emails/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_email_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_email_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailConversation**](EmailConversation.html) post_conversations_emails(body)
Create an email conversation
If the direction of the request is INBOUND, this will create an external conversation with a third party provider. If the direction of the the request is OUTBOUND, this will create a conversation to send outbound emails on behalf of a queue.
Wraps POST /api/v2/conversations/emails
Requires ANY permissions:
* conversation:email:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::CreateEmailRequest.new # CreateEmailRequest | Create email request
begin
#Create an email conversation
result = api_instance.post_conversations_emails(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_emails: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**CreateEmailRequest**](CreateEmailRequest.html)| Create email request | |
{: class="table table-striped"}
### Return type
[**EmailConversation**](EmailConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**FaxSendResponse**](FaxSendResponse.html) post_conversations_faxes(body)
Create Fax Conversation
Wraps POST /api/v2/conversations/faxes
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::FaxSendRequest.new # FaxSendRequest | Fax
begin
#Create Fax Conversation
result = api_instance.post_conversations_faxes(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_faxes: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**FaxSendRequest**](FaxSendRequest.html)| Fax | |
{: class="table table-striped"}
### Return type
[**FaxSendResponse**](FaxSendResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageData**](MessageData.html) post_conversations_message_communication_messages(conversation_id, communication_id, body)
Send message
Wraps POST /api/v2/conversations/messages/{conversationId}/communications/{communicationId}/messages
Requires ANY permissions:
* conversation:message:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::AdditionalMessage.new # AdditionalMessage | Message
begin
#Send message
result = api_instance.post_conversations_message_communication_messages(conversation_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_message_communication_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**communication_id** | **String**| communicationId | |
**body** | [**AdditionalMessage**](AdditionalMessage.html)| Message | |
{: class="table table-striped"}
### Return type
[**MessageData**](MessageData.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageMediaData**](MessageMediaData.html) post_conversations_message_communication_messages_media(conversation_id, communication_id)
Create media
Wraps POST /api/v2/conversations/messages/{conversationId}/communications/{communicationId}/messages/media
Requires ANY permissions:
* conversation:message:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
communication_id = "communication_id_example" # String | communicationId
begin
#Create media
result = api_instance.post_conversations_message_communication_messages_media(conversation_id, communication_id)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_message_communication_messages_media: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**communication_id** | **String**| communicationId | |
{: class="table table-striped"}
### Return type
[**MessageMediaData**](MessageMediaData.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**TextMessageListing**](TextMessageListing.html) post_conversations_message_messages_bulk(conversation_id, opts)
Get messages in batch
The path parameter [conversationId] should contain the conversationId of the conversation being filtered. The body should contain the messageId(s) of messages being requested. For example: [\"a3069a33b-bbb1-4703-9d68-061d9e9db96e\", \"55bc6be3-078c-4a49-a4e6-1e05776ed7e8\"]
Wraps POST /api/v2/conversations/messages/{conversationId}/messages/bulk
Requires ANY permissions:
* conversation:message:view
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String |
opts = {
body: [PureCloud::Array.new] # Array | messageIds
}
begin
#Get messages in batch
result = api_instance.post_conversations_message_messages_bulk(conversation_id, opts)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_message_messages_bulk: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| | |
**body** | **Array<String>**| messageIds | [optional] |
{: class="table table-striped"}
### Return type
[**TextMessageListing**](TextMessageListing.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## post_conversations_message_participant_replace(conversation_id, participant_id, body)
Replace this participant with the specified user and/or address
Wraps POST /api/v2/conversations/messages/{conversationId}/participants/{participantId}/replace
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
body = PureCloud::TransferRequest.new # TransferRequest | Transfer request
begin
#Replace this participant with the specified user and/or address
api_instance.post_conversations_message_participant_replace(conversation_id, participant_id, body)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_message_participant_replace: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**body** | [**TransferRequest**](TransferRequest.html)| Transfer request | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**MessageConversation**](MessageConversation.html) post_conversations_messages(body)
Create an outbound messaging conversation.
If there is an existing conversation between the remote address and the address associated with the queue specified in createOutboundRequest then the result of this request depends on the state of that conversation and the useExistingConversation field of createOutboundRequest. If the existing conversation is in alerting or connected state, then the request will fail. If the existing conversation is disconnected but still within the conversation window then the request will fail unless useExistingConversation is set to true.
Wraps POST /api/v2/conversations/messages
Requires ANY permissions:
* conversation:message:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::CreateOutboundMessagingConversationRequest.new # CreateOutboundMessagingConversationRequest | Create outbound messaging conversation
begin
#Create an outbound messaging conversation.
result = api_instance.post_conversations_messages(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messages: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**CreateOutboundMessagingConversationRequest**](CreateOutboundMessagingConversationRequest.html)| Create outbound messaging conversation | |
{: class="table table-striped"}
### Return type
[**MessageConversation**](MessageConversation.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**SendAgentlessOutboundMessageResponse**](SendAgentlessOutboundMessageResponse.html) post_conversations_messages_agentless(body)
Send an agentless outbound message
Send an agentlesss (api participant) outbound message using a client credential grant. In order to call this endpoint you will need OAuth token generated using OAuth client credentials authorized with at least messaging scope. This will generate a new Conversation, if there is an existing active Conversation between the fromAddress and toAddress already, then this POST will fail.
Wraps POST /api/v2/conversations/messages/agentless
Requires ANY permissions:
* conversation:message:create
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::SendAgentlessOutboundMessageRequest.new # SendAgentlessOutboundMessageRequest | Create agentless outbound messaging request
begin
#Send an agentless outbound message
result = api_instance.post_conversations_messages_agentless(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messages_agentless: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**SendAgentlessOutboundMessageRequest**](SendAgentlessOutboundMessageRequest.html)| Create agentless outbound messaging request | |
{: class="table table-striped"}
### Return type
[**SendAgentlessOutboundMessageResponse**](SendAgentlessOutboundMessageResponse.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**FacebookIntegration**](FacebookIntegration.html) post_conversations_messaging_integrations_facebook(body)
Create a Facebook Integration
Wraps POST /api/v2/conversations/messaging/integrations/facebook
Requires ANY permissions:
* messaging:integration:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::FacebookIntegrationRequest.new # FacebookIntegrationRequest | FacebookIntegrationRequest
begin
#Create a Facebook Integration
result = api_instance.post_conversations_messaging_integrations_facebook(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messaging_integrations_facebook: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**FacebookIntegrationRequest**](FacebookIntegrationRequest.html)| FacebookIntegrationRequest | |
{: class="table table-striped"}
### Return type
[**FacebookIntegration**](FacebookIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**LineIntegration**](LineIntegration.html) post_conversations_messaging_integrations_line(body)
Create a LINE messenger Integration
Wraps POST /api/v2/conversations/messaging/integrations/line
Requires ANY permissions:
* messaging:integration:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::LineIntegrationRequest.new # LineIntegrationRequest | LineIntegrationRequest
begin
#Create a LINE messenger Integration
result = api_instance.post_conversations_messaging_integrations_line(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messaging_integrations_line: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**LineIntegrationRequest**](LineIntegrationRequest.html)| LineIntegrationRequest | |
{: class="table table-striped"}
### Return type
[**LineIntegration**](LineIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**TwitterIntegration**](TwitterIntegration.html) post_conversations_messaging_integrations_twitter(body)
Create a Twitter Integration
Wraps POST /api/v2/conversations/messaging/integrations/twitter
Requires ANY permissions:
* messaging:integration:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::TwitterIntegrationRequest.new # TwitterIntegrationRequest | TwitterIntegrationRequest
begin
#Create a Twitter Integration
result = api_instance.post_conversations_messaging_integrations_twitter(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messaging_integrations_twitter: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**TwitterIntegrationRequest**](TwitterIntegrationRequest.html)| TwitterIntegrationRequest | |
{: class="table table-striped"}
### Return type
[**TwitterIntegration**](TwitterIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**WhatsAppIntegration**](WhatsAppIntegration.html) post_conversations_messaging_integrations_whatsapp(body)
Create a WhatsApp Integration
Wraps POST /api/v2/conversations/messaging/integrations/whatsapp
Requires ANY permissions:
* messaging:whatsappIntegration:add
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
body = PureCloud::WhatsAppIntegrationRequest.new # WhatsAppIntegrationRequest | WhatsAppIntegrationRequest
begin
#Create a WhatsApp Integration
result = api_instance.post_conversations_messaging_integrations_whatsapp(body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->post_conversations_messaging_integrations_whatsapp: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | [**WhatsAppIntegrationRequest**](WhatsAppIntegrationRequest.html)| WhatsAppIntegrationRequest | |
{: class="table table-striped"}
### Return type
[**WhatsAppIntegration**](WhatsAppIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## put_conversation_participant_flaggedreason(conversation_id, participant_id)
Set flagged reason on conversation participant to indicate bad conversation quality.
Wraps PUT /api/v2/conversations/{conversationId}/participants/{participantId}/flaggedreason
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversation ID
participant_id = "participant_id_example" # String | participant ID
begin
#Set flagged reason on conversation participant to indicate bad conversation quality.
api_instance.put_conversation_participant_flaggedreason(conversation_id, participant_id)
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->put_conversation_participant_flaggedreason: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversation ID | |
**participant_id** | **String**| participant ID | |
{: class="table table-striped"}
### Return type
nil (empty response body)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**Empty**](Empty.html) put_conversations_call_participant_communication_uuidata(conversation_id, participant_id, communication_id, body)
Set uuiData to be sent on future commands.
Wraps PUT /api/v2/conversations/calls/{conversationId}/participants/{participantId}/communications/{communicationId}/uuidata
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
participant_id = "participant_id_example" # String | participantId
communication_id = "communication_id_example" # String | communicationId
body = PureCloud::SetUuiDataRequest.new # SetUuiDataRequest | UUIData Request
begin
#Set uuiData to be sent on future commands.
result = api_instance.put_conversations_call_participant_communication_uuidata(conversation_id, participant_id, communication_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->put_conversations_call_participant_communication_uuidata: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**participant_id** | **String**| participantId | |
**communication_id** | **String**| communicationId | |
**body** | [**SetUuiDataRequest**](SetUuiDataRequest.html)| UUIData Request | |
{: class="table table-striped"}
### Return type
[**Empty**](Empty.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**EmailMessage**](EmailMessage.html) put_conversations_email_messages_draft(conversation_id, body)
Update conversation draft reply
Wraps PUT /api/v2/conversations/emails/{conversationId}/messages/draft
Requires NO permissions:
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
conversation_id = "conversation_id_example" # String | conversationId
body = PureCloud::EmailMessage.new # EmailMessage | Draft
begin
#Update conversation draft reply
result = api_instance.put_conversations_email_messages_draft(conversation_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->put_conversations_email_messages_draft: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**conversation_id** | **String**| conversationId | |
**body** | [**EmailMessage**](EmailMessage.html)| Draft | |
{: class="table table-striped"}
### Return type
[**EmailMessage**](EmailMessage.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
## [**LineIntegration**](LineIntegration.html) put_conversations_messaging_integrations_line_integration_id(integration_id, body)
Update a LINE messenger integration
Wraps PUT /api/v2/conversations/messaging/integrations/line/{integrationId}
Requires ANY permissions:
* messaging:integration:edit
### Example
```{"language":"ruby"}
# load the gem
require 'purecloudplatformclientv2'
# setup authorization
@secret = ENV['PURECLOUD_SECRET']
@id = ENV['PURECLOUD_CLIENT_ID']
environment = "mypurecloud.com"
@authToken = PureCloud.authenticate_with_client_credentials @id, @secret, environment
PureCloud.configure do |config|
config.access_token = @authToken
end
api_instance = PureCloud::ConversationsApi.new
integration_id = "integration_id_example" # String | Integration ID
body = PureCloud::LineIntegrationRequest.new # LineIntegrationRequest | LineIntegrationRequest
begin
#Update a LINE messenger integration
result = api_instance.put_conversations_messaging_integrations_line_integration_id(integration_id, body)
p result
rescue PureCloud::ApiError => e
puts "Exception when calling ConversationsApi->put_conversations_messaging_integrations_line_integration_id: #{e}"
end
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**integration_id** | **String**| Integration ID | |
**body** | [**LineIntegrationRequest**](LineIntegrationRequest.html)| LineIntegrationRequest | |
{: class="table table-striped"}
### Return type
[**LineIntegration**](LineIntegration.html)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json