Feature/devtooling-1019 Bulk Contact Management within the Contact Lists resource

docs/resources/outbound_contact_list.md

@@ -40,23 +40,28 @@ resource "genesyscloud_outbound_contact_list" "contact-list" {
 
 ### Required
 
-- `column_names` (List of String) The names of the contact data columns. Changing the column_names attribute will cause the outboundcontact_list object to be dropped and recreated with a new ID
+- `column_names` (List of String) The names of the contact data columns. Changing the column_names attribute will cause the outbound_contact_list object to be dropped and recreated with a new ID
 - `name` (String) The name for the contact list.
 
 ### Optional
 
 - `attempt_limit_id` (String) Attempt Limit for this ContactList.
 - `automatic_time_zone_mapping` (Boolean) Indicates if automatic time zone mapping is to be used for this ContactList. Changing the automatic_time_zone_mappings attribute will cause the outboundcontact_list 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 is dropped and recreated with a new ID (see [below for nested schema](#nestedblock--column_data_type_specifications))
+- `contacts_filepath` (String) The path to a CSV file containing contacts to import into the contact list. When updated, existing contacts will be removed and replaced with contacts from the new file. If not specified, an empty contact list will be created.
+- `contacts_id_name` (String) The name of the column in the CSV file that contains the contact's unique contact id. If updated, the contact list is dropped and recreated with a new ID
 - `division_id` (String) The division this entity belongs to.
-- `email_columns` (Block Set) Indicates which columns are email addresses. Changing the email_columns attribute will cause the outboundcontact_list 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 outboundcontact_list object to be dropped and recreated with a new ID. Required if email_columns is empty (see [below for nested schema](#nestedblock--phone_columns))
+- `email_columns` (Block Set) Indicates which columns are email addresses. Changing the email_columns attribute will cause the outbound_contact_list 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 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 previewModeColumnName 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.
+- `trim_whitespace` (Boolean) Indicates if leading and trailing whitespace will be trimmed when importing a contactlist CSV file
 - `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 'automaticTimeZoneMapping' is set to true. Changing the zip_code_column_name attribute will cause the outboundcontact_list object to be dropped and recreated with a new ID
 
 ### Read-Only
 
+- `contacts_file_content_hash` (String) The hash of the contacts file to import. This is retained as a computed value in the state in order to detect when a file's contents have changed.
+- `contacts_record_count` (Number) The number of contacts in the contact list. This is a read-only attribute and sanity check
 - `id` (String) The ID of this resource.
 
 <a id="nestedblock--column_data_type_specifications"></a>

docs/resources/outbound_contact_list_contact.md

@@ -1,12 +1,12 @@
 ---
 page_title: "genesyscloud_outbound_contact_list_contact Resource - terraform-provider-genesyscloud"
-subcategory: ""
+subcategory: "Deprecated"
 description: |-
-  Genesys Cloud Outbound Contact List Contact
+  [DEPRECATED] Genesys Cloud Outbound Contact List Contact
 ---
 # genesyscloud_outbound_contact_list_contact (Resource)
 
-Genesys Cloud Outbound Contact List Contact
+[DEPRECATED] Genesys Cloud Outbound Contact List Contact
 
 ## 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:
@@ -16,6 +16,34 @@ The following Genesys Cloud APIs are used by this resource. Ensure your OAuth Cl
 - [PUT /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#put-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
 - [DELETE /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
 
+## Migrating from genesyscloud_outbound_contact_list_contact
+
+### Deprecation Notice
+
+The `genesyscloud_outbound_contact_list_contact` resource is deprecated and will be removed in a future version. Instead, use the `contacts_filepath` and `contacts_id_name` attributes in the `genesyscloud_outbound_contact_list` resource.
+
+### Note About Exporter
+
+The exporter functionality has been removed from this resource in favor of the `genesyscloud_outbound_contact_list` resource's built-in bulk handling of contacts via CSV exports. Contacts will now be exported within the CSV file output from the `genesyscloud_outbound_contact_list` and not be exported via this resource due to performance and scalability limitations with this resource.
+
+### Migration Steps
+
+1. Remove any `genesyscloud_outbound_contact_list_contact` resources from your Terraform configuration and add them to a `contacts.csv` file
+2. Update your `genesyscloud_outbound_contact_list` resource to include:
+
+   ```hcl
+   resource "genesyscloud_outbound_contact_list" "example" {
+     name = "Example Contact List"
+     # ... other existing configuration ...
+
+     contacts_filepath = "path/to/your/contacts.csv"
+     contacts_id_name = "contact_id_column"
+   }
+   ```
+3. Ensure your CSV file contains all required columns defined in `column_names`
+4. Run `terraform plan` to verify the changes
+
+
 ## Example Usage
 
 ```terraform

docs/resources/widget_deployment.md

@@ -1,12 +1,12 @@
 ---
 page_title: "genesyscloud_widget_deployment Resource - terraform-provider-genesyscloud"
-subcategory: ""
+subcategory: "Deprecated"
 description: |-
-  Genesys Cloud Widget Deployment
+  [DEPRECATED] Genesys Cloud Widget Deployment
 ---
 # genesyscloud_widget_deployment (Resource)
 
-Genesys Cloud Widget Deployment
+[DEPRECATED] Genesys Cloud Widget Deployment
 
 ## 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:
@@ -17,6 +17,17 @@ The following Genesys Cloud APIs are used by this resource. Ensure your OAuth Cl
 * [PUT /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#put-api-v2-widgets-deployments--deploymentId-)
 * [DELETE /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#delete-api-v2-widgets-deployments--deploymentId-)
 
+## Migrating from genesyscloud_widget_deployment
+
+### Deprecation Notice
+
+The `genesyscloud_widget_deployment` resource is deprecated and will be removed in a future version due to this functionality being sunset in Genesys Cloud API.
+
+### Migration Steps
+
+1. Remove any `genesyscloud_widget_deployment` resources from your Terraform configuration.
+
+
 ## Example Usage
 
 ```terraform

examples/resources/genesyscloud_outbound_contact_list_contact/apis.md

@@ -1,4 +1,31 @@
 - [POST /api/v2/outbound/contactlists/{contactListId}/contacts](https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-outbound-contactlists--contactListId--contacts)
 - [GET /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
 - [PUT /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#put-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
-- [DELETE /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
+- [DELETE /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-outbound-contactlists--contactListId--contacts--contactId-)
+
+## Migrating from genesyscloud_outbound_contact_list_contact
+
+### Deprecation Notice
+
+The `genesyscloud_outbound_contact_list_contact` resource is deprecated and will be removed in a future version. Instead, use the `contacts_filepath` and `contacts_id_name` attributes in the `genesyscloud_outbound_contact_list` resource.
+
+### Note About Exporter
+
+The exporter functionality has been removed from this resource in favor of the `genesyscloud_outbound_contact_list` resource's built-in bulk handling of contacts via CSV exports. Contacts will now be exported within the CSV file output from the `genesyscloud_outbound_contact_list` and not be exported via this resource due to performance and scalability limitations with this resource.
+
+### Migration Steps
+
+1. Remove any `genesyscloud_outbound_contact_list_contact` resources from your Terraform configuration and add them to a `contacts.csv` file
+2. Update your `genesyscloud_outbound_contact_list` resource to include:
+
+   ```hcl
+   resource "genesyscloud_outbound_contact_list" "example" {
+     name = "Example Contact List"
+     # ... other existing configuration ...
+
+     contacts_filepath = "path/to/your/contacts.csv"
+     contacts_id_name = "contact_id_column"
+   }
+   ```
+3. Ensure your CSV file contains all required columns defined in `column_names`
+4. Run `terraform plan` to verify the changes

examples/resources/genesyscloud_widget_deployment/apis.md

@@ -2,4 +2,14 @@
 * [GET /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#get-api-v2-widgets-deployments--deploymentId-)
 * [POST /api/v2/widgets/deployments](https://developer.genesys.cloud/api/rest/v2/widgets/#post-api-v2-widgets-deployments)
 * [PUT /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#put-api-v2-widgets-deployments--deploymentId-)
-* [DELETE /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#delete-api-v2-widgets-deployments--deploymentId-)
+* [DELETE /api/v2/widgets/deployments/{deploymentId}](https://developer.genesys.cloud/api/rest/v2/widgets/#delete-api-v2-widgets-deployments--deploymentId-)
+
+## Migrating from genesyscloud_widget_deployment
+
+### Deprecation Notice
+
+The `genesyscloud_widget_deployment` resource is deprecated and will be removed in a future version due to this functionality being sunset in Genesys Cloud API.
+
+### Migration Steps
+
+1. Remove any `genesyscloud_widget_deployment` resources from your Terraform configuration.

genesyscloud/architect_grammar_language/resource_genesyscloud_architect_grammar_language_utils.go

@@ -177,7 +177,7 @@ func (d *grammarLanguageDownloader) downloadFileData(fileType FileType) error {
 func (d *grammarLanguageDownloader) downloadLanguageFileAndUpdateConfigMap(url string) error {
 	d.fileUrl = url
 	d.setExportFileName()
-	if err := files.DownloadExportFile(d.exportFilesFolderPath, d.exportFileName, d.fileUrl); err != nil {
+	if _, err := files.DownloadExportFile(d.exportFilesFolderPath, d.exportFileName, d.fileUrl); err != nil {
 		return err
 	}
 	d.updatePathsInExportConfigMap()

genesyscloud/architect_user_prompt/resource_genesyscloud_architect_user_prompt_utils.go

@@ -199,7 +199,7 @@ func ArchitectPromptAudioResolver(promptId, exportDirectory, subDirectory string
 
 	for _, data := range audioDataList {
 		log.Printf("Downloading file '%s' from mediaUri", path.Join(fullPath, data.FileName))
-		if err := files.DownloadExportFile(fullPath, data.FileName, data.MediaUri); err != nil {
+		if _, err := files.DownloadExportFile(fullPath, data.FileName, data.MediaUri); err != nil {
 			return err
 		}
 		log.Println("Successfully downloaded file")

genesyscloud/outbound_contact_list/data_source_genesyscloud_outbound_contact_list.go

@@ -15,7 +15,7 @@ import (
 
 func dataSourceOutboundContactListRead(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	sdkConfig := m.(*provider.ProviderMeta).ClientConfig
-	proxy := getOutboundContactlistProxy(sdkConfig)
+	proxy := GetOutboundContactlistProxy(sdkConfig)
 	name := d.Get("name").(string)
 
 	return util.WithRetries(ctx, 15*time.Second, func() *retry.RetryError {