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à.
# Integrazione di Salesforce
Con il connettore di azione Salesforce in Amazon Quick, puoi eseguire azioni all'interno delle organizzazioni Salesforce, tra cui la gestione dei record, l'interrogazione dei dati e l'interazione con le API di Salesforce. Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).
**Nota**
A partire dalla versione Salesforce Spring '26 (febbraio 2026), la creazione di nuove app connesse è disabilitata per impostazione predefinita in tutte le organizzazioni Salesforce. Questa guida utilizza le app client esterne (ECA) di Salesforce, che sono completamente compatibili con il connettore Amazon Quick Salesforce.
## Prerequisiti
Prima di configurare l'integrazione con Salesforce, assicurati di disporre di quanto segue:
+ Un'organizzazione Salesforce con accesso da amministratore di sistema.
+ Ruolo Amazon Quick Author o superiore.
+ L'URL della tua istanza Amazon Quick (ad esempio,`https://us-east-1.quicksight.aws.amazon.com`).
## Passaggio 1: creare un'app client esterna in Salesforce
Crea un'app client esterna (ECA) in Salesforce per abilitare l'autenticazione OAuth con Amazon Quick.
### Passa a External Client App Manager
1. Accedi alla tua organizzazione Salesforce e scegli **Configurazione** (icona a forma di ingranaggio in alto a destra).
1. Nel pannello di navigazione, espandi **Platform Tools** > **App > App per** **client esterni > External** **Client App Manager**.
1. Scegliete **Nuova app client esterna**.
### Inserisci le informazioni di base
Inserisci le seguenti informazioni di base per la tua app client esterna:
**Informazioni di base sull'app client esterna**
| Campo | Valore |
| --- | --- |
| Nome dell'app client esterna | Un nome descrittivo (ad esempio, «Amazon Quick Integration») |
| Nome API | Auto-generated dal nome dell'app |
| Email di contatto | Il tuo indirizzo email di amministratore |
| Stato di distribuzione | Locale (impostazione predefinita) |
## Passaggio 2: configurare le impostazioni OAuth
### Abilita OAuth
Nella sezione **API (Abilita impostazioni OAuth)**, seleziona **Abilita OAuth per espandere il pannello di configurazione OAuth**.
### Imposta l'URL di callback
Inserisci l'URL di callback Amazon Quick OAuth nel campo URL di **callback**:
`{{}}/sn/oauthcallback`
Ad esempio: `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`
### Aggiungi ambiti OAuth
**Sposta i seguenti ambiti da Ambiti OAuth **disponibili a Ambiti OAuth selezionati:****
+ Accedi al servizio di URL dell'identità (id, profile, email, address, phone)
+ Gestisci i dati degli utenti tramite API (api)
+ Gestisci i dati degli utenti tramite browser Web (web)
+ Accesso completo (completo)
+ Accedi alle applicazioni Visualforce (visualforce)
+ Esegui le richieste in qualsiasi momento (refresh\_token, offline\_access)
+ Accedi a identificatori utente univoci (openid)
+ Accedi alle autorizzazioni personalizzate (custom\_permissions)
+ Accedi alle risorse dell'API REST Connect (chatter\_api)
+ Accedi alle risorse dell'API REST di Analytics (wave\_api)
+ Access Analytics REST API Charts e risorse di geodati (eclair\_api)
+ Gestisci i servizi Pardot (pardot\_api)
### Abilita i flussi OAuth
Seleziona le seguenti opzioni di flusso:
+ **Abilita il flusso delle credenziali del cliente**
+ **Abilita il codice di autorizzazione e il flusso di credenziali**
+ **Abilita Token Exchange Flow**
### Abilita le impostazioni di sicurezza
Seleziona le seguenti opzioni di sicurezza:
+ **Richiedi Proof Key for Code Exchange (PKCE)**
+ **Richiedi Secret for Web Server Flow** (selezionato per impostazione predefinita)
+ **Richiedi segreto per Refresh Token Flow** (selezionato per impostazione predefinita)
Scegli **Crea** per salvare l'app client esterna.
## Fase 3: Ottieni le credenziali del consumatore
1. Dopo la creazione, si accede alla pagina dei dettagli di ECA.
1. Vai alla scheda **Impostazioni** o scegli **Gestisci i dettagli del consumatore**.
1. Potrebbe essere necessario verificare la tua identità (codice di verifica e-mail).
1. Copia la **Consumer Key** (Client ID) e **Consumer Secret** (Client Secret).
**Importante**
Salva queste credenziali in modo sicuro. Ne hai bisogno quando configuri il connettore in Amazon Quick.
## Fase 4: configurare il connettore Salesforce in Amazon Quick
### Passa a Connettori
1. Apri Amazon Quick e scegli **Connettori**.
1. Scegli la scheda **Crea per il tuo team**.
1. Trova e scegli **Salesforce**.
1. Se viene richiesto che esiste già un connettore, scegli **No, crea nuovo**.
### Inserite i dettagli della connessione
Inserisci i seguenti dettagli di connessione:
**Dettagli di connessione del connettore Salesforce**
| Campo | Valore |
| --- | --- |
| Nome | Un nome descrittivo (ad esempio, «Salesforce ECA») |
| Rete | Rete pubblica |
| Tipo di autenticazione | App OAuth personalizzata |
| URL di base | https://{{}}.my.salesforce.com/services/data/v60.0 |
| ID cliente | Consumer Key della fase 3 |
| Segreto del cliente | Consumer Secret tratto dalla fase 3 |
| URL del token | https://{{}}.my.salesforce.com/services/oauth2/token |
| URL di autorizzazione | https://{{}}.my.salesforce.com/services/oauth2/authorize |
| URL di reindirizzamento | Pre-filled (non modificare) |
Scegli **Successivo** per continuare.
## Fase 5: Verifica e pubblica
1. Nella pagina di **revisione**, verifica le azioni Salesforce disponibili (fino a 42 azioni).
1. Scegli **Avanti** per procedere alla condivisione degli utenti.
1. Seleziona gli utenti o i gruppi che devono avere accesso a questo connettore.
1. Scegliete **Pubblica** per pubblicare il connettore.
Dopo aver pubblicato il connettore, puoi utilizzare le azioni di Salesforce nella chat, nei flussi e nelle automazioni di Amazon Quick.
## Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni Salesforce:
+ Operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) su oggetti standard e personalizzati.
+ Interroga i dati di Salesforce utilizzando SOQL (Salesforce Object Query Language).
+ Gestisci lead, account, contatti e opportunità.
+ Esegui metodi Apex e logica personalizzata.
+ Gestisci casi, attività e attività.
+ Accedi a report e dashboard.
**Nota**
L'integrazione con Salesforce supporta solo l'esecuzione delle azioni. L'accesso ai dati e la creazione di knowledge base non sono disponibili per i sistemi Salesforce.
## Risoluzione dei problemi
Per modificare, condividere o eliminare il connettore, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations)
+ **Errore «L'URL non esiste più»**: assicurati di utilizzare il dominio Salesforce corretto nell'URL del token e nell'URL di autorizzazione. Non utilizzare endpoint legacy.
+ La **convalida OAuth non riesce**: verifica che PKCE sia abilitato su ECA e che l'URL di callback corrisponda esattamente all'URL dell'istanza Amazon Quick aggiunto. `/sn/oauthcallback`
+ **Errore sugli ambiti mancanti** ****: torna alla configurazione ECA in Salesforce e assicurati che tutti gli ambiti OAuth richiesti siano nell'elenco Selezionati e non siano ancora in Disponibile.****
+ L'**opzione «App connessa» è disattivata: è prevista dopo Salesforce Spring** '26. Utilizza invece un'app client esterna. Le ECA sono le sostituzioni supportate.