Add Changes to Main (#2046)

-Fix Test case issues
-Added endpoint check to Apple Integration Tests
-Enable guide tests
-Increasing retry timeout by 2 mins after division deletion
-Fix conv message settings
-Fix quality forms survey language validation
-Export resource by ID
-Routing Queue Test Fix and Go Checks fix
-Added timeAndDateCondition to outbound_ruleset
-Add retries to publish DT call due to 409
-Routing Queue Test Fix and Go Checks fix
-Consistency check timeout fix for updating quality forms survey

Author: HemanthDogiparthi12

.amazonq/rules/new-resource.md

@@ -0,0 +1,12 @@
+## Adding A New Resource Type
+
+1. Create new package inside `genesyscloud` with the following files. The package name should match the name of the resource (minus, the genesyscloud\_ prefix).
+   - `resource_genesyscloud_{resource_name}_schema.go` - The file containing the schema definition for the resource, data source, and exporter. It also contains a constant variable which defines the resource name, and a public function called `SetRegistrar`, which will be called from outside the package to register the resource with the provider. The schema should closely match Public API schemas, but there are some Terraform schema limitations that may require some deviation from the API.
+   - `resource_genesyscloud_{resource_name}.go` - Contains the create, read, update and delete functions for the resource (the methods for the resource's `CreateContext`, `ReadContext`, `UpdateContext`, and `DeleteContext` attributes.) It also contains the getAll function to be used by the exporter. If you have a few helper functions present in this file, that is fine, but if there are more than 1-2 helper functions you should create a `resource_genesyscloud_{resource_name}_utils.go` to contain the business logic.
+   - `resource_genesyscloud_{resource_name}_test.go` - Contains the resource tests. Write acceptance test cases that cover all of the attributes and CRUD operations for the resource. Acceptance tests modify real resources in a test org and require an OAuth Client authorized to create, update, and delete the resource type in the org. See existing tests for examples and [Terraform Acceptance Test documentation](https://www.terraform.io/docs/extend/testing/acceptance-tests/index.html) for more details. Unit tests are also encouraged where applicable (for helper functions etc.)
+   - `data_source_genesyscloud_{resource_name}.go` - This file contains all of the data source logic for a resource. The data source should call any Genesys Cloud APIs through its API proxy class. All functions and variables in this class should be private.
+   - `data_source_genesyscloud_{resource_name}_test.go` - Contains the data source tests.
+   - `genesyscloud_{resource_name}_proxy.go` - This contains all of the API logic for interacting with the Genesys Cloud APIs. This is meant to be an isolated layer from Terraform, so know Terraform objects should be passed back and forth to this code. All functions and variables in this class should be private.
+   - `genesyscloud_{resource_name}_init_test.go` - This file contains all of the logic needed to initialize a test case for your resource. All functions and variables in this class should be private.
+2. Add a new folder for the resource and data source under the `/examples` folder. An example `resource.tf` file for the resource should be added to the folder along with an `apis.md` file listing all of the APIs the resource uses. To generate the documentation, run `go generate`. **Note:** Everything inside the `docs` directory is generated based off schema data and the content inside `examples`. Do not manually edit anything inside `docs`.
+3. Import your package to `main.go` at the root of the project and, from the `registerResources` function, call the SetRegistrar function passing in the `regInstance` variable.

.amazonq/rules/project.md

@@ -0,0 +1,7 @@
+# Terraform Provider Genesys Cloud
+
+This Golang project is a Terraform provider for the Genesys Cloud APIs.
+
+Further details about this project can be found in the ./README.md file
+
+Utilize the ./DICTIONARY.md file for ensuring proper and consistent domain language usage.

docs/data-sources/ai_studio_summary_setting.md

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

docs/data-sources/conversations_messaging_integrations_apple.md

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

docs/resources/ai_studio_summary_setting.md

@@ -0,0 +1,89 @@
+---
+page_title: "genesyscloud_ai_studio_summary_setting Resource - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Genesys Cloud ai studio summary setting
+---
+# genesyscloud_ai_studio_summary_setting (Resource)
+
+Genesys Cloud ai studio summary setting
+
+## 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:
+
+- [POST /api/v2/conversations/summaries/settings](https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-conversations-summaries-settings)
+- [GET /api/v2/conversations/summaries/settings/{summarySettingId}](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-summaries-settings--summarySettingId-)
+- [PUT /api/v2/conversations/summaries/settings/{summarySettingId}](https://developer.genesys.cloud/devapps/api-explorer#put-api-v2-conversations-summaries-settings--summarySettingId-)
+- [DELETE /api/v2/conversations/summaries/settings/{summarySettingId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-conversations-summaries-settings--summarySettingId-)
+- [GET /api/v2/conversations/summaries/settings](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-summaries-settings)
+
+
+## Example Usage
+
+```terraform
+resource "genesyscloud_ai_studio_summary_setting" "summary" {
+  name         = "user10"
+  language     = "en-au"
+  summary_type = "Concise"
+  setting_type = "Basic"
+  format       = "BulletPoints"
+  mask_p_i_i {
+    all = true
+  }
+  participant_labels {
+    internal = "Advisor"
+    external = "Member"
+  }
+  predefined_insights = []
+  prompt              = ""
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `language` (String) Language of the generated summary, e.g. en-US, it-IT.
+- `name` (String) Name of the summary setting.
+
+### Optional
+
+- `custom_entities` (Block List) Custom entity definition. (see [below for nested schema](#nestedblock--custom_entities))
+- `format` (String) Format of the generated summary.
+- `mask_p_i_i` (Block List, Max: 1) Displaying PII in the generated summary. (see [below for nested schema](#nestedblock--mask_p_i_i))
+- `participant_labels` (Block List, Max: 1) How to refer to interaction participants in the generated summary. (see [below for nested schema](#nestedblock--participant_labels))
+- `predefined_insights` (Set of String) Set which insights to include in the generated summary by default.
+- `prompt` (String) Custom prompt of summary setting.
+- `setting_type` (String) Type of the summary setting.
+- `summary_type` (String) Level of detail of the generated summary.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--custom_entities"></a>
+### Nested Schema for `custom_entities`
+
+Optional:
+
+- `description` (String) Describe the information the entity captures.
+- `label` (String) Label how the entity should be called.
+
+
+<a id="nestedblock--mask_p_i_i"></a>
+### Nested Schema for `mask_p_i_i`
+
+Required:
+
+- `all` (Boolean) Toggle PII visibility in summary.
+
+
+<a id="nestedblock--participant_labels"></a>
+### Nested Schema for `participant_labels`
+
+Optional:
+
+- `external` (String) Specify how to refer the external participant of the interaction.
+- `internal` (String) Specify how to refer the internal participant of the interaction.
+

docs/resources/conversations_messaging_integrations_apple.md

@@ -0,0 +1,124 @@
+---
+page_title: "genesyscloud_conversations_messaging_integrations_apple Resource - terraform-provider-genesyscloud"
+subcategory: ""
+description: |-
+  Genesys Cloud apple integration
+---
+# genesyscloud_conversations_messaging_integrations_apple (Resource)
+
+Genesys Cloud apple integration
+
+## 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:
+
+* [POST /api/v2/conversations/messaging/integrations/apple](https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-conversations-messaging-integrations-apple)
+* [GET /api/v2/conversations/messaging/integrations/apple/{integrationId}](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-messaging-integrations-apple--integrationId-)
+* [PATCH /api/v2/conversations/messaging/integrations/apple/{integrationId}](https://developer.genesys.cloud/devapps/api-explorer#patch-api-v2-conversations-messaging-integrations-apple--integrationId-)
+* [DELETE /api/v2/conversations/messaging/integrations/apple/{integrationId}](https://developer.genesys.cloud/devapps/api-explorer#delete-api-v2-conversations-messaging-integrations-apple--integrationId-)
+* [GET /api/v2/conversations/messaging/integrations/apple](https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations-messaging-integrations-apple)
+
+## Example Usage
+
+```terraform
+resource "genesyscloud_conversations_messaging_integrations_apple" "example" {
+  name                     = "Apple Messages Integration"
+  messages_for_business_id = "your-apple-messages-business-id"
+  business_name            = "Your Business Name"
+  logo_url                 = "https://example.com/logo.png"
+  supported_content_id     = genesyscloud_conversations_messaging_supportedcontent.example.id
+  messaging_setting_id     = genesyscloud_conversations_messaging_settings.example.id
+
+  apple_i_message_app {
+    application_name = "Your App Name"
+    application_id   = "your-app-id"
+    bundle_id        = "com.yourcompany.yourapp"
+  }
+
+  apple_authentication {
+    oauth_client_id     = "your-oauth-client-id"
+    oauth_client_secret = "your-oauth-client-secret"
+    oauth_token_url     = "https://appleid.apple.com/auth/oauth2/token"
+    oauth_scope         = "profile"
+  }
+
+  apple_pay {
+    store_name                        = "Your Store"
+    merchant_id                       = "merchant.com.yourcompany.yourstore"
+    domain_name                       = "yourstore.com"
+    payment_capabilities              = ["supports3DS", "supportsCredit", "supportsDebit"]
+    supported_payment_networks        = ["visa", "masterCard", "amex"]
+    payment_certificate_credential_id = "your-payment-certificate-credential-id"
+    payment_gateway_url               = "https://yourstore.com/payment-gateway"
+    fallback_url                      = "https://yourstore.com/fallback"
+    shipping_method_update_url        = "https://yourstore.com/shipping-method-update"
+    shipping_contact_update_url       = "https://yourstore.com/shipping-contact-update"
+    payment_method_update_url         = "https://yourstore.com/payment-method-update"
+    order_tracking_url                = "https://yourstore.com/order-tracking"
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `messages_for_business_id` (String) The Apple Messages for Business Id for the Apple messaging integration.
+- `name` (String) The name of the Apple messaging integration.
+
+### Optional
+
+- `apple_authentication` (Block List, Max: 1) The Apple Messages for Business authentication setting. (see [below for nested schema](#nestedblock--apple_authentication))
+- `apple_i_message_app` (Block List, Max: 1) Interactive Application (iMessage App) Settings. (see [below for nested schema](#nestedblock--apple_i_message_app))
+- `apple_pay` (Block List, Max: 1) Apple Pay settings. (see [below for nested schema](#nestedblock--apple_pay))
+- `business_name` (String) The name of the business.
+- `logo_url` (String) The url of the businesses logo.
+- `messaging_setting_id` (String) The ID of the messaging setting configured for this integration
+- `supported_content_id` (String) The ID of the supported content profile configured for this integration. If not set, the default supported content profile will be used.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--apple_authentication"></a>
+### Nested Schema for `apple_authentication`
+
+Optional:
+
+- `oauth_client_id` (String) The Apple Messages for Business OAuth client id.
+- `oauth_client_secret` (String) The Apple Messages for Business OAuth client secret.
+- `oauth_scope` (String) The Apple Messages for Business OAuth scope.
+- `oauth_token_url` (String) The Apple Messages for Business token URL.
+
+
+<a id="nestedblock--apple_i_message_app"></a>
+### Nested Schema for `apple_i_message_app`
+
+Required:
+
+- `application_id` (String) Application ID.
+- `application_name` (String) Application Name.
+- `bundle_id` (String) Bundle ID.
+
+
+<a id="nestedblock--apple_pay"></a>
+### Nested Schema for `apple_pay`
+
+Required:
+
+- `domain_name` (String) The domain name associated with the merchant account.
+- `merchant_id` (String) The stores merchant identifier.
+- `payment_capabilities` (List of String) The payment capabilities supported by the merchant.
+- `payment_certificate_credential_id` (String) The Genesys credentialId the payment certificates are stored under. Must be a valid and existing credential ID created via /api/v2/integrations/credentials endpoint. See API documentation: https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-integrations-credentials. Example payload: {"type": "applePayCertificate", "credentialFields": {"merchantKey": "base-64-key", "merchantCertificate": "base-64-cert"}}
+- `payment_gateway_url` (String) The url used to process payments.
+- `store_name` (String) The name of the store.
+- `supported_payment_networks` (List of String) The payment networks supported by the merchant.
+
+Optional:
+
+- `fallback_url` (String) The url opened in a web browser if the customers device is unable to make payments using Apple Pay.
+- `order_tracking_url` (String) The url called after completing the order to update the order information in your system
+- `payment_method_update_url` (String) The url called when the customer changes their payment method.
+- `shipping_contact_update_url` (String) The url called when the customer changes their shipping address information.
+- `shipping_method_update_url` (String) The url called when the customer changes the shipping method.
+

docs/resources/group.md

@@ -19,6 +19,8 @@ The following Genesys Cloud APIs are used by this resource. Ensure your OAuth Cl
 * [GET /api/v2/groups/{groupId}/individuals](https://developer.mypurecloud.com/api/rest/v2/groups/#get-api-v2-groups--groupId--individuals)
 * [POST /api/v2/groups/{groupId}/members](https://developer.mypurecloud.com/api/rest/v2/groups/#post-api-v2-groups--groupId--members)
 * [DELETE /api/v2/groups/{groupId}/members](https://developer.mypurecloud.com/api/rest/v2/groups/#delete-api-v2-groups--groupId--members)
+* [GET /api/v2/voicemail/groups/{groupId}/policy](https://developer.genesys.cloud/commdigital/voicemail/#get-api-v2-voicemail-groups--groupId--policy)
+* [PATCH /api/v2/voicemail/groups/{groupId}/policy](https://developer.genesys.cloud/commdigital/voicemail/#patch-api-v2-voicemail-groups--groupId--policy)
 
 ## Example Usage
 
@@ -75,6 +77,7 @@ resource "genesyscloud_group" "example_group2" {
 - `rules_visible` (Boolean) Are membership rules visible to the person requesting to view the group. Defaults to `true`.
 - `type` (String) Group type (official | social). This cannot be modified. Changing type attribute will cause the existing genesys_group object to dropped and recreated with a new ID. Defaults to `official`.
 - `visibility` (String) Who can view this group (public | owners | members). Defaults to `public`.
+- `voicemail_policy` (Block List, Max: 1) The voicemail policy associated with this group (see [below for nested schema](#nestedblock--voicemail_policy))
 
 ### Read-Only
 
@@ -92,3 +95,13 @@ Optional:
 - `extension` (String) Phone extension.
 - `number` (String) Phone number for this contact type. Must be in an E.164 number format.
 
+
+<a id="nestedblock--voicemail_policy"></a>
+### Nested Schema for `voicemail_policy`
+
+Optional:
+
+- `disable_email_pii` (Boolean) Removes any PII from group emails. This is overridden by the analogous organization configuration value. This is always true if HIPAA is enabled or unknown for an organization.
+- `include_email_transcriptions` (Boolean) Whether to include the voicemail transcription in a group notification email.
+- `send_email_notifications` (Boolean) Whether email notifications are sent to group members when a new voicemail is received.
+

docs/resources/idp_adfs.md

@@ -25,6 +25,7 @@ resource "genesyscloud_idp_adfs" "adfs" {
   target_uri               = "https://example.com/login"
   relying_party_identifier = "unique-id-from-adfs"
   disabled                 = true
+  sign_authn_requests      = false
 }
 ```
 
@@ -41,6 +42,7 @@ resource "genesyscloud_idp_adfs" "adfs" {
 - `disabled` (Boolean) True if ADFS is disabled. Defaults to `false`.
 - `name` (String) IDP ADFS resource name
 - `relying_party_identifier` (String) String used to identify Genesys Cloud to ADFS.
+- `sign_authn_requests` (Boolean) True if the Genesys Cloud authentication request should be signed. Defaults to `false`.
 - `slo_binding` (String)
 - `slo_uri` (String) Provided by ADFS on app creation
 - `target_uri` (String) Target URI provided by ADFS.

docs/resources/idp_generic.md

@@ -27,6 +27,7 @@ resource "genesyscloud_idp_generic" "generic" {
   logo_image_data          = filebase64("${local.working_dir.idp_generic}/logo.svg")
   endpoint_compression     = false
   name_identifier_format   = "urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified"
+  sign_authn_requests      = false
 }
 ```
 
@@ -46,6 +47,7 @@ resource "genesyscloud_idp_generic" "generic" {
 - `logo_image_data` (String) Base64 encoded SVG image.
 - `name_identifier_format` (String) SAML name identifier format. (urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified | urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress | urn:oasis:names:tc:SAML:1.1:nameid-format:X509SubjectName | urn:oasis:names:tc:SAML:1.1:nameid-format:WindowsDomainQualifiedName | urn:oasis:names:tc:SAML:2.0:nameid-format:kerberos | urn:oasis:names:tc:SAML:2.0:nameid-format:entity | urn:oasis:names:tc:SAML:2.0:nameid-format:persistent | urn:oasis:names:tc:SAML:2.0:nameid-format:transient) Defaults to `urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified`.
 - `relying_party_identifier` (String) String used to identify Genesys Cloud to the identity provider.
+- `sign_authn_requests` (Boolean) True if the Genesys Cloud authentication request should be signed. Defaults to `false`.
 - `slo_binding` (String) Valid values: HTTP Redirect, HTTP Post
 - `slo_uri` (String) Provided on app creation.
 - `target_uri` (String) Target URI provided by the provider.