Attivare gli insight sulla customer experience

Prima di utilizzare Customer Experience Insights (CX Insights) per analizzare i dati conversazionali, devi abilitare API specifiche.

In questa guida rapida, completerai le seguenti azioni:

  1. Abilita le API:

  2. Invia una richiesta all'API Contact Center AI Insights e ricevi una risposta.

  3. (Facoltativo) Utilizza CX Insights con i Controlli di servizio VPC.

Prima di iniziare

I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Cloud Speech-to-Text, Cloud Storage, Contact Center AI Insights, Dialogflow, and Sensitive Data Protection (DLP) APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

Inviare una richiesta e ricevere una risposta

  1. Installa e configura Google Cloud CLI. Puoi configurare gcloud CLI in uno dei seguenti ambienti di sviluppo:

    Cloud Shell

    Per utilizzare un terminale online con gcloud CLI già configurata, attiva Cloud Shell:

    Nella parte inferiore di questa pagina viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. L'inizializzazione della sessione può richiedere alcuni secondi.

    Shell locale

    Per utilizzare un ambiente di sviluppo locale:

    1. Installa gcloud CLI.
    2. Inizializza gcloud CLI.

  2. Crea le credenziali di autenticazione locali per il tuo account utente: 

    gcloud auth application-default login

    Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

  3. Verifica la configurazione eseguendo questo comando, che elenca tutte le conversazioni di CX Insights.

    curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/conversations"

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto Google Cloud .
    • LOCATION: la regione in cui esegui questa richiesta.

    Il comando deve restituire un dizionario vuoto: {}.

(Facoltativo) Utilizza CX Insights con i Controlli di servizio VPC

Per utilizzare CX Insights con i Controlli di servizio VPC, aggiungi CX Insights al perimetro di sicurezza. Per saperne di più, consulta la documentazione sui Controlli di servizio VPC.

Passaggi successivi