Merging dev to main for v1.43.0

.github/workflows/generate.yml → .github/workflows/go-checks.yml

@@ -1,12 +1,11 @@
-name: Ensure Documentation in Sync
+name: Go Checks
 on:
   push:
     paths-ignore:
       - 'README.md'
 jobs:
-  # ensure the documentation is up to date
-  generate:
-    name: Generate
+  go-checks:
+    name: Go Checks
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
@@ -35,5 +34,20 @@ jobs:
           if [[ -n $(git status -s) ]]; then
               echo "There are untracked documentation changes:\n"
               git status
+          fi
+
+      - name: Tidy
+        run: |
+          go mod tidy
+          if [[ -n $(git status -s) ]]; then
+              echo "go mod tidy produced changes:\n"
+              git status
+          fi
+
+      - name: Vet
+        run: |
+          if [[ -n $(go vet ./genesyscloud/... 2>&1) ]]; then
+              echo "go vet highlighted the following:\n"
+              go vet ./genesyscloud/...
               exit 1
           fi

docs/data-sources/conversations_messaging_settings.md

@@ -0,0 +1,30 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "genesyscloud_conversations_messaging_settings Data Source - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Genesys Cloud conversations messaging settings data source. Select an conversations messaging settings by name
+---
+
+# genesyscloud_conversations_messaging_settings (Data Source)
+
+Genesys Cloud conversations messaging settings data source. Select an conversations messaging settings by name
+
+## Example Usage
+
+```terraform
+data "genesyscloud_conversations_messaging_settings" "example-messaging-settings" {
+  name = "settings name"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) conversations messaging settings name
+
+### Read-Only
+
+- `id` (String) The ID of this resource.

docs/data-sources/outbound_contact_list_template.md

@@ -0,0 +1,30 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "genesyscloud_outbound_contact_list_template Data Source - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Data source for Genesys Cloud Outbound Contact Lists Templates. Select a contact list template by name.
+---
+
+# genesyscloud_outbound_contact_list_template (Data Source)
+
+Data source for Genesys Cloud Outbound Contact Lists Templates. Select a contact list template by name.
+
+## Example Usage
+
+```terraform
+data "genesyscloud_outbound_contact_list_template" "contact_list_template" {
+  name = "Example Contact List Template"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) Contact List Template name.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.

docs/data-sources/telephony_providers_edges_site.md

