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
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, consultaMetodi di autenticazione.
Prima di iniziare
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
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 Quickstartsul sito web di Slack. -
Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.
Configurazione di Slack
Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e vai a. Configurazione del connettore in Amazon Quick
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
Crea un'app Slack per ottenere le credenziali del client o il token bot di cui hai bisogno per Amazon Quick.
-
Vai alla dashboard dell'API Slack
sul sito web di Slack e scegli Crea nuova app. -
Scegli Da zero.
-
Inserisci un nome per l'app e seleziona il tuo spazio di lavoro Slack. Scegli Create App (Crea app).
-
Nella barra laterale sinistra, scegli OAuth e autorizzazioni.
-
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/oauthcallbackScegli Aggiungi, quindi scegli Salva URL.
-
In Scopes, aggiungi i Bot Token Scopes richiesti dalla tua integrazione. Per gli ambiti consigliati, vedi. Ambiti consigliati
-
Nella barra laterale sinistra, scegli Informazioni di base. In Credenziali dell'app, registra i seguenti valori:
-
ID cliente
-
Client secret
-
-
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
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.
| 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 estars: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
Configurazione del connettore in Amazon Quick
Connect dalla scheda Available
Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda Disponibile senza configurazioni aggiuntive.
-
Nella console Amazon Quick, scegli Connettori.
-
Nella scheda Disponibile, trova Slack e scegli Connect.
-
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
Dopo aver completato la configurazione Slack richiesta, crea il connettore in Amazon Quick.
-
Nella console Amazon Quick, scegli Connettori.
-
Scegli la scheda Crea per il tuo team.
-
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.
-
Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.
-
Per Tipo di connessione, scegli Rete pubblica.
-
Per la configurazione OAuth, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
-
Per l'app OAuth predefinita:
Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.
-
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.
-
-
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-).
-
-
-
Scegli Next (Successivo).
-
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.
-
Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).
-
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.
-
Seleziona Pubblica.
Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
| 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
Per modificare, condividere o eliminare il connettore, consultaGestione delle integrazioni esistenti.
Problemi di autenticazione
-
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.
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.
-
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.
