ultracart_api 4.0.33.rc → 4.0.36.rc
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +26 -4
- data/docs/Activity.md +4 -0
- data/docs/Conversation.md +26 -0
- data/docs/ConversationAgentAuthResponse.md +26 -0
- data/docs/ConversationApi.md +509 -0
- data/docs/ConversationMessage.md +26 -0
- data/docs/ConversationParticipant.md +30 -0
- data/docs/ConversationStartRequest.md +20 -0
- data/docs/ConversationStartResponse.md +20 -0
- data/docs/ConversationSummary.md +34 -0
- data/docs/ConversationsResponse.md +26 -0
- data/docs/CustomerActivity.md +9 -1
- data/docs/CustomerApi.md +77 -0
- data/docs/CustomerMergeRequest.md +20 -0
- data/lib/ultracart_api/api/conversation_api.rb +482 -0
- data/lib/ultracart_api/api/customer_api.rb +78 -0
- data/lib/ultracart_api/models/activity.rb +19 -1
- data/lib/ultracart_api/models/conversation.rb +259 -0
- data/lib/ultracart_api/models/conversation_agent_auth_response.rb +257 -0
- data/lib/ultracart_api/models/conversation_message.rb +258 -0
- data/lib/ultracart_api/models/conversation_participant.rb +276 -0
- data/lib/ultracart_api/models/conversation_start_request.rb +230 -0
- data/lib/ultracart_api/models/conversation_start_response.rb +228 -0
- data/lib/ultracart_api/models/conversation_summary.rb +292 -0
- data/lib/ultracart_api/models/conversations_response.rb +258 -0
- data/lib/ultracart_api/models/customer_activity.rb +40 -4
- data/lib/ultracart_api/models/customer_merge_request.rb +230 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +10 -0
- metadata +22 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 48a8d98870978d4d0dfcc2904b6c54831dca31a5073c3154542204bfaa991b1a
|
4
|
+
data.tar.gz: db252c18d5b411e4b58d79b7f601289f093a114666653e35e90621f85d768378
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 54ede9528dc838fba02b330d81ce3ed7a2cdcd2f7ad50ff88993086d938072a0106b447f79dd460510960cb174412072d27fff0fdca71376c1b4ff90d3472fdd
|
7
|
+
data.tar.gz: 45d7d2d3a29e74a0d214cba7eab1b8d4878c69c8325e9d825ec47c916776bb6ec1bdf9390760c28e7abe25e398371dd5df5da9caf61122cb086eaca4a0994db5
|
data/README.md
CHANGED
@@ -7,7 +7,7 @@ UltraCart REST API Version 2
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
8
8
|
|
9
9
|
- API version: 2.0.0
|
10
|
-
- Package version: 4.0.
|
10
|
+
- Package version: 4.0.36.rc
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
12
12
|
For more information, please visit [http://www.ultracart.com](http://www.ultracart.com)
|
13
13
|
|
@@ -24,16 +24,16 @@ gem build ultracart_api.gemspec
|
|
24
24
|
Then either install the gem locally:
|
25
25
|
|
26
26
|
```shell
|
27
|
-
gem install ./ultracart_api-4.0.
|
27
|
+
gem install ./ultracart_api-4.0.36.rc.gem
|
28
28
|
```
|
29
29
|
|
30
|
-
(for development, run `gem install --dev ./ultracart_api-4.0.
|
30
|
+
(for development, run `gem install --dev ./ultracart_api-4.0.36.rc.gem` to install the development dependencies)
|
31
31
|
|
32
32
|
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
33
33
|
|
34
34
|
Finally add this to the Gemfile:
|
35
35
|
|
36
|
-
gem 'ultracart_api', '~> 4.0.
|
36
|
+
gem 'ultracart_api', '~> 4.0.36.rc'
|
37
37
|
|
38
38
|
### Install from Git
|
39
39
|
|
@@ -131,6 +131,13 @@ Class | Method | HTTP request | Description
|
|
131
131
|
*UltracartClient::CheckoutApi* | [**setup_browser_key**](docs/CheckoutApi.md#setup_browser_key) | **PUT** /checkout/browser_key | Setup Browser Application
|
132
132
|
*UltracartClient::CheckoutApi* | [**update_cart**](docs/CheckoutApi.md#update_cart) | **PUT** /checkout/cart | Update cart
|
133
133
|
*UltracartClient::CheckoutApi* | [**validate_cart**](docs/CheckoutApi.md#validate_cart) | **POST** /checkout/cart/validate | Validate
|
134
|
+
*UltracartClient::ConversationApi* | [**get_agent_websocket_authorization**](docs/ConversationApi.md#get_agent_websocket_authorization) | **PUT** /conversation/agent/auth | Get agent websocket authorization
|
135
|
+
*UltracartClient::ConversationApi* | [**get_conversation**](docs/ConversationApi.md#get_conversation) | **GET** /conversation/conversations/{conversation_uuid} | Retrieve a conversation
|
136
|
+
*UltracartClient::ConversationApi* | [**get_conversation_multimedia_upload_url**](docs/ConversationApi.md#get_conversation_multimedia_upload_url) | **GET** /conversation/upload_url/{extension} | Get a presigned conersation multimedia upload URL
|
137
|
+
*UltracartClient::ConversationApi* | [**get_conversations**](docs/ConversationApi.md#get_conversations) | **GET** /conversation/conversations | Retrieve a list of conversation summaries newest to oldest
|
138
|
+
*UltracartClient::ConversationApi* | [**join_conversation**](docs/ConversationApi.md#join_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/join | Join a conversation
|
139
|
+
*UltracartClient::ConversationApi* | [**leave_conversation**](docs/ConversationApi.md#leave_conversation) | **DELETE** /conversation/conversations/{conversation_uuid}/leave | Leave a conversation
|
140
|
+
*UltracartClient::ConversationApi* | [**start_conversation**](docs/ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation
|
134
141
|
*UltracartClient::CouponApi* | [**delete_coupon**](docs/CouponApi.md#delete_coupon) | **DELETE** /coupon/coupons/{coupon_oid} | Delete a coupon
|
135
142
|
*UltracartClient::CouponApi* | [**delete_coupons_by_code**](docs/CouponApi.md#delete_coupons_by_code) | **DELETE** /coupon/coupons/by_code | Deletes multiple coupons
|
136
143
|
*UltracartClient::CouponApi* | [**delete_coupons_by_oid**](docs/CouponApi.md#delete_coupons_by_oid) | **DELETE** /coupon/coupons/by_oid | Deletes multiple coupons
|
@@ -163,6 +170,7 @@ Class | Method | HTTP request | Description
|
|
163
170
|
*UltracartClient::CustomerApi* | [**get_customers_for_data_tables**](docs/CustomerApi.md#get_customers_for_data_tables) | **POST** /customer/customers/dataTables | Retrieve customers for DataTables plugin
|
164
171
|
*UltracartClient::CustomerApi* | [**get_email_verification_token**](docs/CustomerApi.md#get_email_verification_token) | **POST** /customer/customers/email_verify/get_token | Create a token that can be used to verify a customer email address
|
165
172
|
*UltracartClient::CustomerApi* | [**insert_customer**](docs/CustomerApi.md#insert_customer) | **POST** /customer/customers | Insert a customer
|
173
|
+
*UltracartClient::CustomerApi* | [**merge_customer**](docs/CustomerApi.md#merge_customer) | **PUT** /customer/customers/{customer_profile_oid}/merge | Merge customer into this customer
|
166
174
|
*UltracartClient::CustomerApi* | [**search_customer_profile_values**](docs/CustomerApi.md#search_customer_profile_values) | **POST** /customer/search | Searches for all matching values (using POST)
|
167
175
|
*UltracartClient::CustomerApi* | [**update_customer**](docs/CustomerApi.md#update_customer) | **PUT** /customer/customers/{customer_profile_oid} | Update a customer
|
168
176
|
*UltracartClient::CustomerApi* | [**update_customer_email_lists**](docs/CustomerApi.md#update_customer_email_lists) | **POST** /customer/customers/{customer_profile_oid}/email_lists | Update email list subscriptions for a customer
|
@@ -553,6 +561,14 @@ Class | Method | HTTP request | Description
|
|
553
561
|
- [UltracartClient::CheckoutSetupBrowserKeyResponse](docs/CheckoutSetupBrowserKeyResponse.md)
|
554
562
|
- [UltracartClient::CheckoutStateProvinceResponse](docs/CheckoutStateProvinceResponse.md)
|
555
563
|
- [UltracartClient::CityStateZip](docs/CityStateZip.md)
|
564
|
+
- [UltracartClient::Conversation](docs/Conversation.md)
|
565
|
+
- [UltracartClient::ConversationAgentAuthResponse](docs/ConversationAgentAuthResponse.md)
|
566
|
+
- [UltracartClient::ConversationMessage](docs/ConversationMessage.md)
|
567
|
+
- [UltracartClient::ConversationParticipant](docs/ConversationParticipant.md)
|
568
|
+
- [UltracartClient::ConversationStartRequest](docs/ConversationStartRequest.md)
|
569
|
+
- [UltracartClient::ConversationStartResponse](docs/ConversationStartResponse.md)
|
570
|
+
- [UltracartClient::ConversationSummary](docs/ConversationSummary.md)
|
571
|
+
- [UltracartClient::ConversationsResponse](docs/ConversationsResponse.md)
|
556
572
|
- [UltracartClient::CountriesResponse](docs/CountriesResponse.md)
|
557
573
|
- [UltracartClient::Country](docs/Country.md)
|
558
574
|
- [UltracartClient::Coupon](docs/Coupon.md)
|
@@ -630,6 +646,7 @@ Class | Method | HTTP request | Description
|
|
630
646
|
- [UltracartClient::CustomerLoyalty](docs/CustomerLoyalty.md)
|
631
647
|
- [UltracartClient::CustomerLoyaltyLedger](docs/CustomerLoyaltyLedger.md)
|
632
648
|
- [UltracartClient::CustomerLoyaltyRedemption](docs/CustomerLoyaltyRedemption.md)
|
649
|
+
- [UltracartClient::CustomerMergeRequest](docs/CustomerMergeRequest.md)
|
633
650
|
- [UltracartClient::CustomerOrdersSummary](docs/CustomerOrdersSummary.md)
|
634
651
|
- [UltracartClient::CustomerPricingTier](docs/CustomerPricingTier.md)
|
635
652
|
- [UltracartClient::CustomerPrivacy](docs/CustomerPrivacy.md)
|
@@ -1100,6 +1117,8 @@ Class | Method | HTTP request | Description
|
|
1100
1117
|
- checkout_write: Allows you to write checkout information.
|
1101
1118
|
- configuration_read: Allows you to read configuration information.
|
1102
1119
|
- configuration_write: Allows you to write configuration information.
|
1120
|
+
- conversation_read: Allows you to read conversation information.
|
1121
|
+
- conversation_write: Allows you to write conversation information.
|
1103
1122
|
- coupon_read: Allows you to read coupon information.
|
1104
1123
|
- coupon_write: Allows you to write coupon information.
|
1105
1124
|
- customer_read: Allows you to read customer information.
|
@@ -1140,6 +1159,9 @@ Not every change is committed to every SDK.
|
|
1140
1159
|
|
1141
1160
|
| Version | Date | Comments |
|
1142
1161
|
| --: | :-: | --- |
|
1162
|
+
| 4.0.36-RC | 07/18/2022 | twilio dev |
|
1163
|
+
| 4.0.35-RC | 07/14/2022 | Add channel storefront_oid to the customer activity record |
|
1164
|
+
| 4.0.34-RC | 07/11/2022 | Customer API - mergeCustomer method |
|
1143
1165
|
| 4.0.33-RC | 07/05/2022 | docs update |
|
1144
1166
|
| 4.0.32-RC | 06/24/2022 | removed unneeded consumes declarations on several api calls (yaml fix) |
|
1145
1167
|
| 4.0.31-RC | 06/24/2022 | removed unneeded consumes declarations on several api calls (yaml fix) |
|
data/docs/Activity.md
CHANGED
@@ -5,7 +5,9 @@
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
7
|
| **action** | **String** | | [optional] |
|
8
|
+
| **channel** | **String** | | [optional] |
|
8
9
|
| **metric** | **String** | | [optional] |
|
10
|
+
| **storefront_oid** | **Integer** | | [optional] |
|
9
11
|
| **subject** | **String** | | [optional] |
|
10
12
|
| **ts** | **Integer** | | [optional] |
|
11
13
|
| **type** | **String** | | [optional] |
|
@@ -18,7 +20,9 @@ require 'ultracart_api'
|
|
18
20
|
|
19
21
|
instance = UltracartClient::Activity.new(
|
20
22
|
action: null,
|
23
|
+
channel: null,
|
21
24
|
metric: null,
|
25
|
+
storefront_oid: null,
|
22
26
|
subject: null,
|
23
27
|
ts: null,
|
24
28
|
type: null,
|
@@ -0,0 +1,26 @@
|
|
1
|
+
# UltracartClient::Conversation
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **conversation_arn** | **String** | | [optional] |
|
8
|
+
| **conversation_uuid** | **String** | | [optional] |
|
9
|
+
| **merchant_id** | **String** | | [optional] |
|
10
|
+
| **messages** | [**Array<ConversationMessage>**](ConversationMessage.md) | | [optional] |
|
11
|
+
| **participants** | [**Array<ConversationParticipant>**](ConversationParticipant.md) | | [optional] |
|
12
|
+
|
13
|
+
## Example
|
14
|
+
|
15
|
+
```ruby
|
16
|
+
require 'ultracart_api'
|
17
|
+
|
18
|
+
instance = UltracartClient::Conversation.new(
|
19
|
+
conversation_arn: null,
|
20
|
+
conversation_uuid: null,
|
21
|
+
merchant_id: null,
|
22
|
+
messages: null,
|
23
|
+
participants: null
|
24
|
+
)
|
25
|
+
```
|
26
|
+
|
@@ -0,0 +1,26 @@
|
|
1
|
+
# UltracartClient::ConversationAgentAuthResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **conversation_participant_arn** | **String** | | [optional] |
|
8
|
+
| **jwt** | **String** | | [optional] |
|
9
|
+
| **merchant_id** | **String** | | [optional] |
|
10
|
+
| **twilio_phone_numbers** | **Array<String>** | | [optional] |
|
11
|
+
| **websocket_url** | **String** | | [optional] |
|
12
|
+
|
13
|
+
## Example
|
14
|
+
|
15
|
+
```ruby
|
16
|
+
require 'ultracart_api'
|
17
|
+
|
18
|
+
instance = UltracartClient::ConversationAgentAuthResponse.new(
|
19
|
+
conversation_participant_arn: null,
|
20
|
+
jwt: null,
|
21
|
+
merchant_id: null,
|
22
|
+
twilio_phone_numbers: null,
|
23
|
+
websocket_url: null
|
24
|
+
)
|
25
|
+
```
|
26
|
+
|
@@ -0,0 +1,509 @@
|
|
1
|
+
# UltracartClient::ConversationApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
4
|
+
|
5
|
+
| Method | HTTP request | Description |
|
6
|
+
| ------ | ------------ | ----------- |
|
7
|
+
| [**get_agent_websocket_authorization**](ConversationApi.md#get_agent_websocket_authorization) | **PUT** /conversation/agent/auth | Get agent websocket authorization |
|
8
|
+
| [**get_conversation**](ConversationApi.md#get_conversation) | **GET** /conversation/conversations/{conversation_uuid} | Retrieve a conversation |
|
9
|
+
| [**get_conversation_multimedia_upload_url**](ConversationApi.md#get_conversation_multimedia_upload_url) | **GET** /conversation/upload_url/{extension} | Get a presigned conersation multimedia upload URL |
|
10
|
+
| [**get_conversations**](ConversationApi.md#get_conversations) | **GET** /conversation/conversations | Retrieve a list of conversation summaries newest to oldest |
|
11
|
+
| [**join_conversation**](ConversationApi.md#join_conversation) | **PUT** /conversation/conversations/{conversation_uuid}/join | Join a conversation |
|
12
|
+
| [**leave_conversation**](ConversationApi.md#leave_conversation) | **DELETE** /conversation/conversations/{conversation_uuid}/leave | Leave a conversation |
|
13
|
+
| [**start_conversation**](ConversationApi.md#start_conversation) | **PUT** /conversation/conversations | Start a conversation |
|
14
|
+
|
15
|
+
|
16
|
+
## get_agent_websocket_authorization
|
17
|
+
|
18
|
+
> <ConversationAgentAuthResponse> get_agent_websocket_authorization
|
19
|
+
|
20
|
+
Get agent websocket authorization
|
21
|
+
|
22
|
+
Retrieve a JWT to authorize an agent to make a websocket connection.
|
23
|
+
|
24
|
+
### Examples
|
25
|
+
|
26
|
+
```ruby
|
27
|
+
require 'time'
|
28
|
+
require 'ultracart_api'
|
29
|
+
require 'json'
|
30
|
+
require 'yaml'
|
31
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
32
|
+
|
33
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
34
|
+
# As such, this might not be the best way to use this object.
|
35
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
36
|
+
|
37
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
38
|
+
|
39
|
+
begin
|
40
|
+
# Get agent websocket authorization
|
41
|
+
result = api_instance.get_agent_websocket_authorization
|
42
|
+
p result
|
43
|
+
rescue UltracartClient::ApiError => e
|
44
|
+
puts "Error when calling ConversationApi->get_agent_websocket_authorization: #{e}"
|
45
|
+
end
|
46
|
+
```
|
47
|
+
|
48
|
+
#### Using the get_agent_websocket_authorization_with_http_info variant
|
49
|
+
|
50
|
+
This returns an Array which contains the response data, status code and headers.
|
51
|
+
|
52
|
+
> <Array(<ConversationAgentAuthResponse>, Integer, Hash)> get_agent_websocket_authorization_with_http_info
|
53
|
+
|
54
|
+
```ruby
|
55
|
+
begin
|
56
|
+
# Get agent websocket authorization
|
57
|
+
data, status_code, headers = api_instance.get_agent_websocket_authorization_with_http_info
|
58
|
+
p status_code # => 2xx
|
59
|
+
p headers # => { ... }
|
60
|
+
p data # => <ConversationAgentAuthResponse>
|
61
|
+
rescue UltracartClient::ApiError => e
|
62
|
+
puts "Error when calling ConversationApi->get_agent_websocket_authorization_with_http_info: #{e}"
|
63
|
+
end
|
64
|
+
```
|
65
|
+
|
66
|
+
### Parameters
|
67
|
+
|
68
|
+
This endpoint does not need any parameter.
|
69
|
+
|
70
|
+
### Return type
|
71
|
+
|
72
|
+
[**ConversationAgentAuthResponse**](ConversationAgentAuthResponse.md)
|
73
|
+
|
74
|
+
### Authorization
|
75
|
+
|
76
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
77
|
+
|
78
|
+
### HTTP request headers
|
79
|
+
|
80
|
+
- **Content-Type**: Not defined
|
81
|
+
- **Accept**: application/json
|
82
|
+
|
83
|
+
|
84
|
+
## get_conversation
|
85
|
+
|
86
|
+
> <Conversation> get_conversation(conversation_uuid)
|
87
|
+
|
88
|
+
Retrieve a conversation
|
89
|
+
|
90
|
+
Retrieve a conversation including the participants and messages
|
91
|
+
|
92
|
+
### Examples
|
93
|
+
|
94
|
+
```ruby
|
95
|
+
require 'time'
|
96
|
+
require 'ultracart_api'
|
97
|
+
require 'json'
|
98
|
+
require 'yaml'
|
99
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
100
|
+
|
101
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
102
|
+
# As such, this might not be the best way to use this object.
|
103
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
104
|
+
|
105
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
106
|
+
conversation_uuid = 'conversation_uuid_example' # String |
|
107
|
+
|
108
|
+
begin
|
109
|
+
# Retrieve a conversation
|
110
|
+
result = api_instance.get_conversation(conversation_uuid)
|
111
|
+
p result
|
112
|
+
rescue UltracartClient::ApiError => e
|
113
|
+
puts "Error when calling ConversationApi->get_conversation: #{e}"
|
114
|
+
end
|
115
|
+
```
|
116
|
+
|
117
|
+
#### Using the get_conversation_with_http_info variant
|
118
|
+
|
119
|
+
This returns an Array which contains the response data, status code and headers.
|
120
|
+
|
121
|
+
> <Array(<Conversation>, Integer, Hash)> get_conversation_with_http_info(conversation_uuid)
|
122
|
+
|
123
|
+
```ruby
|
124
|
+
begin
|
125
|
+
# Retrieve a conversation
|
126
|
+
data, status_code, headers = api_instance.get_conversation_with_http_info(conversation_uuid)
|
127
|
+
p status_code # => 2xx
|
128
|
+
p headers # => { ... }
|
129
|
+
p data # => <Conversation>
|
130
|
+
rescue UltracartClient::ApiError => e
|
131
|
+
puts "Error when calling ConversationApi->get_conversation_with_http_info: #{e}"
|
132
|
+
end
|
133
|
+
```
|
134
|
+
|
135
|
+
### Parameters
|
136
|
+
|
137
|
+
| Name | Type | Description | Notes |
|
138
|
+
| ---- | ---- | ----------- | ----- |
|
139
|
+
| **conversation_uuid** | **String** | | |
|
140
|
+
|
141
|
+
### Return type
|
142
|
+
|
143
|
+
[**Conversation**](Conversation.md)
|
144
|
+
|
145
|
+
### Authorization
|
146
|
+
|
147
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
148
|
+
|
149
|
+
### HTTP request headers
|
150
|
+
|
151
|
+
- **Content-Type**: Not defined
|
152
|
+
- **Accept**: application/json
|
153
|
+
|
154
|
+
|
155
|
+
## get_conversation_multimedia_upload_url
|
156
|
+
|
157
|
+
> get_conversation_multimedia_upload_url(extension)
|
158
|
+
|
159
|
+
Get a presigned conersation multimedia upload URL
|
160
|
+
|
161
|
+
Get a presigned conersation multimedia upload URL
|
162
|
+
|
163
|
+
### Examples
|
164
|
+
|
165
|
+
```ruby
|
166
|
+
require 'time'
|
167
|
+
require 'ultracart_api'
|
168
|
+
require 'json'
|
169
|
+
require 'yaml'
|
170
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
171
|
+
|
172
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
173
|
+
# As such, this might not be the best way to use this object.
|
174
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
175
|
+
|
176
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
177
|
+
extension = 'extension_example' # String |
|
178
|
+
|
179
|
+
begin
|
180
|
+
# Get a presigned conersation multimedia upload URL
|
181
|
+
api_instance.get_conversation_multimedia_upload_url(extension)
|
182
|
+
rescue UltracartClient::ApiError => e
|
183
|
+
puts "Error when calling ConversationApi->get_conversation_multimedia_upload_url: #{e}"
|
184
|
+
end
|
185
|
+
```
|
186
|
+
|
187
|
+
#### Using the get_conversation_multimedia_upload_url_with_http_info variant
|
188
|
+
|
189
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
190
|
+
|
191
|
+
> <Array(nil, Integer, Hash)> get_conversation_multimedia_upload_url_with_http_info(extension)
|
192
|
+
|
193
|
+
```ruby
|
194
|
+
begin
|
195
|
+
# Get a presigned conersation multimedia upload URL
|
196
|
+
data, status_code, headers = api_instance.get_conversation_multimedia_upload_url_with_http_info(extension)
|
197
|
+
p status_code # => 2xx
|
198
|
+
p headers # => { ... }
|
199
|
+
p data # => nil
|
200
|
+
rescue UltracartClient::ApiError => e
|
201
|
+
puts "Error when calling ConversationApi->get_conversation_multimedia_upload_url_with_http_info: #{e}"
|
202
|
+
end
|
203
|
+
```
|
204
|
+
|
205
|
+
### Parameters
|
206
|
+
|
207
|
+
| Name | Type | Description | Notes |
|
208
|
+
| ---- | ---- | ----------- | ----- |
|
209
|
+
| **extension** | **String** | | |
|
210
|
+
|
211
|
+
### Return type
|
212
|
+
|
213
|
+
nil (empty response body)
|
214
|
+
|
215
|
+
### Authorization
|
216
|
+
|
217
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
218
|
+
|
219
|
+
### HTTP request headers
|
220
|
+
|
221
|
+
- **Content-Type**: Not defined
|
222
|
+
- **Accept**: application/json
|
223
|
+
|
224
|
+
|
225
|
+
## get_conversations
|
226
|
+
|
227
|
+
> <ConversationsResponse> get_conversations(opts)
|
228
|
+
|
229
|
+
Retrieve a list of conversation summaries newest to oldest
|
230
|
+
|
231
|
+
Retrieve a list of conversation summaries that are ordered newest to oldest, include the most recent message and whether its been read.
|
232
|
+
|
233
|
+
### Examples
|
234
|
+
|
235
|
+
```ruby
|
236
|
+
require 'time'
|
237
|
+
require 'ultracart_api'
|
238
|
+
require 'json'
|
239
|
+
require 'yaml'
|
240
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
241
|
+
|
242
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
243
|
+
# As such, this might not be the best way to use this object.
|
244
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
245
|
+
|
246
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
247
|
+
opts = {
|
248
|
+
_limit: 56, # Integer | The maximum number of records to return on this one API call. (Max 200)
|
249
|
+
_offset: 56 # Integer | Pagination of the record set. Offset is a zero based index.
|
250
|
+
}
|
251
|
+
|
252
|
+
begin
|
253
|
+
# Retrieve a list of conversation summaries newest to oldest
|
254
|
+
result = api_instance.get_conversations(opts)
|
255
|
+
p result
|
256
|
+
rescue UltracartClient::ApiError => e
|
257
|
+
puts "Error when calling ConversationApi->get_conversations: #{e}"
|
258
|
+
end
|
259
|
+
```
|
260
|
+
|
261
|
+
#### Using the get_conversations_with_http_info variant
|
262
|
+
|
263
|
+
This returns an Array which contains the response data, status code and headers.
|
264
|
+
|
265
|
+
> <Array(<ConversationsResponse>, Integer, Hash)> get_conversations_with_http_info(opts)
|
266
|
+
|
267
|
+
```ruby
|
268
|
+
begin
|
269
|
+
# Retrieve a list of conversation summaries newest to oldest
|
270
|
+
data, status_code, headers = api_instance.get_conversations_with_http_info(opts)
|
271
|
+
p status_code # => 2xx
|
272
|
+
p headers # => { ... }
|
273
|
+
p data # => <ConversationsResponse>
|
274
|
+
rescue UltracartClient::ApiError => e
|
275
|
+
puts "Error when calling ConversationApi->get_conversations_with_http_info: #{e}"
|
276
|
+
end
|
277
|
+
```
|
278
|
+
|
279
|
+
### Parameters
|
280
|
+
|
281
|
+
| Name | Type | Description | Notes |
|
282
|
+
| ---- | ---- | ----------- | ----- |
|
283
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Max 200) | [optional][default to 100] |
|
284
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
285
|
+
|
286
|
+
### Return type
|
287
|
+
|
288
|
+
[**ConversationsResponse**](ConversationsResponse.md)
|
289
|
+
|
290
|
+
### Authorization
|
291
|
+
|
292
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
293
|
+
|
294
|
+
### HTTP request headers
|
295
|
+
|
296
|
+
- **Content-Type**: Not defined
|
297
|
+
- **Accept**: application/json
|
298
|
+
|
299
|
+
|
300
|
+
## join_conversation
|
301
|
+
|
302
|
+
> join_conversation(conversation_uuid)
|
303
|
+
|
304
|
+
Join a conversation
|
305
|
+
|
306
|
+
Join a conversation
|
307
|
+
|
308
|
+
### Examples
|
309
|
+
|
310
|
+
```ruby
|
311
|
+
require 'time'
|
312
|
+
require 'ultracart_api'
|
313
|
+
require 'json'
|
314
|
+
require 'yaml'
|
315
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
316
|
+
|
317
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
318
|
+
# As such, this might not be the best way to use this object.
|
319
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
320
|
+
|
321
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
322
|
+
conversation_uuid = 'conversation_uuid_example' # String |
|
323
|
+
|
324
|
+
begin
|
325
|
+
# Join a conversation
|
326
|
+
api_instance.join_conversation(conversation_uuid)
|
327
|
+
rescue UltracartClient::ApiError => e
|
328
|
+
puts "Error when calling ConversationApi->join_conversation: #{e}"
|
329
|
+
end
|
330
|
+
```
|
331
|
+
|
332
|
+
#### Using the join_conversation_with_http_info variant
|
333
|
+
|
334
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
335
|
+
|
336
|
+
> <Array(nil, Integer, Hash)> join_conversation_with_http_info(conversation_uuid)
|
337
|
+
|
338
|
+
```ruby
|
339
|
+
begin
|
340
|
+
# Join a conversation
|
341
|
+
data, status_code, headers = api_instance.join_conversation_with_http_info(conversation_uuid)
|
342
|
+
p status_code # => 2xx
|
343
|
+
p headers # => { ... }
|
344
|
+
p data # => nil
|
345
|
+
rescue UltracartClient::ApiError => e
|
346
|
+
puts "Error when calling ConversationApi->join_conversation_with_http_info: #{e}"
|
347
|
+
end
|
348
|
+
```
|
349
|
+
|
350
|
+
### Parameters
|
351
|
+
|
352
|
+
| Name | Type | Description | Notes |
|
353
|
+
| ---- | ---- | ----------- | ----- |
|
354
|
+
| **conversation_uuid** | **String** | | |
|
355
|
+
|
356
|
+
### Return type
|
357
|
+
|
358
|
+
nil (empty response body)
|
359
|
+
|
360
|
+
### Authorization
|
361
|
+
|
362
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
363
|
+
|
364
|
+
### HTTP request headers
|
365
|
+
|
366
|
+
- **Content-Type**: Not defined
|
367
|
+
- **Accept**: application/json
|
368
|
+
|
369
|
+
|
370
|
+
## leave_conversation
|
371
|
+
|
372
|
+
> leave_conversation(conversation_uuid)
|
373
|
+
|
374
|
+
Leave a conversation
|
375
|
+
|
376
|
+
Leave a conversation
|
377
|
+
|
378
|
+
### Examples
|
379
|
+
|
380
|
+
```ruby
|
381
|
+
require 'time'
|
382
|
+
require 'ultracart_api'
|
383
|
+
require 'json'
|
384
|
+
require 'yaml'
|
385
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
386
|
+
|
387
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
388
|
+
# As such, this might not be the best way to use this object.
|
389
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
390
|
+
|
391
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
392
|
+
conversation_uuid = 'conversation_uuid_example' # String |
|
393
|
+
|
394
|
+
begin
|
395
|
+
# Leave a conversation
|
396
|
+
api_instance.leave_conversation(conversation_uuid)
|
397
|
+
rescue UltracartClient::ApiError => e
|
398
|
+
puts "Error when calling ConversationApi->leave_conversation: #{e}"
|
399
|
+
end
|
400
|
+
```
|
401
|
+
|
402
|
+
#### Using the leave_conversation_with_http_info variant
|
403
|
+
|
404
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
405
|
+
|
406
|
+
> <Array(nil, Integer, Hash)> leave_conversation_with_http_info(conversation_uuid)
|
407
|
+
|
408
|
+
```ruby
|
409
|
+
begin
|
410
|
+
# Leave a conversation
|
411
|
+
data, status_code, headers = api_instance.leave_conversation_with_http_info(conversation_uuid)
|
412
|
+
p status_code # => 2xx
|
413
|
+
p headers # => { ... }
|
414
|
+
p data # => nil
|
415
|
+
rescue UltracartClient::ApiError => e
|
416
|
+
puts "Error when calling ConversationApi->leave_conversation_with_http_info: #{e}"
|
417
|
+
end
|
418
|
+
```
|
419
|
+
|
420
|
+
### Parameters
|
421
|
+
|
422
|
+
| Name | Type | Description | Notes |
|
423
|
+
| ---- | ---- | ----------- | ----- |
|
424
|
+
| **conversation_uuid** | **String** | | |
|
425
|
+
|
426
|
+
### Return type
|
427
|
+
|
428
|
+
nil (empty response body)
|
429
|
+
|
430
|
+
### Authorization
|
431
|
+
|
432
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
433
|
+
|
434
|
+
### HTTP request headers
|
435
|
+
|
436
|
+
- **Content-Type**: Not defined
|
437
|
+
- **Accept**: application/json
|
438
|
+
|
439
|
+
|
440
|
+
## start_conversation
|
441
|
+
|
442
|
+
> <ConversationStartResponse> start_conversation(start_request)
|
443
|
+
|
444
|
+
Start a conversation
|
445
|
+
|
446
|
+
Start a new conversation
|
447
|
+
|
448
|
+
### Examples
|
449
|
+
|
450
|
+
```ruby
|
451
|
+
require 'time'
|
452
|
+
require 'ultracart_api'
|
453
|
+
require 'json'
|
454
|
+
require 'yaml'
|
455
|
+
require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
|
456
|
+
|
457
|
+
# This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
|
458
|
+
# As such, this might not be the best way to use this object.
|
459
|
+
# Please see https://github.com/UltraCart/sdk_samples for working examples.
|
460
|
+
|
461
|
+
api = UltracartClient::ConversationApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
|
462
|
+
start_request = UltracartClient::ConversationStartRequest.new # ConversationStartRequest | Start request
|
463
|
+
|
464
|
+
begin
|
465
|
+
# Start a conversation
|
466
|
+
result = api_instance.start_conversation(start_request)
|
467
|
+
p result
|
468
|
+
rescue UltracartClient::ApiError => e
|
469
|
+
puts "Error when calling ConversationApi->start_conversation: #{e}"
|
470
|
+
end
|
471
|
+
```
|
472
|
+
|
473
|
+
#### Using the start_conversation_with_http_info variant
|
474
|
+
|
475
|
+
This returns an Array which contains the response data, status code and headers.
|
476
|
+
|
477
|
+
> <Array(<ConversationStartResponse>, Integer, Hash)> start_conversation_with_http_info(start_request)
|
478
|
+
|
479
|
+
```ruby
|
480
|
+
begin
|
481
|
+
# Start a conversation
|
482
|
+
data, status_code, headers = api_instance.start_conversation_with_http_info(start_request)
|
483
|
+
p status_code # => 2xx
|
484
|
+
p headers # => { ... }
|
485
|
+
p data # => <ConversationStartResponse>
|
486
|
+
rescue UltracartClient::ApiError => e
|
487
|
+
puts "Error when calling ConversationApi->start_conversation_with_http_info: #{e}"
|
488
|
+
end
|
489
|
+
```
|
490
|
+
|
491
|
+
### Parameters
|
492
|
+
|
493
|
+
| Name | Type | Description | Notes |
|
494
|
+
| ---- | ---- | ----------- | ----- |
|
495
|
+
| **start_request** | [**ConversationStartRequest**](ConversationStartRequest.md) | Start request | |
|
496
|
+
|
497
|
+
### Return type
|
498
|
+
|
499
|
+
[**ConversationStartResponse**](ConversationStartResponse.md)
|
500
|
+
|
501
|
+
### Authorization
|
502
|
+
|
503
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
504
|
+
|
505
|
+
### HTTP request headers
|
506
|
+
|
507
|
+
- **Content-Type**: application/json
|
508
|
+
- **Accept**: application/json
|
509
|
+
|