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, consultaConfigura le integrazioni nella console.
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
-
Accedi alla tua organizzazione Salesforce e scegli Configurazione (icona a forma di ingranaggio in alto a destra).
-
Nel pannello di navigazione, espandi Platform Tools > App > App per client esterni > External Client App Manager.
-
Scegliete Nuova app client esterna.
Inserisci le informazioni di base
Inserisci le seguenti informazioni di base per la tua 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:
<your-quick-instance-url>/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
-
Dopo la creazione, si accede alla pagina dei dettagli di ECA.
-
Vai alla scheda Impostazioni o scegli Gestisci i dettagli del consumatore.
-
Potrebbe essere necessario verificare la tua identità (codice di verifica e-mail).
-
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
-
Apri Amazon Quick e scegli Connettori.
-
Scegli la scheda Crea per il tuo team.
-
Trova e scegli Salesforce.
-
Se viene richiesto che esiste già un connettore, scegli No, crea nuovo.
Inserite i dettagli della connessione
Inserisci i seguenti dettagli di connessione:
| Campo | Valore |
|---|---|
| Nome | Un nome descrittivo (ad esempio, «Salesforce ECA») |
| Rete | Rete pubblica |
| Tipo di autenticazione | App OAuth personalizzata |
| URL di base | https:// |
| ID cliente | Consumer Key della fase 3 |
| Segreto del cliente | Consumer Secret tratto dalla fase 3 |
| URL del token | https:// |
| URL di autorizzazione | https:// |
| URL di reindirizzamento | Pre-filled (non modificare) |
Scegli Successivo per continuare.
Fase 5: Verifica e pubblica
-
Nella pagina di revisione, verifica le azioni Salesforce disponibili (fino a 42 azioni).
-
Scegli Avanti per procedere alla condivisione degli utenti.
-
Seleziona gli utenti o i gruppi che devono avere accesso a questo connettore.
-
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
-
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.
