Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# ZoomInfo integrazione
<a name="zoominfo-integration"></a>

Con l' ZoomInfo Action Connector, puoi cercare dati aziendali e di contatto e interrogare dati firmografici e di intenti direttamente in Amazon Quick tramite linguaggio naturale.

Amazon Quick supporta diversi metodi di autenticazione per ZoomInfo. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio ZoomInfo account.
+ App **OAuth personalizzata: utilizza un'applicazione** OAuth gestita dal cliente. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.
+ **Service-to-Service OAuth**: utilizza le credenziali del client per l'autenticazione da server a server senza l'interazione dell'utente. Adatto per flussi di lavoro automatizzati.
+ **Chiave API**: utilizza una chiave API per l'autenticazione.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).

## Prima di iniziare
<a name="zoominfo-integration-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un ZoomInfo account attivo con accesso ai prodotti di dati che desideri interrogare.
+ Per l'**app OAuth personalizzata** o **Service-to-Service OAuth: credenziali OAuth** dell'amministratore. ZoomInfo ZoomInfo utilizza Okta per OAuth.
+ Per la **chiave API: una ZoomInfo-issued chiave API**.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).

## Configurazione ZoomInfo
<a name="zoominfo-source-setup"></a>

Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#zoominfo-quicksuite-setup)

Per l'app OAuth personalizzata o l'autenticazione Service-to-Service OAuth, collabora con il tuo ZoomInfo amministratore per registrare un client OAuth nel tenant ZoomInfo Okta e aggiungere l'URL di callback Amazon Quick come URI di reindirizzamento. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` Sostituiscilo con la tua regione (ad esempio,). {{{region}}}AWS`us-east-1` Per istruzioni dettagliate, consulta [ZoomInfo MCP Overview](https://docs.zoominfo.com/docs/zi-api-mcp-overview/) and [Developer Portal Guide](https://docs.zoominfo.com/docs/app-creation-developer-portal-guide) nella documentazione. ZoomInfo Registra l'ID cliente e il segreto del cliente: ti servono quando configuri Amazon Quick. Per l'autenticazione tramite chiave API, genera una chiave API dal tuo ZoomInfo account.

## Configurazione del connettore in Amazon Quick
<a name="zoominfo-quicksuite-setup"></a>

### Connect dalla scheda Available
<a name="zoominfo-quick-connect"></a>

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.

1. Nella console Amazon Quick, scegli **Connettori**.

1. Nella scheda **Disponibile**, trova **ZoomInfo**e scegli **Connect**.

1. Completa il flusso di ZoomInfo accesso e concedi le autorizzazioni richieste.

Per configurare un connettore con uno degli altri metodi di autenticazione, usa la scheda **Crea per il tuo team** come descritto di seguito.

### Crea dalla scheda Crea per il tuo team
<a name="zoominfo-full-setup"></a>

1. Nella console Amazon Quick, scegli **Connettori**.

1. Scegli la scheda **Crea per il tuo team**.

1. Trova e scegli **ZoomInfo**.

1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.

1. Per **Tipo di connessione**, scegli **Rete pubblica**.

1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

   1. Per l'app **OAuth predefinita:**

      Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.

   1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
      + **ID client**: l'ID client del tuo client ZoomInfo OAuth.
      + **Client OAuth pubblico** (opzionale): seleziona questa opzione se il client ZoomInfo OAuth è configurato come client pubblico (nessun client segreto).
      + **Segreto del client: il segreto** del client OAuth. ZoomInfo 
      + **URL del token: l'**endpoint del token. Impostazione predefinita: `https://okta-login.zoominfo.com/oauth2/default/v1/token`
      + **URL di autorizzazione: l'**endpoint di autorizzazione. Impostazione predefinita: `https://okta-login.zoominfo.com/oauth2/default/v1/authorize`
      + URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.

   1. Per **Service-to-ServiceOAuth**, configura i seguenti campi:
      + **ID client**: l'ID client del tuo client ZoomInfo OAuth.
      + **Segreto del cliente**: il segreto del client ZoomInfo OAuth.
      + **URL del token: l'**endpoint del token. Impostazione predefinita: `https://okta-login.zoominfo.com/oauth2/default/v1/token`

   1. Per **API Key**, configura i seguenti campi:
      + **Chiave API**: la chiave ZoomInfo API.
      + **Email** (opzionale): l'indirizzo e-mail associato alla chiave API.

1. Scegli **Next (Successivo)**.

1. Se hai scelto l'app **OAuth predefinita o l'app** **OAuth personalizzata, si apre una ZoomInfo finestra** di autorizzazione. **Controlla le autorizzazioni richieste e scegli Consenti.**

1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.

1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

1. Seleziona **Pubblica**.

## Operazioni disponibili
<a name="zoominfo-integration-actions"></a>

Dopo aver configurato il connettore, ZoomInfo sono disponibili le azioni esposte da. Per visualizzare l'attuale set di azioni per il tuo connettore, vai alla visualizzazione **Azioni disponibili** del connettore nella console Amazon Quick.

## Gestione e risoluzione dei problemi
<a name="zoominfo-integration-troubleshooting"></a>

Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).

### Problemi di autenticazione
<a name="zoominfo-troubleshooting-auth"></a>
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo ZoomInfo account sia attivo. Per l'app Custom OAuth, verifica che l'URI di reindirizzamento nel tuo ZoomInfo client OAuth corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata o Service-to-Service OAuth): verifica che l'ID client e il segreto del client corrispondano ai valori del client OAuth**. ZoomInfo 
+ L'**autenticazione della chiave API non riesce**: verifica che la chiave API non sia stata revocata.