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
<a name="salesforce-integration"></a>

Con Salesforce action connector 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 Salesforce. APIs Questo connettore di azione supporta solo l'esecuzione delle attività e richiede il livello Amazon Quick Pro o superiore.

## Cosa puoi fare
<a name="salesforce-integration-capabilities"></a>

Con l'integrazione con Salesforce, puoi eseguire azioni all'interno delle tue organizzazioni Salesforce tramite l'Action Connector.

**Connettore Action**  
Crea, aggiorna e interroga oggetti Salesforce come lead, account, contatti e opportunità.

**Nota**  
L'integrazione con Salesforce non supporta l'accesso ai dati o la creazione di knowledge base. È progettato specificamente per l'esecuzione delle attività e le interazioni delle API con gli oggetti Salesforce.

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

Prima di configurare l'integrazione con Salesforce, assicurati di disporre di quanto segue:
+ Organizzazione Salesforce con autorizzazioni appropriate.
+ Credenziali di accesso all'app o all'API connessa a Salesforce.
+ Amazon Quick Author o versione successiva.
+ Accesso amministrativo per configurare OAuth le applicazioni (se si utilizza l'autenticazione utente).

## Passaggio 1: configura l'app connessa Salesforce
<a name="salesforce-connected-app-setup"></a>

**Nota**  
Crea un'app connessa in Salesforce. Non creare un'app client esterna. Le app client esterne non sono compatibili con questa integrazione.

Crea un'app connessa in Salesforce per abilitare OAuth l'autenticazione con Amazon Quick.

1. Accedi al tuo account Salesforce e vai alla pagina di configurazione utilizzando l'icona di configurazione in alto a destra.

1. Nella barra di ricerca rapida, inserisci**Apps**, quindi segui questi passaggi:
   + Seleziona **App client esterne**
   + Seleziona **Impostazioni**
   + In Impostazioni, crea una nuova app connessa

1. Scegli **Nuova app connessa**.

1. Scegli **Crea un'app connessa**.

1. Nella sezione Informazioni di base, inserisci le seguenti informazioni obbligatorie:
   + **Nome app connessa: un nome** descrittivo per l'app connessa.
   + **Nome API**: un nome API univoco per l'applicazione.
   + **Email di contatto**: il tuo indirizzo email di contatto.

1. Nella sezione OAuth Impostazioni, seleziona le seguenti caselle di controllo:
   + **Abilita impostazioni OAuth **
   +  **Richiedi l'estensione Proof Key for Code Exchange (PKCE) per i flussi di autorizzazione supportati (scelta** *consigliata*) 

      Abilita questa opzione per aggiungere un ulteriore livello di sicurezza al flusso del codice di autorizzazione.
   + **Richiedi segreto per Web Server Flow**
   + **Richiedi segreto per Refresh Token Flow**
   + **Abilita il flusso delle credenziali del client**
   + **Abilita il codice di autorizzazione e il flusso di credenziali**
   + **Abilita Token Exchange Flow**
   + **Richiedi segreto per Token Exchange Flow**

1. Aggiungi i seguenti OAuth ambiti obbligatori:
   + `api`- Accedi a Salesforce APIs
   + `refresh_token`- Mantieni l'accesso quando l'utente è offline
   + `offline_access`- Esegui le richieste in qualsiasi momento
   + `full`- Accesso completo a tutti i dati
   + `web`- Accesso basato sul Web
   + `visualforce`- Accedi alle pagine di Visualforce
   + `custom_permissions`- Accedi alle autorizzazioni personalizzate
   + `chatter_api`- Accedi all'API Chatter
   + `wave_api`- Accedi all'API di analisi
   + `eclair_api`- Accedi all'API di Einstein Analytics
   + `pardot_api`- Accedi all'API Pardot
   + `id`- Accedi alle informazioni sull'identità
   + `email`- Accesso all'indirizzo e-mail
   + `profile`- Accedere alle informazioni di base del profilo
   + `address`- Accesso alle informazioni sull'indirizzo
   + `phone`- Numero di telefono di accesso
   + `open_id`- Accedi a OpenID Connect

1. Inserisci l'URL di callback nel formato: `<quicksuite-url>/sn/oauthcallback`

1. Scegli **Save** (Salva).

## Passaggio 2: configura i dettagli del consumatore e l'utente di esecuzione
<a name="salesforce-consumer-details"></a>

Configura i dettagli del consumatore e configura un utente di esecuzione per il flusso di credenziali del client.

1. Dalla pagina Gestisci app connesse, scegli **Gestisci i dettagli del consumatore**. Potrebbe essere necessario verificare la tua identità.

1. Copia la **Consumer Key (Client ID)** e **Consumer Secret (Client Secret)**.

1. Scegli **Applica**.

1. Scegli **Initial Access Token**, quindi scegli **OK**.

1. Configura l'utente di esecuzione:

   1. Dalla pagina dei dettagli dell'app connessa, scegli **Modifica** nella colonna Azione.

   1. In OAuth Politiche > Aggiorna politica del token, seleziona **Scadenza immediata del token di aggiornamento**.

   1. In Client Credentials Flow, per Run As, scegli l'utente a cui assegnare il flusso di credenziali del client.

   1. Scegli **Save** (Salva).

## Passaggio 3: configurare il connettore di azione Salesforce
<a name="salesforce-integration-setup"></a>

Dopo aver preparato le credenziali dell'app connessa a Salesforce, crea il connettore di azione Salesforce in Amazon Quick.

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.

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

1. Scegli **Salesforce** tra le opzioni di integrazione e fai clic sul pulsante Aggiungi (più «\$1»).

1. Inserisci i dettagli dell'integrazione:
   + **Nome: nome** descrittivo del connettore di azione Salesforce.
   + **Descrizione** (opzionale): scopo del connettore d'azione.

1. Scegli il tipo di connessione:
   + **Autenticazione utente**: autenticazione OAuth basata sull'accesso dei singoli utenti.
   + Autenticazione del **servizio: Service-to-service autenticazione** per l'accesso alle applicazioni.

1. Compila le impostazioni di connessione in base al metodo di autenticazione selezionato (utente o servizio):

   1. Per **l'autenticazione utente (OAuth)**, configura i seguenti campi:
     + **URL di base: URL dell'**istanza Salesforce (ad esempio, https://your-domain.salesforce.com).
     + **ID client: chiave utente** dell'app connessa Salesforce.
     + **Client Secret: segreto** per il consumatore dell'app connessa Salesforce.
     + **URL del token: endpoint del token** Salesforce OAuth .
     + **URL di autenticazione: endpoint** di autorizzazione Salesforce. OAuth 
     + **URL di reindirizzamento**: URI di OAuth reindirizzamento configurato nell'app connessa.

1. Seleziona **Crea e continua.**

1. Scegli gli utenti con cui condividere l'integrazione.

1. Fare clic su **Avanti**.

## Fase 4: Associare Action Connector ai gruppi di automazione
<a name="salesforce-automation-group-setup"></a>

Per utilizzare le azioni Salesforce nelle automazioni, devi associare il connettore di azione ai tuoi gruppi di automazione.

1. Passa alle impostazioni del gruppo di automazione.

1. Associa il connettore di azione Salesforce al gruppo di automazione che utilizzerà queste azioni.

1. Crea una nuova automazione per il gruppo di automazione per accedere alle azioni di Salesforce nei tuoi flussi di lavoro.

## Azioni delle attività disponibili
<a name="salesforce-integration-actions"></a>

Dopo aver creato l'integrazione con Salesforce, puoi esaminare le azioni disponibili per interagire con gli oggetti Salesforce. Le azioni più comuni di Salesforce includono:
+ 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.

## Condividi le integrazioni
<a name="salesforce-integration-sharing"></a>

Puoi condividere gli action connector di Salesforce con altri utenti della tua organizzazione. Completare la procedura riportata di seguito.

1. Dopo aver creato l'integrazione, scegli **Condividi** integrazione.

1. Seleziona utenti o gruppi con cui condividere l'integrazione.

1. Imposta le autorizzazioni appropriate per l'accesso condiviso.

1. Conferma le impostazioni di condivisione.

Gli utenti condivisi possono utilizzare l'integrazione Salesforce per eseguire azioni all'interno dell'organizzazione Salesforce connessa, in base alle autorizzazioni configurate nella configurazione di autenticazione originale.

## Gestisci i connettori di azione Salesforce
<a name="salesforce-integration-management"></a>

Dopo aver creato il connettore di azione Salesforce, puoi gestirlo utilizzando queste opzioni:
+ **Modifica connettore di azione:** aggiorna le impostazioni di autenticazione o la configurazione dell'istanza Salesforce.
+ **Share Action Connector**: rendi disponibile il connettore di azione agli altri utenti della tua organizzazione.
+ **Monitora l'utilizzo**: visualizza l'attività dell'Action Connector e le metriche di utilizzo dell'API.
+ **Azioni di revisione**: consulta l'elenco completo delle azioni Salesforce disponibili.
+ **Elimina connettore di azione:** rimuove il connettore di azione e revoca l'autenticazione associata.