Feature/devtooling-1394 - User, Language, Wrapupcode resource migration from SDKv2 - Plugin Framework

.gitignore

@@ -29,6 +29,7 @@ terraform-provider-genesyscloud
 .env
 .vscode
 .kiro
+.kiro
 .cursor
 **/true
 website/vendor

docs/data-sources/integration_webhook.md → docs/data-sources/integration_webhookmake si.md

@@ -1,22 +1,16 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "genesyscloud_integration_webhook Data Source - terraform-provider-genesyscloud"
+page_title: "genesyscloud_integration_webhookmake si Data Source - terraform-provider-genesyscloud"
 subcategory: ""
 description: |-
   Data source for Genesys Cloud webhook integration. Select a webhook integration by name
 ---
 
-# genesyscloud_integration_webhook (Data Source)
+# genesyscloud_integration_webhookmake si (Data Source)
 
 Data source for Genesys Cloud webhook integration. Select a webhook integration by name
 
-## Example Usage
 
-```terraform
-data "genesyscloud_integration_webhook" "webhook_integration" {
-  name = "example webhook integration name"
-}
-```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/routing_language.md

@@ -27,4 +27,4 @@ data "genesyscloud_routing_language" "english" {
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of the routing language.

docs/data-sources/routing_wrapupcode.md

@@ -27,4 +27,4 @@ data "genesyscloud_routing_wrapupcode" "example-routing-wrapupcode" {
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The globally unique identifier for the wrapup code.

docs/data-sources/user.md

@@ -28,4 +28,4 @@ data "genesyscloud_user" "user" {
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of the user.

docs/index.md

@@ -33,8 +33,8 @@ If the stack trace occurs within the create context and before the ID is set in
 If you encounter any stack traces, please report them so we can address the underlying issues.
 - `log_stack_traces_file_path` (String) Specifies the file path for the stack trace logs. Can be set with the `GENESYSCLOUD_LOG_STACK_TRACES_FILE_PATH` environment variable. Default value is genesyscloud_stack_traces.log
 - `oauthclient_id` (String) OAuthClient ID found on the OAuth page of Admin UI. Can be set with the `GENESYSCLOUD_OAUTHCLIENT_ID` environment variable.
-- `oauthclient_secret` (String, Sensitive) OAuthClient secret found on the OAuth page of Admin UI. Can be set with the `GENESYSCLOUD_OAUTHCLIENT_SECRET` environment variable.
-- `proxy` (Block Set, Max: 1) (see [below for nested schema](#nestedblock--proxy))
+- `oauthclient_secret` (String) OAuthClient secret found on the OAuth page of Admin UI. Can be set with the `GENESYSCLOUD_OAUTHCLIENT_SECRET` environment variable.
+- `proxy` (Block Set) (see [below for nested schema](#nestedblock--proxy))
 - `sdk_client_pool_debug` (Boolean) Enables debug tracing in the Genesys Cloud SDK client pool. Output will be written to standard log output. Can be set with the `GENESYSCLOUD_SDK_CLIENT_POOL_DEBUG` environment variable.
 - `sdk_debug` (Boolean) Enables debug tracing in the Genesys Cloud SDK. Output will be written to the local file 'sdk_debug.log'. Can be set with the `GENESYSCLOUD_SDK_DEBUG` environment variable.
 - `sdk_debug_file_path` (String) Specifies the file path for the log file. Can be set with the `GENESYSCLOUD_SDK_DEBUG_FILE_PATH` environment variable. Default value is sdk_debug.log
@@ -48,7 +48,7 @@ If you encounter any stack traces, please report them so we can address the unde
 
 Optional:
 
-- `auth` (Block Set, Max: 1) (see [below for nested schema](#nestedblock--gateway--auth))
+- `auth` (Block Set) (see [below for nested schema](#nestedblock--gateway--auth))
 - `host` (String) Host for the gateway can be set with the `GENESYSCLOUD_GATEWAY_HOST` environment variable.
 - `path_params` (Block Set) (see [below for nested schema](#nestedblock--gateway--path_params))
 - `port` (String) Port for the gateway can be set with the `GENESYSCLOUD_GATEWAY_PORT` environment variable.
@@ -78,7 +78,7 @@ Required:
 
 Optional:
 
-- `auth` (Block Set, Max: 1) (see [below for nested schema](#nestedblock--proxy--auth))
+- `auth` (Block Set) (see [below for nested schema](#nestedblock--proxy--auth))
 - `host` (String) Host for the proxy can be set with the `GENESYSCLOUD_PROXY_HOST` environment variable.
 - `port` (String) Port for the proxy can be set with the `GENESYSCLOUD_PROXY_PORT` environment variable.
 - `protocol` (String) Protocol for the proxy can be set with the `GENESYSCLOUD_PROXY_PROTOCOL` environment variable.

docs/resources/routing_language.md

@@ -44,5 +44,5 @@ resource "genesyscloud_routing_language" "english" {
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of the routing language.
 

docs/resources/routing_wrapupcode.md

@@ -54,9 +54,9 @@ resource "genesyscloud_routing_wrapupcode" "unknown" {
 ### Optional
 
 - `description` (String) The wrap-up code description.
-- `division_id` (String) The division to which this routing wrapupcode will belong. If not set, * will be used to indicate all divisions.
+- `division_id` (String) The division to which this routing wrapupcode will belong.
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The globally unique identifier for the wrapup code.
 

docs/resources/user.md

@@ -163,165 +163,189 @@ resource "genesyscloud_user" "example_user2" {
 
 ### Optional
 
-- `acd_auto_answer` (Boolean) Enable ACD auto-answer. Defaults to `false`.
-- `addresses` (List of Object) The address settings for this user. If not set, this resource will not manage addresses. (see [below for nested schema](#nestedatt--addresses))
+- `acd_auto_answer` (Boolean) Enable ACD auto-answer.
+- `addresses` (Block List) The address settings for this user. If not set, this resource will not manage addresses. (see [below for nested schema](#nestedblock--addresses))
 - `certifications` (Set of String) Certifications for this user. If not set, this resource will not manage certifications.
 - `department` (String) User's department.
 - `division_id` (String) The division to which this user will belong. If not set, the home division will be used.
-- `employer_info` (List of Object) The employer info for this user. If not set, this resource will not manage employer info. (see [below for nested schema](#nestedatt--employer_info))
-- `locations` (Set of Object) The user placement at each site location. If not set, this resource will not manage user locations. (see [below for nested schema](#nestedatt--locations))
+- `employer_info` (Block List) The employer info for this user. If not set, this resource will not manage employer info. (see [below for nested schema](#nestedblock--employer_info))
+- `locations` (Block Set) The user placement at each site location. If not set, this resource will not manage user locations. (see [below for nested schema](#nestedblock--locations))
 - `manager` (String) User ID of this user's manager.
 - `password` (String, Sensitive) User's password. If specified, this is only set on user create.
 - `profile_skills` (Set of String) Profile skills for this user. If not set, this resource will not manage profile skills.
-- `routing_languages` (Set of Object) Languages and proficiencies for this user. If not set, this resource will not manage user languages. (see [below for nested schema](#nestedatt--routing_languages))
-- `routing_skills` (Set of Object) Skills and proficiencies for this user. If not set, this resource will not manage user skills. (see [below for nested schema](#nestedatt--routing_skills))
-- `routing_utilization` (List of Object) The routing utilization settings for this user. If empty list, the org default settings are used. If not set, this resource will not manage the users's utilization settings. (see [below for nested schema](#nestedatt--routing_utilization))
-- `state` (String) User's state (active | inactive). Default is 'active'. Defaults to `active`.
+- `routing_languages` (Block Set) Languages and proficiencies for this user. If not set, this resource will not manage user languages. (see [below for nested schema](#nestedblock--routing_languages))
+- `routing_skills` (Block Set) Skills and proficiencies for this user. If not set, this resource will not manage user skills. (see [below for nested schema](#nestedblock--routing_skills))
+- `routing_utilization` (Block List) The routing utilization settings for this user. If empty list, the org default settings are used. If not set, this resource will not manage the users's utilization settings. (see [below for nested schema](#nestedblock--routing_utilization))
+- `state` (String) User's state (active | inactive). Default is 'active'.
 - `title` (String) User's title.
-- `voicemail_userpolicies` (Block List, Max: 1) User's voicemail policies. If not set, default user policies will be applied. (see [below for nested schema](#nestedblock--voicemail_userpolicies))
+- `voicemail_userpolicies` (Block List) User's voicemail policies. If not set, default user policies will be applied. (see [below for nested schema](#nestedblock--voicemail_userpolicies))
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
+- `id` (String) The ID of the user.
 
-<a id="nestedatt--addresses"></a>
+<a id="nestedblock--addresses"></a>
 ### Nested Schema for `addresses`
 
 Optional:
 
-- `other_emails` (Set of Object) (see [below for nested schema](#nestedobjatt--addresses--other_emails))
-- `phone_numbers` (Set of Object) (see [below for nested schema](#nestedobjatt--addresses--phone_numbers))
+- `other_emails` (Block Set) Other Email addresses for this user. (see [below for nested schema](#nestedblock--addresses--other_emails))
+- `phone_numbers` (Block Set) Phone number addresses for this user. (see [below for nested schema](#nestedblock--addresses--phone_numbers))
 
-<a id="nestedobjatt--addresses--other_emails"></a>
+<a id="nestedblock--addresses--other_emails"></a>
 ### Nested Schema for `addresses.other_emails`
 
+Required:
+
+- `address` (String) Email address.
+
 Optional:
 
-- `address` (String)
-- `type` (String)
+- `type` (String) Type of email address (WORK | HOME).
 
 
-<a id="nestedobjatt--addresses--phone_numbers"></a>
+<a id="nestedblock--addresses--phone_numbers"></a>
 ### Nested Schema for `addresses.phone_numbers`
 
 Optional:
 
-- `extension` (String)
-- `extension_pool_id` (String)
-- `media_type` (String)
-- `number` (String)
-- `type` (String)
+- `extension` (String) Phone number extension
+- `extension_pool_id` (String) Id of the extension pool which contains this extension.
+- `media_type` (String) Media type of phone number (SMS | PHONE).
+- `number` (String) Phone number. Phone number must be in an E.164 number format.
+- `type` (String) Type of number (WORK | WORK2 | WORK3 | WORK4 | HOME | MOBILE | OTHER).
 
 
 
-<a id="nestedatt--employer_info"></a>
+<a id="nestedblock--employer_info"></a>
 ### Nested Schema for `employer_info`
 
 Optional:
 
-- `date_hire` (String)
-- `employee_id` (String)
-- `employee_type` (String)
-- `official_name` (String)
+- `date_hire` (String) Hiring date. Dates must be an ISO-8601 string. For example: yyyy-MM-dd.
+- `employee_id` (String) Employee ID.
+- `employee_type` (String) Employee type (Full-time | Part-time | Contractor).
+- `official_name` (String) User's official name.
 
 
-<a id="nestedatt--locations"></a>
+<a id="nestedblock--locations"></a>
 ### Nested Schema for `locations`
 
+Required:
+
+- `location_id` (String) ID of location.
+
 Optional:
 
-- `location_id` (String)
-- `notes` (String)
+- `notes` (String) Optional description on the user's location.
 
 
-<a id="nestedatt--routing_languages"></a>
+<a id="nestedblock--routing_languages"></a>
 ### Nested Schema for `routing_languages`
 
-Optional:
+Required:
 
-- `language_id` (String)
-- `proficiency` (Number)
+- `language_id` (String) ID of routing language.
+- `proficiency` (Number) Proficiency is a rating from 0 to 5 on how competent an agent is for a particular language. It is used when a queue is set to 'Best available language' mode to allow acd interactions to target agents with higher proficiency ratings.
 
 
-<a id="nestedatt--routing_skills"></a>
+<a id="nestedblock--routing_skills"></a>
 ### Nested Schema for `routing_skills`
 
-Optional:
+Required:
 
-- `proficiency` (Number)
-- `skill_id` (String)
+- `proficiency` (Number) Rating from 0.0 to 5.0 on how competent an agent is for a particular skill. It is used when a queue is set to 'Best available skills' mode to allow acd interactions to target agents with higher proficiency ratings.
+- `skill_id` (String) ID of routing skill.
 
 
-<a id="nestedatt--routing_utilization"></a>
+<a id="nestedblock--routing_utilization"></a>
 ### Nested Schema for `routing_utilization`
 
 Optional:
 
-- `call` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--call))
-- `callback` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--callback))
-- `chat` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--chat))
-- `email` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--email))
-- `label_utilizations` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--label_utilizations))
-- `message` (List of Object) (see [below for nested schema](#nestedobjatt--routing_utilization--message))
+- `call` (Block List) Call media settings. If not set, this reverts to the default media type settings. (see [below for nested schema](#nestedblock--routing_utilization--call))
+- `callback` (Block List) Callback media settings. If not set, this reverts to the default media type settings. (see [below for nested schema](#nestedblock--routing_utilization--callback))
+- `chat` (Block List) Chat media settings. If not set, this reverts to the default media type settings. (see [below for nested schema](#nestedblock--routing_utilization--chat))
+- `email` (Block List) Email media settings. If not set, this reverts to the default media type settings. (see [below for nested schema](#nestedblock--routing_utilization--email))
+- `label_utilizations` (Block List) Label utilization settings. If not set, default label settings will be applied. This is in PREVIEW and should not be used unless the feature is available to your organization. (see [below for nested schema](#nestedblock--routing_utilization--label_utilizations))
+- `message` (Block List) Message media settings. If not set, this reverts to the default media type settings. (see [below for nested schema](#nestedblock--routing_utilization--message))
 
-<a id="nestedobjatt--routing_utilization--call"></a>
+<a id="nestedblock--routing_utilization--call"></a>
 ### Nested Schema for `routing_utilization.call`
 
+Required:
+
+- `maximum_capacity` (Number) Maximum capacity of conversations of this media type. Value must be between 0 and 25.
+
 Optional:
 
-- `include_non_acd` (Boolean)
-- `interruptible_media_types` (Set of String)
-- `maximum_capacity` (Number)
+- `include_non_acd` (Boolean) Block this media type when on a non-ACD conversation.
+- `interruptible_media_types` (Set of String) Set of other media types that can interrupt this media type (call | callback | chat | email | message).
 
 
-<a id="nestedobjatt--routing_utilization--callback"></a>
+<a id="nestedblock--routing_utilization--callback"></a>
 ### Nested Schema for `routing_utilization.callback`
 
+Required:
+
+- `maximum_capacity` (Number) Maximum capacity of conversations of this media type. Value must be between 0 and 25.
+
 Optional:
 
-- `include_non_acd` (Boolean)
-- `interruptible_media_types` (Set of String)
-- `maximum_capacity` (Number)
+- `include_non_acd` (Boolean) Block this media type when on a non-ACD conversation.
+- `interruptible_media_types` (Set of String) Set of other media types that can interrupt this media type.
 
 
-<a id="nestedobjatt--routing_utilization--chat"></a>
+<a id="nestedblock--routing_utilization--chat"></a>
 ### Nested Schema for `routing_utilization.chat`
 
+Required:
+
+- `maximum_capacity` (Number) Maximum capacity of conversations of this media type. Value must be between 0 and 25.
+
 Optional:
 
-- `include_non_acd` (Boolean)
-- `interruptible_media_types` (Set of String)
-- `maximum_capacity` (Number)
+- `include_non_acd` (Boolean) Block this media type when on a non-ACD conversation.
+- `interruptible_media_types` (Set of String) Set of other media types that can interrupt this media type.
 
 
-<a id="nestedobjatt--routing_utilization--email"></a>
+<a id="nestedblock--routing_utilization--email"></a>
 ### Nested Schema for `routing_utilization.email`
 
+Required:
+
+- `maximum_capacity` (Number) Maximum capacity of conversations of this media type. Value must be between 0 and 25.
+
 Optional:
 
-- `include_non_acd` (Boolean)
-- `interruptible_media_types` (Set of String)
-- `maximum_capacity` (Number)
+- `include_non_acd` (Boolean) Block this media type when on a non-ACD conversation.
+- `interruptible_media_types` (Set of String) Set of other media types that can interrupt this media type.
 
 
-<a id="nestedobjatt--routing_utilization--label_utilizations"></a>
+<a id="nestedblock--routing_utilization--label_utilizations"></a>
 ### Nested Schema for `routing_utilization.label_utilizations`
 
+Required:
+
+- `label_id` (String) Id of the label being configured.
+- `maximum_capacity` (Number) Maximum capacity of conversations with this label. Value must be between 0 and 25.
+
 Optional:
 
-- `interrupting_label_ids` (Set of String)
-- `label_id` (String)
-- `maximum_capacity` (Number)
+- `interrupting_label_ids` (Set of String) Set of other labels that can interrupt this label.
 
 
-<a id="nestedobjatt--routing_utilization--message"></a>
+<a id="nestedblock--routing_utilization--message"></a>
 ### Nested Schema for `routing_utilization.message`
 
+Required:
+
+- `maximum_capacity` (Number) Maximum capacity of conversations of this media type. Value must be between 0 and 25.
+
 Optional:
 
-- `include_non_acd` (Boolean)
-- `interruptible_media_types` (Set of String)
-- `maximum_capacity` (Number)
+- `include_non_acd` (Boolean) Block this media type when on a non-ACD conversation.
+- `interruptible_media_types` (Set of String) Set of other media types that can interrupt this media type.