Skill Publish to Google from Voiceworx

Skill Publish to Google

To publish skills to Google from Voiceworx portal there are few steps to follow and they are as follows.

Step 1: Generate Client ID and Client Secret

The very first step is to generate Client Id and Client Secret. This information will be later used to authenticate users. To Generate Client Id and Secret Key follow the steps below.

If you have already generated credentials then you can jump to step 1.3.

Step 1.1: Create OAuth Client Id

To generate client id and client secret first you need to go to Google Cloud. In the left side navigation menu, select ‘APIs & services’ menu and then ‘Credentials’. See figure below.

After selecting ‘Credentials’, It will navigate you to a new page. On that page, select ‘+ Create Credentials’ button and select ‘Oauth client ID’ sub menu. See figure below.

After selecting the ‘OAuth client ID’ menu, it will navigate you to the Configure consent screen.

Step 1.2: Configure Consent Screen

On the consent screen, click on the ‘Configure Consent Screen’ button and fill up the consent form.

Step 1.3: Manage Authorized redirect URIs

After filling up the Consent form, you need to add Redirect URLs to the Client Id profile. To do that, select the OAuth Client ID profile that you have created.

After selecting the Client Id profile, It will navigate you to the Client Id profile detail page. You can find the ‘Authorized redirect URIs’ section. See figure below. You need to add three redirect URLs there and Save the configuration. Three Redirect URLs are as follows:

1. https://localhost:44379/api/RedirectPage

2. https://servicetest.voiceworx.ai/api/RedirectPage

3. https://service.voiceworx.ai/api/RedirectPage

You can find the ‘Client Id’ and ‘Client Secret’ keys on the right section. Copy those information, you will need to feed this information in following steps. See figure below.

Step 2: Manage Integration

After Completing Step 1, Next step is to configure integration in the Voiceworx platform. There are few steps for managing integration and are as follows.

Step 2.1: Add New Connection

To add a new connection. Select ‘Integration > Connect System’ from the left side menu.

Clicking on the menu will navigate to a new page. Click on the ‘Add New Connection’ button will popup a modal, from where you can input values for connection. On the popup modal, select ‘Custom’ option in Select Integration Category, and select ‘Google Assistant’ option in System Type field. Then click on the ‘Connect System’ button. See figure below.

Clicking on the Connect System button will navigate you to a new page where you need to input values to multiple fields. In the form you need to add the ‘Client Id’ and ‘Client Secret’ that you have generated in the previous step. You also need other information and are as follows.

Authorization URL: https://accounts.google.com/o/oauth2/auth Token URL: https://oauth2.googleapis.com/token

Scope: https://www.googleapis.com/auth/cloud-platform

After filling up all the fields click on ‘Validate and Save Setting’ button. See figure below.

Step 3: App Publishing

After completing Step 2, the next step is related to app publishing.

Step 3.1: Add App Publishing

For adding app publishing, go to ‘App > Custom Apps’ from the left side menu. Select the app that you need to publish to Google. Go to the ‘Publish’ tab and click on the ‘Add App Publishing’ button. Clicking such a button will popup a modal, where you need to fill up the form. Select the ‘Search’ option in the App type field, and select ‘Google Assistant’ option in the Channel field. Add all message fields and then click on the ‘Save’ button.

After adding app publishing, you can find the added app publish on the list. See the figure below.

Step 3.2: Publish to Google

To publish an app to google select the app publishing that you have added from the previous step. Click on the right most action column of the publishing. Select ‘Publish To Google’ submenu. See figure below.

It will navigate you to the next page, where you need to select the ‘Integration’ that you created from step 2.1 in the option field. Click on the ‘Publish to Google’ button. See figure below.

To publish an app to Google, your account needs to get authenticated. After clicking on the ‘Publish To Google’ button it will open a new tab in the browser and ask for Google Authentication. See figure below.

After authenticating the google account, the app publishing to google starts. See figure below.

After publishing success, a new model will pop up on the screen. See the figure below.

Step 4: Finalize Skill Manually in Dialog Flow

Skill Publish is not complete yet, there are still few more steps that need to be done manually from the dialog flow console. To do that go to the next tab ‘Additional Manual Steps’. On that tab click on the ‘Finalize Skill Manually’ button. Doing that will open documentation on a new tab in the browser. Follow those steps to complete the setup. See the figure below.

For adding manual steps go to, Dialog Flow console.

Step 5: Test App in Actions Console

After completing manual setup steps, you can now test the application in the dialog flow console. To test, select ‘Integration’ menu in left side navigation and click on the integration hyperlink on the page. See figure below.

Clicking on the hyperlink will popup a modal as shown in the figure below. Click on the ‘Test’ button that will navigate you to the Test Screen.