Adding flexible webhook support; (#14459) (#1042)

[upstream:a333f0a97922e4c091a8c9cf0cf4772d1d507c8e]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

dialogflowcx_webhook_flexible/backing_file.tf

@@ -0,0 +1,15 @@
+# This file has some scaffolding to make sure that names are unique and that
+# a region and zone are selected when you try to create your Terraform resources.
+
+locals {
+  name_suffix = "${random_pet.suffix.id}"
+}
+
+resource "random_pet" "suffix" {
+  length = 2
+}
+
+provider "google" {
+  region = "us-central1"
+  zone   = "us-central1-c"
+}

dialogflowcx_webhook_flexible/main.tf

@@ -0,0 +1,34 @@
+resource "google_dialogflow_cx_agent" "agent" {
+  display_name = "dialogflowcx-agent-${local.name_suffix}"
+  location = "global"
+  default_language_code = "en"
+  supported_language_codes = ["it","de","es"]
+  time_zone = "America/New_York"
+  description = "Example description."
+  avatar_uri = "https://cloud.google.com/_static/images/cloud/icons/favicons/onecloud/super_cloud.png"
+  enable_stackdriver_logging = true
+  enable_spell_correction    = true
+  speech_to_text_settings {
+    enable_speech_adaptation = true
+  }
+}
+
+
+resource "google_dialogflow_cx_webhook" "flexible_webhook" {
+  parent       = google_dialogflow_cx_agent.agent.id
+  display_name = "MyFlow"
+  generic_web_service {
+		uri = "https://example.com"
+    request_headers = { "example-key": "example-value" }
+    webhook_type = "FLEXIBLE"
+    oauth_config {
+      client_id = "example-client-id"
+      client_secret = "projects/example-proj/secrets/example-secret/versions/example-version"
+      token_endpoint = "https://example.com"
+    }
+    service_agent_auth = "NONE"
+    http_method = "POST"
+    request_body = "{\"example-key\": \"example-value\"}"
+    parameter_mapping = { "example-parameter": "examplePath" }
+	}
+}

dialogflowcx_webhook_flexible/motd

@@ -0,0 +1,7 @@
+===
+
+These examples use real resources that will be billed to the
+Google Cloud Platform project you use - so make sure that you
+run "terraform destroy" before quitting!
+
+===

dialogflowcx_webhook_flexible/tutorial.md

@@ -0,0 +1,79 @@
+# Dialogflowcx Webhook Flexible - Terraform
+
+## Setup
+
+<walkthrough-author name="[email protected]" analyticsId="UA-125550242-1" tutorialName="dialogflowcx_webhook_flexible" repositoryUrl="https://github.com/terraform-google-modules/docs-examples"></walkthrough-author>
+
+Welcome to Terraform in Google Cloud Shell! We need you to let us know what project you'd like to use with Terraform.
+
+<walkthrough-project-billing-setup></walkthrough-project-billing-setup>
+
+Terraform provisions real GCP resources, so anything you create in this session will be billed against this project.
+
+## Terraforming!
+
+Let's use {{project-id}} with Terraform! Click the Cloud Shell icon below to copy the command
+to your shell, and then run it from the shell by pressing Enter/Return. Terraform will pick up
+the project name from the environment variable.
+
+```bash
+export GOOGLE_CLOUD_PROJECT={{project-id}}
+```
+
+After that, let's get Terraform started. Run the following to pull in the providers.
+
+```bash
+terraform init
+```
+
+With the providers downloaded and a project set, you're ready to use Terraform. Go ahead!
+
+```bash
+terraform apply
+```
+
+Terraform will show you what it plans to do, and prompt you to accept. Type "yes" to accept the plan.
+
+```bash
+yes
+```
+
+
+## Post-Apply
+
+### Editing your config
+
+Now you've provisioned your resources in GCP! If you run a "plan", you should see no changes needed.
+
+```bash
+terraform plan
+```
+
+So let's make a change! Try editing a number, or appending a value to the name in the editor. Then,
+run a 'plan' again.
+
+```bash
+terraform plan
+```
+
+Afterwards you can run an apply, which implicitly does a plan and shows you the intended changes
+at the 'yes' prompt.
+
+```bash
+terraform apply
+```
+
+```bash
+yes
+```
+
+## Cleanup
+
+Run the following to remove the resources Terraform provisioned:
+
+```bash
+terraform destroy
+```
+```bash
+yes
+```

dialogflowcx_webhook_service_directory_flexible/backing_file.tf

@@ -0,0 +1,15 @@
+# This file has some scaffolding to make sure that names are unique and that
+# a region and zone are selected when you try to create your Terraform resources.
+
+locals {
+  name_suffix = "${random_pet.suffix.id}"
+}
+
+resource "random_pet" "suffix" {
+  length = 2
+}
+
+provider "google" {
+  region = "us-central1"
+  zone   = "us-central1-c"
+}

dialogflowcx_webhook_service_directory_flexible/main.tf

@@ -0,0 +1,37 @@
+resource "google_dialogflow_cx_agent" "agent" {
+  display_name = "dialogflowcx-agent-${local.name_suffix}"
+  location = "us-central1"
+  default_language_code = "en"
+  supported_language_codes = ["it","de","es"]
+  time_zone = "America/New_York"
+  description = "Example description."
+  avatar_uri = "https://cloud.google.com/_static/images/cloud/icons/favicons/onecloud/super_cloud.png"
+  enable_stackdriver_logging = true
+  enable_spell_correction    = true
+  speech_to_text_settings {
+    enable_speech_adaptation = true
+  }
+}
+
+
+resource "google_dialogflow_cx_webhook" "flexible_webhook" {
+  parent       = google_dialogflow_cx_agent.agent.id
+  display_name = "MyFlow"
+  service_directory {
+    service = "projects/example-proj/locations/us-central1/namespaces/example-namespace/services/example-service"
+    generic_web_service {
+      uri = "https://example.com"
+      request_headers = { "example-key": "example-value" }
+      webhook_type = "FLEXIBLE"
+      oauth_config {
+        client_id = "example-client-id"
+        client_secret = "projects/example-proj/secrets/example-secret/versions/example-version"
+        token_endpoint = "https://example.com"
+      }
+      service_agent_auth = "NONE"
+      http_method = "POST"
+      request_body = "{\"example-key\": \"example-value\"}"
+      parameter_mapping = { "example-parameter": "examplePath" }
+    }
+  }
+}

dialogflowcx_webhook_service_directory_flexible/motd

@@ -0,0 +1,7 @@
+===
+
+These examples use real resources that will be billed to the
+Google Cloud Platform project you use - so make sure that you
+run "terraform destroy" before quitting!
+
+===

dialogflowcx_webhook_service_directory_flexible/tutorial.md

@@ -0,0 +1,79 @@
+# Dialogflowcx Webhook Service Directory Flexible - Terraform
+
+## Setup
+
+<walkthrough-author name="[email protected]" analyticsId="UA-125550242-1" tutorialName="dialogflowcx_webhook_service_directory_flexible" repositoryUrl="https://github.com/terraform-google-modules/docs-examples"></walkthrough-author>
+
+Welcome to Terraform in Google Cloud Shell! We need you to let us know what project you'd like to use with Terraform.
+
+<walkthrough-project-billing-setup></walkthrough-project-billing-setup>
+
+Terraform provisions real GCP resources, so anything you create in this session will be billed against this project.
+
+## Terraforming!
+
+Let's use {{project-id}} with Terraform! Click the Cloud Shell icon below to copy the command
+to your shell, and then run it from the shell by pressing Enter/Return. Terraform will pick up
+the project name from the environment variable.
+
+```bash
+export GOOGLE_CLOUD_PROJECT={{project-id}}
+```
+
+After that, let's get Terraform started. Run the following to pull in the providers.
+
+```bash
+terraform init
+```
+
+With the providers downloaded and a project set, you're ready to use Terraform. Go ahead!
+
+```bash
+terraform apply
+```
+
+Terraform will show you what it plans to do, and prompt you to accept. Type "yes" to accept the plan.
+
+```bash
+yes
+```
+
+
+## Post-Apply
+
+### Editing your config
+
+Now you've provisioned your resources in GCP! If you run a "plan", you should see no changes needed.
+
+```bash
+terraform plan
+```
+
+So let's make a change! Try editing a number, or appending a value to the name in the editor. Then,
+run a 'plan' again.
+
+```bash
+terraform plan
+```
+
+Afterwards you can run an apply, which implicitly does a plan and shows you the intended changes
+at the 'yes' prompt.
+
+```bash
+terraform apply
+```
+
+```bash
+yes
+```
+
+## Cleanup
+
+Run the following to remove the resources Terraform provisioned:
+
+```bash
+terraform destroy
+```
+```bash
+yes
+```

dialogflowcx_webhook_service_directory_standard/backing_file.tf

@@ -0,0 +1,15 @@
+# This file has some scaffolding to make sure that names are unique and that
+# a region and zone are selected when you try to create your Terraform resources.
+
+locals {
+  name_suffix = "${random_pet.suffix.id}"
+}
+
+resource "random_pet" "suffix" {
+  length = 2
+}
+
+provider "google" {
+  region = "us-central1"
+  zone   = "us-central1-c"
+}

dialogflowcx_webhook_service_directory_standard/main.tf

@@ -0,0 +1,45 @@
+resource "google_dialogflow_cx_agent" "agent" {
+  display_name = "dialogflowcx-agent-${local.name_suffix}"
+  location = "us-central1"
+  default_language_code = "en"
+  supported_language_codes = ["it","de","es"]
+  time_zone = "America/New_York"
+  description = "Example description."
+  avatar_uri = "https://cloud.google.com/_static/images/cloud/icons/favicons/onecloud/super_cloud.png"
+  enable_stackdriver_logging = true
+  enable_spell_correction    = true
+  speech_to_text_settings {
+    enable_speech_adaptation = true
+  }
+}
+
+
+resource "google_dialogflow_cx_webhook" "standard_webhook" {
+  parent       = google_dialogflow_cx_agent.agent.id
+  display_name = "MyFlow"
+  service_directory {
+    service = "projects/example-proj/locations/us-central1/namespaces/example-namespace/services/example-service"
+    generic_web_service {
+      allowed_ca_certs = ["BQA="]
+      uri = "https://example.com"
+      request_headers = { "example-key": "example-value" }
+      webhook_type = "STANDARD"
+      oauth_config {
+        client_id = "example-client-id"
+        secret_version_for_client_secret = "projects/example-proj/secrets/example-secret/versions/example-version"
+        token_endpoint = "https://example.com"
+        scopes = ["example-scope"]
+      }
+      service_agent_auth = "NONE"
+      secret_version_for_username_password = "projects/example-proj/secrets/example-secret/versions/example-version"
+      secret_versions_for_request_headers {
+        key = "example-key-1"
+        secret_version = "projects/example-proj/secrets/example-secret/versions/example-version"
+      }
+      secret_versions_for_request_headers {
+        key = "example-key-2"
+        secret_version = "projects/example-proj/secrets/example-secret/versions/example-version-2"
+      }
+    }
+  }
+}