Before you begin

You must enable the following APIs for conversation data processing in Conversational Insights:

  • Insights API to use Insights.
  • Cloud Storage API to ingest conversations into Insights.
  • Speech-to-Text API to upload audio files.
  • Cloud Data Loss Prevention API to perform redaction on audio or transcript files.
  • Dialogflow API, which is required for Dialogflow runtime integration and Topic modeling V1.

This quickstart walks you through the following actions:

  1. Enable the Cloud Storage API, Cloud Data Loss Prevention API, Speech-to-Text, and Dialogflow APIs.
  2. Enable the Insights API.
  3. Successfully send a request to the Insights API and receive a response.

Enable the Cloud Storage API, Cloud Data Loss Prevention API, Speech-to-Text, and Dialogflow APIs.

You must enable the Cloud Storage API before you can use Cloud Storage. To enable APIs:

  1. Navigate to the Google Cloud console.

  2. Click Go to APIs overview:

  3. On the APIs & Services page that appears, click Cloud Storage.

  4. If you haven't already enabled this API, click Enable.

  5. Repeat the preceding steps for the Speech-to-Text API, Cloud Data Loss Prevention API, and the Dialogflow API.

Set up Insights API access

  1. Navigate to the Google Cloud console.
  2. Click the project selector menu:
  3. Select a pre-existing project or create a new project.
  4. Enter Conversational Insights API into the Google Cloud console search bar.
  5. Click the option that pops up and select Enable.
  6. Install and set up the Google Cloud SDK.
  7. Set up authentication to Google Cloud.

  8. Verify your setup by entering the following CURL command, which lists all of your Insights conversations. It should return an empty dictionary:

    curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://contactcenterinsights.googleapis.com/v1/projects/<var>project-id</var>/locations/us-central1/conversations"

Optional: Use Insights with VPCSC

To use Insights with VPC Service Controls (VPC Service Controls), add Insights to your security perimeter. See the VPCSC documentation for more information.