@@ -25,10 +25,6 @@ data "genesyscloud_telephony_providers_edges_site" "site" {
 
 - `name` (String) Site name.
 
-### Optional
-
-- `managed` (Boolean) Return entities that are managed by Genesys Cloud. Defaults to `false`.
-
 ### Read-Only
 
 - `id` (String) The ID of this resource.

docs/resources/conversations_messaging_settings.md

@@ -0,0 +1,116 @@
+---
+page_title: "genesyscloud_conversations_messaging_settings Resource - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Genesys Cloud conversations messaging settings
+---
+# genesyscloud_conversations_messaging_settings (Resource)
+
+Genesys Cloud conversations messaging settings
+
+## API Usage
+The following Genesys Cloud APIs are used by this resource. Ensure your OAuth Client has been granted the necessary scopes and permissions to perform these operations:
+
+* [GET /api/v2/conversations/messaging/settings](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-messaging-settings)
+* [POST /api/v2/conversations/messaging/settings](https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-conversations-messaging-settings)
+* [GET /api/v2/conversations/messaging/settings/{messageSettingId}](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-messaging-settings--messageSettingId-)
+* [PATCH /api/v2/conversations/messaging/settings/{messageSettingId}](https://developer.genesys.cloud/devapps/api-explorer#patch-api-v2-conversations-messaging-settings--messageSettingId-)
+* [DELETE /api/v2/conversations/messaging/settings/{messageSettingId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-conversations-messaging-settings--messageSettingId-)
+
+## Example Usage
+
+```terraform
+resource "genesyscloud_conversations_messaging_settings" "example-messaging-settings" {
+  name = "Sample Messaging Settings"
+  content {
+    story {
+      mention {
+        inbound = "Enabled"
+      }
+      reply {
+        inbound = "Enabled"
+      }
+    }
+  }
+  event {
+    typing {
+      on {
+        inbound  = "Enabled"
+        outbound = "Enabled"
+      }
+    }
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) The messaging Setting profile name
+
+### Optional
+
+- `content` (Block List, Max: 1) Settings relating to message contents (see [below for nested schema](#nestedblock--content))
+- `event` (Block List, Max: 1) Settings relating to events which may occur (see [below for nested schema](#nestedblock--event))
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--content"></a>
+### Nested Schema for `content`
+
+Optional:
+
+- `story` (Block List, Max: 1) Settings relating to facebook and instagram stories feature (see [below for nested schema](#nestedblock--content--story))
+
+<a id="nestedblock--content--story"></a>
+### Nested Schema for `content.story`
+
+Optional:
+
+- `mention` (Block List, Max: 1) Setting relating to Story Mentions (see [below for nested schema](#nestedblock--content--story--mention))
+- `reply` (Block List, Max: 1) Setting relating to Story Replies (see [below for nested schema](#nestedblock--content--story--reply))
+
+<a id="nestedblock--content--story--mention"></a>
+### Nested Schema for `content.story.mention`
+
+Optional:
+
+- `inbound` (String) Valid values: Enabled, Disabled.
+
+
+<a id="nestedblock--content--story--reply"></a>
+### Nested Schema for `content.story.reply`
+
+Optional:
+
+- `inbound` (String) Valid values: Enabled, Disabled.
+
+
+
+
+<a id="nestedblock--event"></a>
+### Nested Schema for `event`
+
+Optional:
+
+- `typing` (Block List, Max: 1) Settings regarding typing events (see [below for nested schema](#nestedblock--event--typing))
+
+<a id="nestedblock--event--typing"></a>
+### Nested Schema for `event.typing`
+
+Optional:
+
+- `on` (Block List, Max: 1) Should typing indication Events be sent (see [below for nested schema](#nestedblock--event--typing--on))
+
+<a id="nestedblock--event--typing--on"></a>
+### Nested Schema for `event.typing.on`
+
+Optional:
+
+- `inbound` (String) Status for the Inbound Direction. Valid values: Enabled, Disabled.
+- `outbound` (String) Status for the outbound Direction. Valid values: Enabled, Disabled.
+

docs/resources/journey_action_map.md

@@ -54,7 +54,8 @@ resource "genesyscloud_journey_action_map" "example_journey_action_map" {
 - `is_active` (Boolean) Whether the action map is active. Defaults to `true`.
 - `page_url_conditions` (Block Set) URL conditions that a page must match for web actions to be displayable. (see [below for nested schema](#nestedblock--page_url_conditions))
 - `trigger_with_event_conditions` (Block Set) List of event conditions that must be satisfied to trigger the action map. (see [below for nested schema](#nestedblock--trigger_with_event_conditions))
-- `trigger_with_outcome_probability_conditions` (Block Set) Probability conditions for outcomes that must be satisfied to trigger the action map. (see [below for nested schema](#nestedblock--trigger_with_outcome_probability_conditions))
+- `trigger_with_outcome_probability_conditions` (Block Set, Deprecated) Probability conditions for outcomes that must be satisfied to trigger the action map. (see [below for nested schema](#nestedblock--trigger_with_outcome_probability_conditions))
+- `trigger_with_outcome_quantile_conditions` (Block Set) Quantile conditions for outcomes that must be satisfied to trigger the action map. (see [below for nested schema](#nestedblock--trigger_with_outcome_quantile_conditions))
 - `trigger_with_segments` (Set of String) Trigger action map if any segment in the list is assigned to a given customer.
 - `weight` (Number) Weight of the action map with higher number denoting higher weight. Low=1, Medium=2, High=3. Defaults to `2`.
 
@@ -192,3 +193,16 @@ Optional:
 
 - `probability` (Number) Additional probability condition, where if set, the action map will trigger if the current outcome probability is lower or equal to the value.
 
+
+<a id="nestedblock--trigger_with_outcome_quantile_conditions"></a>
+### Nested Schema for `trigger_with_outcome_quantile_conditions`
+
+Required:
+
+- `max_quantile_threshold` (Number) This Outcome Quantile Condition is met when sessionMaxQuantile of the OutcomeScore is above this value, (unless fallbackQuantile is set). Range 0.00-1.00
+- `outcome_id` (String) The outcome ID.
+
+Optional:
+
+- `fallback_quantile_threshold` (Number) If set, this Condition is met when max_quantile_threshold is met, AND the current quantile of the OutcomeScore is below this fallback_quantile_threshold. Range 0.00-1.00
+

docs/resources/outbound_contact_list_template.md

@@ -0,0 +1,101 @@
+---
+page_title: "genesyscloud_outbound_contact_list_template Resource - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Genesys Cloud Outbound Contact List Template
+---
+# genesyscloud_outbound_contact_list_template (Resource)
+
+Genesys Cloud Outbound Contact List Template
+
+## API Usage
+The following Genesys Cloud APIs are used by this resource. Ensure your OAuth Client has been granted the necessary scopes and permissions to perform these operations:
+
+- [GET /api/v2/outbound/contactlisttemplates](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-outbound-contactlisttemplates)
+- [POST /api/v2/outbound/contactlisttemplates](https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-outbound-contactlisttemplates)
+- [GET /api/v2/outbound/contactlisttemplates/{contactListTemplateId}](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-outbound-contactlisttemplates--contactListTemplateId-)
+- [PUT /api/v2/outbound/contactlisttemplates/{contactListTemplateId}](https://developer.genesys.cloud/devapps/api-explorer#put-api-v2-outbound-contactlisttemplates--contactListTemplateId-)
+- [DELETE /api/v2/outbound/contactlisttemplates/{contactListTemplateId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-outbound-contactlisttemplates--contactListTemplateId-)
+
+
+## Example Usage
+
+```terraform
+resource "genesyscloud_outbound_contact_list_template" "contact-list-template" {
+  name             = "Example Contact List Template"
+  column_names     = ["First Name", "Last Name", "Cell", "Home"]
+  attempt_limit_id = genesyscloud_outbound_attempt_limit.attempt-limit.id
+  phone_columns {
+    column_name = "Cell"
+    type        = "cell"
+  }
+  phone_columns {
+    column_name = "Home"
+    type        = "home"
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `column_names` (List of String) The names of the contact template data columns. Changing the column_names attribute will cause the outbound_contact_list_template object to be dropped and recreated with a new ID
+- `name` (String) The name for the contact list template.
+
+### Optional
+
+- `attempt_limit_id` (String) Attempt Limit for this Contact List Template.
+- `automatic_time_zone_mapping` (Boolean) Indicates if automatic time zone mapping is to be used for this Contact List Template. Changing the automatic_time_zone_mappings attribute will cause the outbound_contact_list_template object to be dropped and recreated with a new ID
+- `column_data_type_specifications` (Block List) The settings of the columns selected for dynamic queueing. If updated, the contact list template is dropped and recreated with a new ID (see [below for nested schema](#nestedblock--column_data_type_specifications))
+- `email_columns` (Block Set) Indicates which columns are email addresses. Changing the email_columns attribute will cause the outbound_contact_list_template object to be dropped and recreated with a new ID. Required if phone_columns is empty (see [below for nested schema](#nestedblock--email_columns))
+- `phone_columns` (Block Set) Indicates which columns are phone numbers. Changing the phone_columns attribute will cause the outbound_contact_list_template object to be dropped and recreated with a new ID. Required if email_columns is empty (see [below for nested schema](#nestedblock--phone_columns))
+- `preview_mode_accepted_values` (List of String) The values in the preview_mode_column_name column that indicate a contact should always be dialed in preview mode.
+- `preview_mode_column_name` (String) A column to check if a contact should always be dialed in preview mode.
+- `zip_code_column_name` (String) The name of contact list column containing the zip code for use with automatic time zone mapping. Only allowed if 'automatic_time_zone_mapping' is set to true. Changing the zip_code_column_name attribute will cause the outbound_contact_list_template object to be dropped and recreated with a new ID
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--column_data_type_specifications"></a>
+### Nested Schema for `column_data_type_specifications`
+
+Required:
+
+- `column_name` (String) The column name of a column selected for dynamic queueing.
+- `max_length` (Number) The maximum length of the text column selected for dynamic queueing.
+
+Optional:
+
+- `column_data_type` (String) The data type of the column selected for dynamic queueing (TEXT, NUMERIC or TIMESTAMP)
+- `max` (Number) The maximum length of the numeric column selected for dynamic queueing.
+- `min` (Number) The minimum length of the numeric column selected for dynamic queueing.
+
+
+<a id="nestedblock--email_columns"></a>
+### Nested Schema for `email_columns`
+
+Required:
+
+- `column_name` (String) The name of the email column.
+- `type` (String) Indicates the type of the email column. For example, 'work' or 'personal'.
+
+Optional:
+
+- `contactable_time_column` (String) A column that indicates the timezone to use for a given contact when checking contactable times.
+
+
+<a id="nestedblock--phone_columns"></a>
+### Nested Schema for `phone_columns`
+
+Required:
+
+- `column_name` (String) The name of the phone column.
+- `type` (String) Indicates the type of the phone column. For example, 'cell' or 'home'.
+
+Optional:
+
+- `callable_time_column` (String) A column that indicates the timezone to use for a given contact when checking callable times. Not allowed if 'automaticTimeZoneMapping' is set to true.
+

docs/resources/outbound_contactlistfilter.md

@@ -42,12 +42,13 @@ resource "genesyscloud_outbound_contactlistfilter" "contact_list_filter" {
 
 ### Required
 
-- `contact_list_id` (String) The contact list the filter is based on.
 - `name` (String) The name of the list.
 
 ### Optional
 
 - `clauses` (Block List) Groups of conditions to filter the contacts by. (see [below for nested schema](#nestedblock--clauses))
+- `contact_list_id` (String) The contact list the filter is based on. Mutually exclusive to 'contact_list_template_id', however, one of the two must be specified
+- `contact_list_template_id` (String) The contact list template the filter is based on. Mutually exclusive to 'contact_list_id', however, one of the two must be specified.
 - `filter_type` (String) How to join clauses together.
 
 ### Read-Only

docs/resources/routing_queue_conditional_group_routing.md

@@ -28,8 +28,8 @@ resource "genesyscloud_routing_queue_conditional_group_routing" "example-name" {
     condition_value = 0
     wait_seconds    = 20
     groups {
-      member_group_id   = ""
-      member_group_type = ""
+      member_group_id   = genesyscloud_group.example-group.id
+      member_group_type = "GROUP"
     }
   }
   rules {
@@ -39,8 +39,8 @@ resource "genesyscloud_routing_queue_conditional_group_routing" "example-name" {
     condition_value    = 5
     wait_seconds       = 15
     groups {
-      member_group_id   = ""
-      member_group_type = ""
+      member_group_id   = genesyscloud_group.another-group.id
+      member_group_type = "GROUP"
     }
   }
 }