Introduzione
Connettere Slack affinché l'assistente IA e gli agenti possano cercare nei canali selezionati nel momento in cui un utente pone una domanda.
Questo è un connettore in tempo reale. Nessun contenuto di Slack viene copiato, indicizzato o archiviato in Docebo. Quando un utente pone una domanda, Docebo esegue la ricerca, in quel momento, nei canali resi disponibili, utilizzando l'account Slack dell'utente stesso.
Come funzionano i permessi per Slack: ogni collega connette il proprio account Slack la prima volta che è necessario. Ogni ricerca viene quindi eseguita a nome di quell'utente, che vede solo ciò che potrebbe aprire personalmente in Slack. L'account utilizzato durante la configurazione serve unicamente a configurare la connessione e a elencare i canali tra cui scegliere.
1. Prerequisiti nel sistema sorgente
Ruolo richiesto
È necessario disporre del permesso di creare app nel workspace Slack. Se il workspace richiede l'approvazione dell'amministratore per le nuove app, un amministratore del workspace deve approvare l'app una sola volta (vedere il passaggio 3).
Impostazioni richieste
L'account utilizzato per l'autorizzazione deve essere membro di tutti i canali privati da rendere disponibili.
2. Preparazione nel sistema sorgente
È possibile creare una nuova app Slack a partire dal manifest fornito da Docebo (opzione consigliata) oppure riutilizzare un'app già esistente.
Creare l'app Slack dal manifest
- Nella scheda Autorizza in Docebo, copiare il manifest con il pulsante di copia.
- Aprire Create a Slack app (api.slack.com/apps) ed effettuare l'accesso a Slack, se richiesto.
- Scegliere From a manifest, selezionare il workspace e fare clic su Avanti.
- Impostare l'editor su JSON, sostituirne il contenuto con il manifest, quindi fare clic su Avanti e Crea e Installa.
Slack apre la pagina Informazioni di base della nuova app. Il manifest contiene già i permessi e l'URL di reindirizzamento, quindi non è necessario configurare altro.
Il manifest richiede i seguenti scope del token utente:
| Scope | Cosa consente |
|---|---|
| channels:read | Visualizzare le informazioni di base sui canali pubblici |
| channels:history | Visualizzare i messaggi e altri contenuti nei canali pubblici |
| groups:read | Visualizzare le informazioni di base sui canali privati a cui si ha accesso |
| groups:history | Visualizzare i messaggi e altri contenuti nei canali privati a cui si ha accesso |
| search:read.public | Cercare messaggi e file nei canali pubblici |
| search:read.private | Cercare messaggi e file nei canali privati a cui si ha accesso |
| search:read.users | Cercare persone nel workspace |
| users:read | Visualizzare le persone nel workspace |
Esiste già un'app Slack? Riutilizzarla
Saltare il manifest e configurare l'app esistente:
- Aprire l'app su api.slack.com/apps e andare a OAuth & Permissions.
- In Redirect URLs, aggiungere l'URL di reindirizzamento mostrato in Docebo e fare clic su Save URLs. L'URL segue questo schema: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, ad esempio https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- In Scopes → User Token Scopes, aggiungere tutti gli scope elencati sopra.
- Lasciare disattivata l'opzione Token Rotation. Non è necessario attivare nulla nella pagina Agenti, quindi lasciare disattivato il toggle Slack MCP Server.
- Se Slack richiede di reinstallare l'app, procedere, quindi continuare con la sezione successiva.
3. Azioni richieste in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| Client ID | App Slack → Informazioni di base → Credenziali dell'app |
| Client secret | App Slack → Informazioni di base → Credenziali dell'app. Fare clic su Mostra accanto a Client Secret. Non utilizzare il Signing Secret |
Autorizzare il connettore
- Andare a Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → Slack. Questo menu è visibile solo ai Superadmin. Nella scheda Quadro generale, verificare cosa verrà cercato e selezionare Inizia.
- Nella scheda Autorizza, seguire i passaggi per creare o riutilizzare l'app Slack (vedere Preparazione).
- Nella pagina Informazioni di base dell'app, in Credenziali dell'app, copiare il Client ID e il Client secret nei campi della scheda Autorizza.
- Selezionare Autentica, accedere con l'account Slack membro di tutti i canali privati da rendere disponibili e fare clic su Consenti. Se il workspace richiede l'approvazione dell'amministratore per le nuove app, Slack mostra invece una schermata di richiesta. Un amministratore del workspace approva l'app una sola volta, dopodiché è necessario selezionare di nuovo Autentica.
- Nella scheda Canali, selezionare i canali da rendere disponibili, quindi salvare la selezione.