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 con Slack
<a name="slack-integration"></a>

Con il connettore d'azione Slack, puoi accedere alla piattaforma Slack direttamente in Amazon Quick tramite linguaggio naturale. Puoi inviare messaggi, gestire canali, cercare contenuti e interagire con utenti e gruppi di utenti senza uscire da Amazon Quick.

Amazon Quick supporta diversi metodi di autenticazione per Slack. 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. Ti autentichi direttamente con il tuo spazio di lavoro Slack.
+ App **OAuth personalizzata: utilizza un'app Slack gestita** dal cliente. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth.
+ Token **Bearer: utilizza un token** bot Slack per l'autenticazione. Questo metodo è adatto per l'accesso a livello di bot a uno spazio di lavoro.

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

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

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un'area di lavoro Slack con accesso ai canali e ai dati che desideri utilizzare.
+ Per l'**app OAuth personalizzata**: accedi alla [dashboard dell'API Slack](https://api.slack.com/apps) sul sito web di Slack per creare un'app.
+ Per **Bearer Token: un token** bot (inizia con`xoxb-`) proveniente da un'app Slack. Per ulteriori informazioni, consulta le [impostazioni dell'app Quickstart](https://docs.slack.dev/app-management/quickstart-app-settings) sul sito web di Slack.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).

## Configurazione di Slack
<a name="slack-source-setup"></a>

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

Per l'autenticazione personalizzata dell'app OAuth o del token Bearer, completa i passaggi applicabili in Slack prima di configurare Amazon Quick.

### Crea un'app Slack per l'app OAuth personalizzata o il token Bearer
<a name="slack-register-oauth"></a>

Crea un'app Slack per ottenere le credenziali del client o il token bot di cui hai bisogno per Amazon Quick.

1. **Vai alla [dashboard dell'API Slack](https://api.slack.com/apps) sul sito web di Slack e scegli Crea nuova app.**

1. Scegli **Da** zero.

1. Inserisci un **nome per l'app** e seleziona il tuo spazio di lavoro Slack. Scegli **Create App (Crea app)**.

1. Nella barra laterale sinistra, scegli **OAuth** e autorizzazioni.

1. In **URL di reindirizzamento**, scegli **Aggiungi nuovo URL di reindirizzamento e inserisci l'URL** di callback di Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   **Scegli **Aggiungi**, quindi scegli Salva URL.**

1. In **Scopes**, aggiungi i Bot Token Scopes richiesti dalla tua integrazione. Per gli ambiti consigliati, vedi. [Ambiti consigliati](#slack-oauth-scopes)

1. Nella barra laterale sinistra, scegli **Informazioni di base**. In **Credenziali dell'app**, registra i seguenti valori:
   + **ID cliente**
   + **Client secret**

1. Per **Bearer Token**: installa l'app nel tuo spazio di lavoro dalla pagina **OAuth** e autorizzazioni. Dopo l'installazione, copia il token **OAuth dell'utente bot** (inizia con). `xoxb-`

### Ambiti consigliati
<a name="slack-oauth-scopes"></a>

I seguenti ambiti sono richiesti quando ti connetti a Slack. Quando crei un'app Slack personalizzata, aggiungi questi ambiti nella pagina **OAuth** e autorizzazioni. **Per l'app OAuth personalizzata, aggiungili come User Token Scopes.** **Per Bearer Token, aggiungili come Bot Token Scopes.**


**Ambiti consigliati da Slack**  

| Scope | Description | 
| --- | --- | 
| calls:read | Legge le informazioni sulla chiamata. | 
| calls:write | Crea e gestisce le chiamate. | 
| channels:history | Legge la cronologia dei messaggi nei canali pubblici. | 
| channels:read | Legge informazioni sui canali pubblici. | 
| channels:write | Gestisce i canali pubblici. | 
| chat:write | Invia messaggi a canali e conversazioni. | 
| dnd:read | Legge le impostazioni Do Not Disturb. | 
| dnd:write | Aggiorna le impostazioni Do Not Disturb. | 
| emoji:read | Legge emoji personalizzate. | 
| files:read | Legge i file condivisi nei canali. | 
| files:write | Carica e gestisce i file. | 
| groups:history | Legge la cronologia dei messaggi nei canali privati. | 
| groups:read | Legge le informazioni sui canali privati. | 
| groups:write | Gestisce i canali privati. | 
| im:history | Legge la cronologia dei messaggi nei messaggi diretti. | 
| im:read | Legge le informazioni sui messaggi diretti. | 
| im:write | Avvia messaggi diretti. | 
| links:read | Legge le anteprime dei link. | 
| links:write | Gestisce le anteprime dei link. | 
| mpim:history | Legge la cronologia dei messaggi nei messaggi diretti di gruppo. | 
| mpim:read | Legge le informazioni sui messaggi diretti di gruppo. | 
| mpim:write | Avvia messaggi diretti di gruppo. | 
| pins:read | Legge i messaggi bloccati. | 
| pins:write | Blocca e sblocca i messaggi. | 
| reactions:read | Legge le reazioni emoji sui messaggi. | 
| reactions:write | Aggiunge e rimuove le reazioni emoji. | 
| reminders:read | Legge i promemoria. | 
| reminders:write | Crea promemoria. | 
| remote\_files:read | Legge i file remoti. | 
| remote\_files:share | Condivide file remoti. | 
| search:read | Cerca messaggi e file. | 
| stars:read | Legge gli elementi contrassegnati con un asterisco. | 
| stars:write | Stella e toglie le stelle agli oggetti. | 
| team:read | Legge le informazioni sull'area di lavoro. | 
| usergroups:read | Legge le informazioni sul gruppo di utenti. | 
| usergroups:write | Gestisce i gruppi di utenti. | 
| users:read | Legge le informazioni sull'utente. | 
| users:read.email | Legge gli indirizzi e-mail degli utenti. | 
| users:write | Aggiorna le informazioni dell'utente. | 
| users.profile:read | Legge le informazioni del profilo utente. | 
| users.profile:write | Aggiorna le informazioni del profilo utente. | 

**Nota**  
Non tutti gli ambiti sono disponibili sia per gli User Token Scopes che per i Bot Token Scopes. Alcuni ambiti, come `search:read` e`stars:read`, sono disponibili solo come User Token Scopes. Quando configuri gli ambiti per l'autenticazione Bearer Token, verifica la disponibilità degli ambiti nel riferimento agli [ambiti dell'API Slack](https://api.slack.com/scopes) sul sito web di Slack.

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

### Connect dalla scheda Available
<a name="slack-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 **Slack** e scegli **Connect**.

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

Per configurare invece un connettore con l'app OAuth personalizzata o il token Bearer, usa la scheda **Crea per il tuo** team come descritto di seguito.

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

Dopo aver completato la configurazione Slack richiesta, crea il connettore in Amazon Quick.

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

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

1. Trova e scegli **Slack**.
**Nota**  
Se esiste già un connettore Slack, viene visualizzata una finestra di dialogo con i connettori esistenti. Per usare un connettore esistente, sceglilo. Per crearne uno nuovo, scegli **No, crea nuovo**.

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:
      + **URL di base** (opzionale): l'URL di base dell'API Slack. Ad esempio: `https://slack.com/api`
      + **ID cliente**: l'ID cliente dell'app Slack.
      + **Segreto del cliente**: il segreto del client dell'app Slack.
      + **URL del token: l'**endpoint del token. Ad esempio: `https://slack.com/api/oauth.v2.access`
      + **URL di autorizzazione: l'**endpoint di autorizzazione. Ad esempio: `https://slack.com/oauth/v2/authorize`
      + URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.

   1. Per **Bearer Token**, configura i seguenti campi:
      + **URL di base** (opzionale): l'URL di base dell'API Slack. Ad esempio: `https://slack.com/api`
      + **Bot token**: il tuo token bot Slack (inizia con`xoxb-`).

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

1. Se scegli l'app **OAuth predefinita o l'app OAuth** **personalizzata, si apre una finestra di autorizzazione** Slack. **Controlla le autorizzazioni richieste, seleziona l'area di lavoro 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="slack-integration-actions"></a>

Dopo aver configurato il connettore, sono disponibili le seguenti azioni.


**Azioni disponibili su Slack**  

| Categoria | Azione | Description | 
| --- | --- | --- | 
| Messaggi | Chat Pubblica un messaggio | Pubblica un messaggio su un canale, un messaggio diretto o un gruppo privato. | 
| Messaggi | Inviami un messaggio | Invia un messaggio di azione in terza persona a un canale. | 
| Messaggi | Ottieni il link permanente del messaggio | Recupera un URL di permalink per un messaggio specifico. | 
| Canali | Conversazioni Crea | Crea un canale pubblico o privato. | 
| Canali | Cronologia delle conversazioni | Recupera la cronologia dei messaggi da un canale. Restituisce solo i messaggi della timeline principale, non le risposte in thread. | 
| Canali | Conversazioni e risposte | Recupera le risposte in thread a uno specifico messaggio principale. | 
| Canali | Invito alle conversazioni | Invita gli utenti a accedere a un canale esistente. | 
| Canali | Conversazioni Parteci | Si unisce a un canale esistente. | 
| Canali | Conversazioni Kick | Rimuove un utente da un canale. | 
| Canali | Conversazioni terminano | Lascia un canale. | 
| Canali | Membri delle conversazioni | Elenca gli ID dei membri di un canale. | 
| Canali | Conversazioni aperte | Apre o riprende un messaggio diretto o un messaggio diretto composto da più persone. | 
| Canali | Conversazioni Imposta argomento | Imposta o aggiorna l'argomento di un canale. | 
| Canali | Inizia una conversazione | Recupera i metadati di un canale in base all'ID. | 
| Canali | Elenca i canali | Elenca i canali disponibili per l'utente. | 
| Canali | Elenca le conversazioni per l'utente | Elenca i canali e i messaggi diretti accessibili a un utente. | 
| Reazioni | Crea reazione | Aggiunge una reazione emoji a un messaggio. | 
| Reazioni | Elimina reazione | Rimuove una reazione emoji da un messaggio. | 
| Reazioni | Elenca le reazioni | Elenca le reazioni a un messaggio, file o commento al file. | 
| File | Carica o crea file | Carica file o contenuti multimediali su canali o thread. | 
| File | Carica su URL esterno | Aggiunge un riferimento a un file esterno per la condivisione in Slack. | 
| File | Scarica il file | Scarica un file condiviso in Slack. | 
| File | Informazioni sui file | Recupera metadati e commenti relativi a un file. | 
| File | Elenco dei file | Elenca i file in un'area di lavoro con filtri opzionali. | 
| Cerca | Cerca tutto | Cerca messaggi e file nell'area di lavoro. | 
| Cerca | Cerca nei messaggi | Cerca messaggi con intervalli di date e filtri. | 
| Cerca | Canali di ricerca | Cerca i canali per nome, argomento o scopo. | 
| Cerca | Cerca utenti | Cerca gli utenti per e-mail, nome o nome visualizzato. | 
| Cerca | Contesto di ricerca | Ricerche tra messaggi, file, canali e utenti. Supporta la ricerca semantica negli spazi di lavoro con Slack AI. | 
| Cerca | Ottieni la configurazione della ricerca | Verifica se la ricerca semantica è disponibile nell'area di lavoro. | 
| Utenti | Ottenimento dei dettagli dell'utente | Recupera le informazioni per un utente in base all'ID. | 
| Utenti | Ottieni il profilo utente | Recupera le informazioni sul profilo di un utente. | 
| Utenti | Set di profili utente | Aggiorna i campi del profilo di un utente. | 
| Utenti | Elenco utenti | Elenca tutti gli utenti presenti nell'area di lavoro. | 
| Gruppi di utenti | Creazione di gruppi di utenti | Crea un nuovo gruppo di utenti. | 
| Gruppi di utenti | Elenco dei gruppi di utenti | Elenca i gruppi di utenti presenti nell'area di lavoro. | 
| Gruppi di utenti | Gruppi di utenti - Aggiornamento degli utenti | Sostituisce tutti i membri di un gruppo di utenti. | 
| Promemoria | Promemoria Aggiungi | Crea un promemoria con testo e ora specificati. | 
| Workspace | Get Team | Recupera i metadati relativi all'area di lavoro di Slack. | 

**Nota**  
Le azioni che puoi utilizzare dipendono dagli ambiti configurati per l'app Slack e dai canali accessibili all'utente autenticato.

## Gestione e risoluzione dei problemi
<a name="slack-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="slack-troubleshooting-auth"></a>
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**[: verifica che l'area di lavoro Slack sia attiva e di poter accedere direttamente al sito web di Slack.](https://slack.com) Per l'app OAuth personalizzata, verifica che l'URL di reindirizzamento nell'app Slack corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID cliente e il segreto del cliente corrispondano ai valori nella sezione Informazioni di base dell'app Slack.
+ **Token Bearer rifiutato**: verifica che il token bot sia attivo e inizi con. `xoxb-` I token possono essere revocati dalla dashboard dell'API Slack.
+ **Autorizzazioni insufficienti**: verifica che gli ambiti configurati per la tua app Slack includano le autorizzazioni necessarie per le azioni che desideri utilizzare. Per informazioni, consulta [Ambiti consigliati](#slack-oauth-scopes).
+ **Canale non trovato o non presente nel canale**: verifica che il bot sia stato aggiunto al canale. Invita il bot a entrare nel canale prima di provare a pubblicare messaggi o leggere la cronologia.