---
title: ConversationsApi
---
## PureCloud::ConversationsApi
All URIs are relative to *https://api.mypurecloud.com*
Method | Description
------------- | ------------- | -------------
[**delete_conversation_participant_code**](ConversationsApi.html#delete_conversation_participant_code) | Delete a code used to add a communication to this 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
[**get_analytics_conversation_details**](ConversationsApi.html#get_analytics_conversation_details) | Get a conversation by id
[**get_conversation**](ConversationsApi.html#get_conversation) | Get conversation
[**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 conversations
[**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 callback conversations
[**get_conversations_calls**](ConversationsApi.html#get_conversations_calls) | Get recent conversations
[**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_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 recent chat conversations
[**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 recent cobrowse conversations
[**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 recent email conversations
[**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.
[**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_query**](ConversationsApi.html#post_analytics_conversations_details_query) | Query for conversation details
[**post_conversation_participant_callbacks**](ConversationsApi.html#post_conversation_participant_callbacks) | Create a new callback for the specified participant on the conversation.
[**post_conversation_participant_replace**](ConversationsApi.html#post_conversation_participant_replace) | Replace this participant with the specified user and/or address
[**post_conversations_call**](ConversationsApi.html#post_conversations_call) | Add a new call to a 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_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_messages**](ConversationsApi.html#post_conversations_email_messages) | Send an email reply
[**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
[**put_conversations_email_messages_draft**](ConversationsApi.html#put_conversations_email_messages_draft) | Update conversation draft reply
{: class="table table-striped"}
## - 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}
### Example
~~~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_conversations_call_participant_consult(conversation_id, participant_id)
Cancel the transfer
Wraps DELETE /api/v2/conversations/calls/{conversationId}/participants/{participantId}/consult
### Example
~~~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}
### Example
~~~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
## -[**AnalyticsConversation**](AnalyticsConversation.html) get_analytics_conversation_details(conversation_id)
Get a conversation by id
Wraps GET /api/v2/analytics/conversations/{conversationId}/details
### Example
~~~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
[**AnalyticsConversation**](AnalyticsConversation.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}
### Example
~~~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
## -[**WrapupCode**](WrapupCode.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
### Example
~~~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
[**WrapupCode**](WrapupCode.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
### Example
~~~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 conversations
Wraps GET /api/v2/conversations
### Example
~~~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 conversations
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}
### Example
~~~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
## -[**Wrapup**](Wrapup.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
### Example
~~~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
[**Wrapup**](Wrapup.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
### Example
~~~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}
### Example
~~~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
## -[**Wrapup**](Wrapup.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
### Example
~~~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
[**Wrapup**](Wrapup.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
### Example
~~~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 callback conversations
Wraps GET /api/v2/conversations/callbacks
### Example
~~~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 callback conversations
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 recent conversations
Wraps GET /api/v2/conversations/calls
### Example
~~~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 recent conversations
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
## -[**CallConversationEntityListing**](CallConversationEntityListing.html) get_conversations_calls_history(opts)
Get call history
Wraps GET /api/v2/conversations/calls/history
### Example
~~~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
interval: "interval_example" # String | Interval string; format is ISO-8601. Separate start and end times with forward slash '/'
}
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 | [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]
{: class="table table-striped"}
### Return type
[**CallConversationEntityListing**](CallConversationEntityListing.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
### Example
~~~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}
### Example
~~~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
## -[**Wrapup**](Wrapup.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
### Example
~~~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
[**Wrapup**](Wrapup.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
### Example
~~~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 recent chat conversations
Wraps GET /api/v2/conversations/chats
### Example
~~~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 recent chat conversations
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}
### Example
~~~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
## -[**Wrapup**](Wrapup.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
### Example
~~~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
[**Wrapup**](Wrapup.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
### Example
~~~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 recent cobrowse conversations
Wraps GET /api/v2/conversations/cobrowsesessions
### Example
~~~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 recent cobrowse conversations
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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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
### Example
~~~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
## -[**Wrapup**](Wrapup.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
### Example
~~~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
[**Wrapup**](Wrapup.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
### Example
~~~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 recent email conversations
Wraps GET /api/v2/conversations/emails
### Example
~~~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 recent email conversations
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
## - patch_conversation_participant(conversation_id, participant_id, body)
Update a participant.
Update conversation participant.
Wraps PATCH /api/v2/conversations/{conversationId}/participants/{participantId}
### Example
~~~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
### Example
~~~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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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}
### Example
~~~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}
### Example
~~~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
### Example
~~~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}
### Example
~~~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
## -[**PropertyIndexRequest**](PropertyIndexRequest.html) post_analytics_conversation_details_properties(conversation_id, body)
Index conversation properties
Wraps POST /api/v2/analytics/conversations/{conversationId}/details/properties
### Example
~~~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
## -[**AggregateQueryResponse**](AggregateQueryResponse.html) post_analytics_conversations_aggregates_query(body)
Query for conversation aggregates
Wraps POST /api/v2/analytics/conversations/aggregates/query
### Example
~~~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::AggregationQuery.new # AggregationQuery | 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** | [**AggregationQuery**](AggregationQuery.html)| query |
{: class="table table-striped"}
### Return type
[**AggregateQueryResponse**](AggregateQueryResponse.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
### Example
~~~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
## - 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
### Example
~~~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::CreateCallbackCommand.new # CreateCallbackCommand |
}
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** | [**CreateCallbackCommand**](CreateCallbackCommand.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_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
### Example
~~~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
## -[**Conversation**](Conversation.html) post_conversations_call(conversation_id, body)
Add a new call to a conversation
Wraps POST /api/v2/conversations/calls/{conversationId}
### Example
~~~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
#Add a new call to a 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
### Example
~~~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
### Example
~~~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
### Example
~~~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
### Example
~~~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
### Example
~~~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
### Example
~~~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
### Example
~~~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
## - 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
### Example
~~~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
### Example
~~~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
### Example
~~~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
## -[**EmailMessage**](EmailMessage.html) post_conversations_email_messages(conversation_id, body)
Send an email reply
Wraps POST /api/v2/conversations/emails/{conversationId}/messages
### Example
~~~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
## - 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
### Example
~~~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
Wraps POST /api/v2/conversations/emails
### Example
~~~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
### Example
~~~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
## -[**EmailMessage**](EmailMessage.html) put_conversations_email_messages_draft(conversation_id, body)
Update conversation draft reply
Wraps PUT /api/v2/conversations/emails/{conversationId}/messages/draft
### Example
~~~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