ultracart_api 4.1.231 → 4.1.233
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +72 -2
- data/docs/ItemContentMultimedia.md +2 -0
- data/docs/SfvbApi.md +1660 -162
- data/docs/SfvbApprovalCreateRequest.md +8 -0
- data/docs/SfvbCampaign.md +4 -0
- data/docs/SfvbCampaignWriteRequest.md +2 -0
- data/docs/SfvbCommsBranchStat.md +20 -0
- data/docs/SfvbCommsChange.md +22 -0
- data/docs/SfvbCommsClick.md +20 -0
- data/docs/SfvbCommsClicksResponse.md +26 -0
- data/docs/SfvbCommsDailyStat.md +30 -0
- data/docs/SfvbCommsDashboardResponse.md +24 -0
- data/docs/SfvbCommsDashboardRow.md +28 -0
- data/docs/SfvbCommsLookupOwner.md +26 -0
- data/docs/SfvbCommsLookupResponse.md +34 -0
- data/docs/SfvbCommsPlan.md +66 -0
- data/docs/SfvbCommsPlanResponse.md +20 -0
- data/docs/SfvbCommsProvider.md +28 -0
- data/docs/SfvbCommsProviderImportRequest.md +22 -0
- data/docs/SfvbCommsProviderImportResponse.md +26 -0
- data/docs/SfvbCommsProviderList.md +20 -0
- data/docs/SfvbCommsProvidersResponse.md +22 -0
- data/docs/SfvbCommsRulerValidateRequest.md +18 -0
- data/docs/SfvbCommsRulerValidateResponse.md +22 -0
- data/docs/SfvbCommsSender.md +24 -0
- data/docs/SfvbCommsSenderUpdate.md +22 -0
- data/docs/SfvbCommsSequenceFolder.md +28 -0
- data/docs/SfvbCommsSequenceFolderResponse.md +22 -0
- data/docs/SfvbCommsSequenceFoldersResponse.md +18 -0
- data/docs/SfvbCommsSequenceStatsResponse.md +26 -0
- data/docs/SfvbCommsSettings.md +34 -0
- data/docs/SfvbCommsSettingsResponse.md +24 -0
- data/docs/SfvbCommsSettingsUpdateRequest.md +26 -0
- data/docs/SfvbCommsStat.md +54 -0
- data/docs/SfvbCommsStepStat.md +34 -0
- data/docs/SfvbCommsTemplate.md +30 -0
- data/docs/SfvbCommsTemplateResponse.md +30 -0
- data/docs/SfvbCommsTemplatesResponse.md +20 -0
- data/docs/SfvbCommsTestEmailRequest.md +24 -0
- data/docs/SfvbCommsTestPostcardRequest.md +36 -0
- data/docs/SfvbCommsTestSendResponse.md +32 -0
- data/docs/SfvbCommsTestSmsRequest.md +18 -0
- data/docs/SfvbCommsUnreferencedEmail.md +30 -0
- data/docs/SfvbCommsUnreferencedPostcard.md +24 -0
- data/docs/SfvbCommsUnreferencedResponse.md +32 -0
- data/docs/SfvbEmail.md +8 -0
- data/docs/SfvbFlow.md +4 -0
- data/docs/SfvbFlowBackfillRequest.md +24 -0
- data/docs/SfvbFlowBackfillResponse.md +38 -0
- data/docs/SfvbFlowWriteRequest.md +2 -0
- data/docs/SfvbStepCounts.md +1 -1
- data/lib/ultracart_api/api/sfvb_api.rb +2356 -348
- data/lib/ultracart_api/models/item_content_multimedia.rb +11 -1
- data/lib/ultracart_api/models/sfvb_approval_create_request.rb +39 -3
- data/lib/ultracart_api/models/sfvb_campaign.rb +21 -1
- data/lib/ultracart_api/models/sfvb_campaign_write_request.rb +11 -1
- data/lib/ultracart_api/models/sfvb_comms_branch_stat.rb +229 -0
- data/lib/ultracart_api/models/sfvb_comms_change.rb +240 -0
- data/lib/ultracart_api/models/sfvb_comms_click.rb +230 -0
- data/lib/ultracart_api/models/sfvb_comms_clicks_response.rb +264 -0
- data/lib/ultracart_api/models/sfvb_comms_daily_stat.rb +280 -0
- data/lib/ultracart_api/models/sfvb_comms_dashboard_response.rb +256 -0
- data/lib/ultracart_api/models/sfvb_comms_dashboard_row.rb +269 -0
- data/lib/ultracart_api/models/sfvb_comms_lookup_owner.rb +260 -0
- data/lib/ultracart_api/models/sfvb_comms_lookup_response.rb +301 -0
- data/lib/ultracart_api/models/sfvb_comms_plan.rb +460 -0
- data/lib/ultracart_api/models/sfvb_comms_plan_response.rb +231 -0
- data/lib/ultracart_api/models/sfvb_comms_provider.rb +272 -0
- data/lib/ultracart_api/models/sfvb_comms_provider_import_request.rb +242 -0
- data/lib/ultracart_api/models/sfvb_comms_provider_import_response.rb +264 -0
- data/lib/ultracart_api/models/sfvb_comms_provider_list.rb +230 -0
- data/lib/ultracart_api/models/sfvb_comms_providers_response.rb +244 -0
- data/lib/ultracart_api/models/sfvb_comms_ruler_validate_request.rb +220 -0
- data/lib/ultracart_api/models/sfvb_comms_ruler_validate_response.rb +242 -0
- data/lib/ultracart_api/models/sfvb_comms_sender.rb +250 -0
- data/lib/ultracart_api/models/sfvb_comms_sender_update.rb +240 -0
- data/lib/ultracart_api/models/sfvb_comms_sequence_folder.rb +270 -0
- data/lib/ultracart_api/models/sfvb_comms_sequence_folder_response.rb +243 -0
- data/lib/ultracart_api/models/sfvb_comms_sequence_folders_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_comms_sequence_stats_response.rb +263 -0
- data/lib/ultracart_api/models/sfvb_comms_settings.rb +297 -0
- data/lib/ultracart_api/models/sfvb_comms_settings_response.rb +253 -0
- data/lib/ultracart_api/models/sfvb_comms_settings_update_request.rb +257 -0
- data/lib/ultracart_api/models/sfvb_comms_stat.rb +402 -0
- data/lib/ultracart_api/models/sfvb_comms_step_stat.rb +301 -0
- data/lib/ultracart_api/models/sfvb_comms_template.rb +280 -0
- data/lib/ultracart_api/models/sfvb_comms_template_response.rb +281 -0
- data/lib/ultracart_api/models/sfvb_comms_templates_response.rb +234 -0
- data/lib/ultracart_api/models/sfvb_comms_test_email_request.rb +252 -0
- data/lib/ultracart_api/models/sfvb_comms_test_postcard_request.rb +312 -0
- data/lib/ultracart_api/models/sfvb_comms_test_send_response.rb +292 -0
- data/lib/ultracart_api/models/sfvb_comms_test_sms_request.rb +220 -0
- data/lib/ultracart_api/models/sfvb_comms_unreferenced_email.rb +280 -0
- data/lib/ultracart_api/models/sfvb_comms_unreferenced_postcard.rb +250 -0
- data/lib/ultracart_api/models/sfvb_comms_unreferenced_response.rb +296 -0
- data/lib/ultracart_api/models/sfvb_email.rb +41 -1
- data/lib/ultracart_api/models/sfvb_flow.rb +21 -1
- data/lib/ultracart_api/models/sfvb_flow_backfill_request.rb +250 -0
- data/lib/ultracart_api/models/sfvb_flow_backfill_response.rb +322 -0
- data/lib/ultracart_api/models/sfvb_flow_write_request.rb +11 -1
- data/lib/ultracart_api/models/sfvb_step_counts.rb +1 -1
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +41 -0
- metadata +84 -2
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSequenceFoldersResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **folders** | [**Array<SfvbCommsSequenceFolder>**](SfvbCommsSequenceFolder.md) | The folders, by name. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbCommsSequenceFoldersResponse.new(
|
|
15
|
+
folders: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSequenceStatsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **communication_sequence_uuid** | **String** | The sequence. | [optional] |
|
|
8
|
+
| **days** | **Integer** | The window, in days, for the step counts. | [optional] |
|
|
9
|
+
| **notes** | **Array<String>** | What the windows are and what a missing count means. | [optional] |
|
|
10
|
+
| **overall** | [**SfvbCommsStat**](SfvbCommsStat.md) | | [optional] |
|
|
11
|
+
| **steps** | [**Array<SfvbCommsStepStat>**](SfvbCommsStepStat.md) | Each email, SMS, postcard and branch step, in the stored order. | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::SfvbCommsSequenceStatsResponse.new(
|
|
19
|
+
communication_sequence_uuid: null,
|
|
20
|
+
days: null,
|
|
21
|
+
notes: null,
|
|
22
|
+
overall: null,
|
|
23
|
+
steps: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSettings
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **hash_sha256** | **String** | The hash of the settings. Send it as If-Match to change them. | [optional] |
|
|
8
|
+
| **machine_open_ignore** | **Boolean** | True when opens by mail privacy proxies are ignored. Account-wide; changed in the admin. | [optional] |
|
|
9
|
+
| **marketing_sender** | [**SfvbCommsSender**](SfvbCommsSender.md) | | [optional] |
|
|
10
|
+
| **postcard_return_address** | [**SfvbPostcardAddress**](SfvbPostcardAddress.md) | | [optional] |
|
|
11
|
+
| **postcard_return_address_complete** | **Boolean** | True when the name, street, city, state and postal code are all set. Until then postcards fall back as the send code does. | [optional] |
|
|
12
|
+
| **reviews_io_configured** | **Boolean** | True when a Reviews.io key is set for the account. | [optional] |
|
|
13
|
+
| **sms_phone_number** | **String** | The default SMS number the admin offers for a new flow or campaign. No send reads it. An SMS step sends from its flow's or campaign's own number. | [optional] |
|
|
14
|
+
| **sms_twilio_uuid** | **String** | The Twilio account that holds sms_phone_number. | [optional] |
|
|
15
|
+
| **transactional_sender** | [**SfvbCommsSender**](SfvbCommsSender.md) | | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'ultracart_api'
|
|
21
|
+
|
|
22
|
+
instance = UltracartClient::SfvbCommsSettings.new(
|
|
23
|
+
hash_sha256: null,
|
|
24
|
+
machine_open_ignore: null,
|
|
25
|
+
marketing_sender: null,
|
|
26
|
+
postcard_return_address: null,
|
|
27
|
+
postcard_return_address_complete: null,
|
|
28
|
+
reviews_io_configured: null,
|
|
29
|
+
sms_phone_number: null,
|
|
30
|
+
sms_twilio_uuid: null,
|
|
31
|
+
transactional_sender: null
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSettingsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **changes** | [**Array<SfvbCommsChange>**](SfvbCommsChange.md) | Each setting the call changed, or would change on a dry run. | [optional] |
|
|
8
|
+
| **dry_run** | **Boolean** | True when nothing was written. | [optional] |
|
|
9
|
+
| **notes** | **Array<String>** | Where each change takes effect. | [optional] |
|
|
10
|
+
| **settings** | [**SfvbCommsSettings**](SfvbCommsSettings.md) | | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbCommsSettingsResponse.new(
|
|
18
|
+
changes: null,
|
|
19
|
+
dry_run: null,
|
|
20
|
+
notes: null,
|
|
21
|
+
settings: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSettingsUpdateRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **dry_run** | **Boolean** | Check the change and show it without writing or using an approval. | [optional] |
|
|
8
|
+
| **marketing_sender** | [**SfvbCommsSenderUpdate**](SfvbCommsSenderUpdate.md) | | [optional] |
|
|
9
|
+
| **postcard_return_address** | [**SfvbPostcardAddress**](SfvbPostcardAddress.md) | | [optional] |
|
|
10
|
+
| **sms_phone_number** | **String** | The default SMS number, one of the account's Twilio numbers, or an empty string to clear it. | [optional] |
|
|
11
|
+
| **transactional_sender** | [**SfvbCommsSenderUpdate**](SfvbCommsSenderUpdate.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::SfvbCommsSettingsUpdateRequest.new(
|
|
19
|
+
dry_run: null,
|
|
20
|
+
marketing_sender: null,
|
|
21
|
+
postcard_return_address: null,
|
|
22
|
+
sms_phone_number: null,
|
|
23
|
+
transactional_sender: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsStat
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **bounced** | **Integer** | Permanent bounces. | [optional] |
|
|
8
|
+
| **channel** | **String** | email, sms, postcard, branch or sequence, or step for a step type that records no counts of its own, with every count named in not_measured. | [optional] |
|
|
9
|
+
| **clicked** | **Integer** | Clicks (for a postcard, scans of its QR code). | [optional] |
|
|
10
|
+
| **conversions** | **Integer** | Conversions. | [optional] |
|
|
11
|
+
| **customers** | **Integer** | Customers who reached it (a branch side), or started (a whole sequence). | [optional] |
|
|
12
|
+
| **delivered** | **Integer** | Deliveries. | [optional] |
|
|
13
|
+
| **finished** | **Integer** | Customers who finished the sequence. | [optional] |
|
|
14
|
+
| **in_progress** | **Integer** | Customers in the sequence now. | [optional] |
|
|
15
|
+
| **invalid** | **Integer** | Addresses the email validator refused. | [optional] |
|
|
16
|
+
| **not_measured** | **Array<String>** | The counts this channel doesn't record, left out above. | [optional] |
|
|
17
|
+
| **opened** | **Integer** | Opens. | [optional] |
|
|
18
|
+
| **orders** | **Integer** | Orders attributed. | [optional] |
|
|
19
|
+
| **profit** | **Float** | Profit attributed. | [optional] |
|
|
20
|
+
| **returned_to_sender** | **Integer** | Postcards returned to sender. | [optional] |
|
|
21
|
+
| **revenue** | **Float** | Revenue attributed. | [optional] |
|
|
22
|
+
| **sent** | **Integer** | Sends. | [optional] |
|
|
23
|
+
| **skipped** | **Integer** | Customers skipped. | [optional] |
|
|
24
|
+
| **spam** | **Integer** | Spam complaints. | [optional] |
|
|
25
|
+
| **unsubscribed** | **Integer** | Unsubscribes. | [optional] |
|
|
26
|
+
|
|
27
|
+
## Example
|
|
28
|
+
|
|
29
|
+
```ruby
|
|
30
|
+
require 'ultracart_api'
|
|
31
|
+
|
|
32
|
+
instance = UltracartClient::SfvbCommsStat.new(
|
|
33
|
+
bounced: null,
|
|
34
|
+
channel: null,
|
|
35
|
+
clicked: null,
|
|
36
|
+
conversions: null,
|
|
37
|
+
customers: null,
|
|
38
|
+
delivered: null,
|
|
39
|
+
finished: null,
|
|
40
|
+
in_progress: null,
|
|
41
|
+
invalid: null,
|
|
42
|
+
not_measured: null,
|
|
43
|
+
opened: null,
|
|
44
|
+
orders: null,
|
|
45
|
+
profit: null,
|
|
46
|
+
returned_to_sender: null,
|
|
47
|
+
revenue: null,
|
|
48
|
+
sent: null,
|
|
49
|
+
skipped: null,
|
|
50
|
+
spam: null,
|
|
51
|
+
unsubscribed: null
|
|
52
|
+
)
|
|
53
|
+
```
|
|
54
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsStepStat
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **branches** | [**Array<SfvbCommsBranchStat>**](SfvbCommsBranchStat.md) | Each side's counts, for a condition, split or InboxGeek step. | [optional] |
|
|
8
|
+
| **email_uuid** | **String** | The email it sends, for an email or experiment variant. | [optional] |
|
|
9
|
+
| **label** | **String** | The step type as the admin shows it. | [optional] |
|
|
10
|
+
| **name** | **String** | The step's name, if it has one. | [optional] |
|
|
11
|
+
| **postcard_uuid** | **String** | The postcard it mails, for a postcard step. | [optional] |
|
|
12
|
+
| **stats** | [**SfvbCommsStat**](SfvbCommsStat.md) | | [optional] |
|
|
13
|
+
| **step_uuid** | **String** | The step. | [optional] |
|
|
14
|
+
| **type** | **String** | The step type. | [optional] |
|
|
15
|
+
| **variant_name** | **String** | The experiment variant, for an experiment step. | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'ultracart_api'
|
|
21
|
+
|
|
22
|
+
instance = UltracartClient::SfvbCommsStepStat.new(
|
|
23
|
+
branches: null,
|
|
24
|
+
email_uuid: null,
|
|
25
|
+
label: null,
|
|
26
|
+
name: null,
|
|
27
|
+
postcard_uuid: null,
|
|
28
|
+
stats: null,
|
|
29
|
+
step_uuid: null,
|
|
30
|
+
type: null,
|
|
31
|
+
variant_name: null
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTemplate
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **description** | **String** | The description. | [optional] |
|
|
8
|
+
| **email_template_oid** | **Integer** | The saved template's id, for a storefront or system template. | [optional] |
|
|
9
|
+
| **name** | **String** | The name. | [optional] |
|
|
10
|
+
| **path** | **String** | The theme file, for a base template. | [optional] |
|
|
11
|
+
| **sort_order** | **Integer** | The admin's order. | [optional] |
|
|
12
|
+
| **source** | **String** | storefront (saved on this storefront), system (UltraCart's), or base (a theme file an email renders inside). | [optional] |
|
|
13
|
+
| **trigger_type** | **String** | The flow trigger the template is meant for, or none. | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'ultracart_api'
|
|
19
|
+
|
|
20
|
+
instance = UltracartClient::SfvbCommsTemplate.new(
|
|
21
|
+
description: null,
|
|
22
|
+
email_template_oid: null,
|
|
23
|
+
name: null,
|
|
24
|
+
path: null,
|
|
25
|
+
sort_order: null,
|
|
26
|
+
source: null,
|
|
27
|
+
trigger_type: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTemplateResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **container_cjson** | **String** | The template's body, as CJSON. | [optional] |
|
|
8
|
+
| **email_template_vm_path** | **String** | The Velocity template it renders inside, as stored. It is looked up in the storefront's active theme. | [optional] |
|
|
9
|
+
| **notes** | **Array<String>** | What isn't shown. | [optional] |
|
|
10
|
+
| **template** | [**SfvbCommsTemplate**](SfvbCommsTemplate.md) | | [optional] |
|
|
11
|
+
| **template_exists** | **Boolean** | True when the file at template_path exists. | [optional] |
|
|
12
|
+
| **template_note** | **String** | Why there is no template file, or null when there is one. | [optional] |
|
|
13
|
+
| **template_path** | **String** | The theme file that template is, as a render finds it. Read it with the files endpoints, whose read also reports valid and velocity_errors. Null when it couldn't be worked out, with template_note saying why. | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'ultracart_api'
|
|
19
|
+
|
|
20
|
+
instance = UltracartClient::SfvbCommsTemplateResponse.new(
|
|
21
|
+
container_cjson: null,
|
|
22
|
+
email_template_vm_path: null,
|
|
23
|
+
notes: null,
|
|
24
|
+
template: null,
|
|
25
|
+
template_exists: null,
|
|
26
|
+
template_note: null,
|
|
27
|
+
template_path: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTemplatesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **notes** | **Array<String>** | What each source is. | [optional] |
|
|
8
|
+
| **templates** | [**Array<SfvbCommsTemplate>**](SfvbCommsTemplate.md) | Saved templates first (system, then this storefront's), then base templates. | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'ultracart_api'
|
|
14
|
+
|
|
15
|
+
instance = UltracartClient::SfvbCommsTemplatesResponse.new(
|
|
16
|
+
notes: null,
|
|
17
|
+
templates: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTestEmailRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **cart_item_ids** | **Array<String>** | Items for a cart flow's email. The cart is built for the test. | [optional] |
|
|
8
|
+
| **email_uuid** | **String** | The email, which this step sends. For an experiment step, one variant's email. | [optional] |
|
|
9
|
+
| **order_id** | **String** | A test order to render an order flow's email with. A real customer's order is refused. | [optional] |
|
|
10
|
+
| **to_email** | **String** | The recipient, which must be the email address of a user on this account. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbCommsTestEmailRequest.new(
|
|
18
|
+
cart_item_ids: null,
|
|
19
|
+
email_uuid: null,
|
|
20
|
+
order_id: null,
|
|
21
|
+
to_email: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTestPostcardRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **address1** | **String** | The street address. | [optional] |
|
|
8
|
+
| **address2** | **String** | The second address line. | [optional] |
|
|
9
|
+
| **cart_item_ids** | **Array<String>** | Items for a cart flow's card. | [optional] |
|
|
10
|
+
| **city** | **String** | The city. | [optional] |
|
|
11
|
+
| **dry_run** | **Boolean** | Check everything, including that postcards are turned on, and show the cost, without mailing or using an approval. | [optional] |
|
|
12
|
+
| **mail_card** | **Boolean** | Must be true. Without it nothing is mailed; use the postcard proof to see the card. | [optional] |
|
|
13
|
+
| **name** | **String** | The recipient's name. | [optional] |
|
|
14
|
+
| **order_id** | **String** | A test order to render an order flow's card with. A real customer's order is refused. | [optional] |
|
|
15
|
+
| **postal_code** | **String** | The postal code. | [optional] |
|
|
16
|
+
| **state** | **String** | The state. | [optional] |
|
|
17
|
+
|
|
18
|
+
## Example
|
|
19
|
+
|
|
20
|
+
```ruby
|
|
21
|
+
require 'ultracart_api'
|
|
22
|
+
|
|
23
|
+
instance = UltracartClient::SfvbCommsTestPostcardRequest.new(
|
|
24
|
+
address1: null,
|
|
25
|
+
address2: null,
|
|
26
|
+
cart_item_ids: null,
|
|
27
|
+
city: null,
|
|
28
|
+
dry_run: null,
|
|
29
|
+
mail_card: null,
|
|
30
|
+
name: null,
|
|
31
|
+
order_id: null,
|
|
32
|
+
postal_code: null,
|
|
33
|
+
state: null
|
|
34
|
+
)
|
|
35
|
+
```
|
|
36
|
+
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTestSendResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **body** | **String** | For an SMS, the message as sent. | [optional] |
|
|
8
|
+
| **channel** | **String** | email, sms or postcard. | [optional] |
|
|
9
|
+
| **cost** | **Float** | For a postcard, what this card costs the account. | [optional] |
|
|
10
|
+
| **dry_run** | **Boolean** | True when nothing was sent. | [optional] |
|
|
11
|
+
| **notes** | **Array<String>** | What else happened, such as records created by the test. | [optional] |
|
|
12
|
+
| **recipient** | **String** | Who it went to, as a user on this account (their login), or the postcard's city and state. | [optional] |
|
|
13
|
+
| **sent** | **Boolean** | True when it was sent or mailed. False on a dry run or when it was skipped. | [optional] |
|
|
14
|
+
| **skipped_reason** | **String** | Why it wasn't sent or mailed, when it wasn't. | [optional] |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
```ruby
|
|
19
|
+
require 'ultracart_api'
|
|
20
|
+
|
|
21
|
+
instance = UltracartClient::SfvbCommsTestSendResponse.new(
|
|
22
|
+
body: null,
|
|
23
|
+
channel: null,
|
|
24
|
+
cost: null,
|
|
25
|
+
dry_run: null,
|
|
26
|
+
notes: null,
|
|
27
|
+
recipient: null,
|
|
28
|
+
sent: null,
|
|
29
|
+
skipped_reason: null
|
|
30
|
+
)
|
|
31
|
+
```
|
|
32
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsTestSmsRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **to_phone** | **String** | The recipient in E.164 form, such as +14045550100. It must be the cell phone of a user on this account. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbCommsTestSmsRequest.new(
|
|
15
|
+
to_phone: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsUnreferencedEmail
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **container_last_modified_dts** | **String** | When its body last changed. | [optional] |
|
|
8
|
+
| **email_uuid** | **String** | The email. | [optional] |
|
|
9
|
+
| **pending_review** | **Boolean** | True while a review is pending. | [optional] |
|
|
10
|
+
| **rejected** | **Boolean** | True when its last review was rejected. | [optional] |
|
|
11
|
+
| **requires_review** | **Boolean** | True when it needs a review before it can send. | [optional] |
|
|
12
|
+
| **subject** | **String** | Its subject. | [optional] |
|
|
13
|
+
| **version** | **Integer** | Its stored version. | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'ultracart_api'
|
|
19
|
+
|
|
20
|
+
instance = UltracartClient::SfvbCommsUnreferencedEmail.new(
|
|
21
|
+
container_last_modified_dts: null,
|
|
22
|
+
email_uuid: null,
|
|
23
|
+
pending_review: null,
|
|
24
|
+
rejected: null,
|
|
25
|
+
requires_review: null,
|
|
26
|
+
subject: null,
|
|
27
|
+
version: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsUnreferencedPostcard
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **back_container_uuid** | **String** | Its back container. | [optional] |
|
|
8
|
+
| **container_last_modified_dts** | **String** | When a side last changed. | [optional] |
|
|
9
|
+
| **front_container_uuid** | **String** | Its front container. | [optional] |
|
|
10
|
+
| **postcard_uuid** | **String** | The postcard. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbCommsUnreferencedPostcard.new(
|
|
18
|
+
back_container_uuid: null,
|
|
19
|
+
container_last_modified_dts: null,
|
|
20
|
+
front_container_uuid: null,
|
|
21
|
+
postcard_uuid: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsUnreferencedResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **email_count** | **Integer** | How many emails no step names. | [optional] |
|
|
8
|
+
| **emails** | [**Array<SfvbCommsUnreferencedEmail>**](SfvbCommsUnreferencedEmail.md) | Emails no step names, most recently changed first. | [optional] |
|
|
9
|
+
| **emails_checked** | **Integer** | How many emails the storefront has. | [optional] |
|
|
10
|
+
| **notes** | **Array<String>** | What the report means, in sentences. | [optional] |
|
|
11
|
+
| **postcard_count** | **Integer** | How many postcards no step names. | [optional] |
|
|
12
|
+
| **postcards** | [**Array<SfvbCommsUnreferencedPostcard>**](SfvbCommsUnreferencedPostcard.md) | Postcards no step names, most recently changed first. | [optional] |
|
|
13
|
+
| **postcards_checked** | **Integer** | How many postcards the storefront has. | [optional] |
|
|
14
|
+
| **sequences_checked** | **Integer** | How many sequences were read for the steps that name them. | [optional] |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
```ruby
|
|
19
|
+
require 'ultracart_api'
|
|
20
|
+
|
|
21
|
+
instance = UltracartClient::SfvbCommsUnreferencedResponse.new(
|
|
22
|
+
email_count: null,
|
|
23
|
+
emails: null,
|
|
24
|
+
emails_checked: null,
|
|
25
|
+
notes: null,
|
|
26
|
+
postcard_count: null,
|
|
27
|
+
postcards: null,
|
|
28
|
+
postcards_checked: null,
|
|
29
|
+
sequences_checked: null
|
|
30
|
+
)
|
|
31
|
+
```
|
|
32
|
+
|
data/docs/SfvbEmail.md
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
| Name | Type | Description | Notes |
|
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
|
7
7
|
| **container_last_modified_dts** | **String** | When the email container was last changed (ISO 8601, UTC). | [optional] |
|
|
8
|
+
| **email_template_vm_path** | **String** | The Velocity template the email body renders inside, as stored, such as templates/template_email.vm. It is looked up in the storefront's active theme. | [optional] |
|
|
8
9
|
| **email_uuid** | **String** | The email uuid. The same uuid the email container (owner type email) and the email render take. | [optional] |
|
|
9
10
|
| **hash_sha256** | **String** | Hash of the subject and preview text. Send it as If-Match when updating. A change to the email body does not change it. | [optional] |
|
|
10
11
|
| **live** | **Boolean** | True when the email is in a flow or campaign that is sending, so a change reaches customers and needs sfvb_publish. An email in neither is reported live. | [optional] |
|
|
@@ -15,6 +16,9 @@
|
|
|
15
16
|
| **requires_review** | **Boolean** | True when a change to this email must be reviewed before it sends. | [optional] |
|
|
16
17
|
| **subject** | **String** | The subject line. Merge tokens such as firstName are filled in at send. | [optional] |
|
|
17
18
|
| **suspended_for_spam** | **Boolean** | True when UltraCart suspended the email for spam. Edits are refused until the merchant resolves it with UltraCart support. | [optional] |
|
|
19
|
+
| **template_exists** | **Boolean** | True when the file at template_path exists. False means the email can't render. | [optional] |
|
|
20
|
+
| **template_note** | **String** | Why there is no template file, or null when there is one. | [optional] |
|
|
21
|
+
| **template_path** | **String** | The theme file that template is, as the render finds it. Read it with the files endpoints, whose read also reports valid and velocity_errors. Null when it couldn't be worked out, with template_note saying why. | [optional] |
|
|
18
22
|
| **transactional** | **Boolean** | True for a transactional email, which skips the marketing footer rules. | [optional] |
|
|
19
23
|
| **version** | **Integer** | The email version. Every save adds one. | [optional] |
|
|
20
24
|
|
|
@@ -25,6 +29,7 @@ require 'ultracart_api'
|
|
|
25
29
|
|
|
26
30
|
instance = UltracartClient::SfvbEmail.new(
|
|
27
31
|
container_last_modified_dts: null,
|
|
32
|
+
email_template_vm_path: null,
|
|
28
33
|
email_uuid: null,
|
|
29
34
|
hash_sha256: null,
|
|
30
35
|
live: null,
|
|
@@ -35,6 +40,9 @@ instance = UltracartClient::SfvbEmail.new(
|
|
|
35
40
|
requires_review: null,
|
|
36
41
|
subject: null,
|
|
37
42
|
suspended_for_spam: null,
|
|
43
|
+
template_exists: null,
|
|
44
|
+
template_note: null,
|
|
45
|
+
template_path: null,
|
|
38
46
|
transactional: null,
|
|
39
47
|
version: null
|
|
40
48
|
)
|
data/docs/SfvbFlow.md
CHANGED
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
| **end_once_customer_purchases** | **Boolean** | True when a customer leaves the flow once they buy from one of its emails. | [optional] |
|
|
13
13
|
| **end_once_customer_purchases_anywhere** | **Boolean** | True when a customer leaves the flow once they buy from any source. | [optional] |
|
|
14
14
|
| **flow_uuid** | **String** | The flow uuid. | [optional] |
|
|
15
|
+
| **folder_name** | **String** | That folder's name. | [optional] |
|
|
16
|
+
| **folder_uuid** | **String** | The flow folder it is filed in, or none. | [optional] |
|
|
15
17
|
| **hash_sha256** | **String** | Send this as If-Match when changing, archiving or turning the flow on or off. | [optional] |
|
|
16
18
|
| **live** | **Boolean** | True when the emails and postcards reach customers now, so a change to one shows at once. False only in a status that sends nothing. | [optional] |
|
|
17
19
|
| **name** | **String** | The flow name. | [optional] |
|
|
@@ -43,6 +45,8 @@ instance = UltracartClient::SfvbFlow.new(
|
|
|
43
45
|
end_once_customer_purchases: null,
|
|
44
46
|
end_once_customer_purchases_anywhere: null,
|
|
45
47
|
flow_uuid: null,
|
|
48
|
+
folder_name: null,
|
|
49
|
+
folder_uuid: null,
|
|
46
50
|
hash_sha256: null,
|
|
47
51
|
live: null,
|
|
48
52
|
name: null,
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbFlowBackfillRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **dry_run** | **Boolean** | Count who would be enrolled and enroll nobody. | [optional] |
|
|
8
|
+
| **flow_uuid** | **String** | The flow. Used by a flow.backfill approval request. The backfill call takes it from the path. | [optional] |
|
|
9
|
+
| **order_days_old** | **Integer** | For an order trigger, how many days of orders to enroll, 1 to 90 (default 5). | [optional] |
|
|
10
|
+
| **relative_to_event** | **Boolean** | For an order trigger, shorten the flow's first wait by each order's age. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbFlowBackfillRequest.new(
|
|
18
|
+
dry_run: null,
|
|
19
|
+
flow_uuid: null,
|
|
20
|
+
order_days_old: null,
|
|
21
|
+
relative_to_event: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# UltracartClient::SfvbFlowBackfillResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **capped** | **Boolean** | True when the plan's customer limit stopped the count. | [optional] |
|
|
8
|
+
| **customers** | **Integer** | How many different customers those are. | [optional] |
|
|
9
|
+
| **dry_run** | **Boolean** | True when nothing was enrolled. | [optional] |
|
|
10
|
+
| **enrollments** | **Integer** | How many enrollments the backfill makes (a purchased product trigger makes one per item). | [optional] |
|
|
11
|
+
| **flow_uuid** | **String** | The flow. | [optional] |
|
|
12
|
+
| **notes** | **Array<String>** | What happens next, in sentences. | [optional] |
|
|
13
|
+
| **order_days_old** | **Integer** | The days of orders, for an order trigger. | [optional] |
|
|
14
|
+
| **relative_to_event** | **Boolean** | Whether the first wait is shortened by each order's age. | [optional] |
|
|
15
|
+
| **segment_rebuild_required** | **Boolean** | True when the segment needs a rebuild, so the count is from its last one. | [optional] |
|
|
16
|
+
| **started** | **Boolean** | True when the backfill started in the background. The signed-in user is emailed when it ends. | [optional] |
|
|
17
|
+
| **trigger_type** | **String** | The flow's trigger. | [optional] |
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```ruby
|
|
22
|
+
require 'ultracart_api'
|
|
23
|
+
|
|
24
|
+
instance = UltracartClient::SfvbFlowBackfillResponse.new(
|
|
25
|
+
capped: null,
|
|
26
|
+
customers: null,
|
|
27
|
+
dry_run: null,
|
|
28
|
+
enrollments: null,
|
|
29
|
+
flow_uuid: null,
|
|
30
|
+
notes: null,
|
|
31
|
+
order_days_old: null,
|
|
32
|
+
relative_to_event: null,
|
|
33
|
+
segment_rebuild_required: null,
|
|
34
|
+
started: null,
|
|
35
|
+
trigger_type: null
|
|
36
|
+
)
|
|
37
|
+
```
|
|
38
|
+
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
| **allow_multiple_concurrent_enrollments** | **Boolean** | True when a customer may be in this flow more than once at a time. | [optional] |
|
|
8
8
|
| **end_once_customer_purchases** | **Boolean** | True to end the flow for a customer once they buy from one of its emails. | [optional] |
|
|
9
9
|
| **end_once_customer_purchases_anywhere** | **Boolean** | True to end the flow for a customer once they buy from any source. | [optional] |
|
|
10
|
+
| **folder_uuid** | **String** | File it in this flow folder. An empty value takes it out of its folder. | [optional] |
|
|
10
11
|
| **name** | **String** | The flow name, 1 to 250 characters. Required to create. | [optional] |
|
|
11
12
|
| **reentry_delay_days** | **Integer** | Days before a customer may enter again, 1 to 1095. Only with after_days. | [optional] |
|
|
12
13
|
| **reentry_policy** | **String** | Whether a customer may enter again, anytime, after_days or never. | [optional] |
|
|
@@ -25,6 +26,7 @@ instance = UltracartClient::SfvbFlowWriteRequest.new(
|
|
|
25
26
|
allow_multiple_concurrent_enrollments: null,
|
|
26
27
|
end_once_customer_purchases: null,
|
|
27
28
|
end_once_customer_purchases_anywhere: null,
|
|
29
|
+
folder_uuid: null,
|
|
28
30
|
name: null,
|
|
29
31
|
reentry_delay_days: null,
|
|
30
32
|
reentry_policy: null,
|
data/docs/SfvbStepCounts.md
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
| **opened** | **Integer** | Emails opened. | [optional] |
|
|
11
11
|
| **sent** | **Integer** | Messages sent. | [optional] |
|
|
12
12
|
| **skipped** | **Integer** | Customers who reached the step and were not sent anything. The dispatch log says why. | [optional] |
|
|
13
|
-
| **source** | **String** | email (the step's email, all time), sequence (the begin step, customers who started the sequence, all time) or step (
|
|
13
|
+
| **source** | **String** | email (the step's email, all time), sequence (the begin step, customers who started the sequence, all time), resend (a Resend Email step, what it resent, the last 90 days), experiment (an experiment step, its variants together, the last 90 days), sms or postcard (the step's own sends, the last 90 days), step (the end step or a condition, split or InboxGeek step, the last 90 days) or not_recorded (a step type the send path keeps no counts for, such as a wait; no counts are given). | [optional] |
|
|
14
14
|
| **spam** | **Integer** | Spam complaints. | [optional] |
|
|
15
15
|
| **unsubscribed** | **Integer** | Unsubscribes from these messages. | [optional] |
|
|
16
16
|
|