IBM Cloud Docs
Integrazione con Slack

Integrazione con Slack

IBM Cloud

Slack è un'applicazione di messaggistica basata su cloud che aiuta le persone a collaborare tra loro.

Dopo che hai creato un'azione, puoi integrare il tuo assistente con Slack.

Una volta integrato, a seconda degli eventi che hai configurato per essere supportati dall'assistente, il tuo assistente può rispondere alle domande poste in messaggi diretti o in canali in cui l'assistente viene menzionato direttamente.

Un esempio e le istruzioni su come creare uno Slackbot utilizzando watsonx Assistant, Slack e Db2 vengono forniti nell'esercitazione della soluzione, Crea uno Slackbot basato su database.

Prima di iniziare

Per integrare Slack con l'assistente, è necessario disporre di un'app Slack e dei ruoli e dei permessi necessari:

Ruoli Autorizzazioni
Proprietario dell'area di lavoro o dell'organizzazione
Visualizza informazioni
Invia informazioni
Esegui azioni

Per creare un'app slack, consultate Quickstart: Avviare un flusso di lavoro.

Per ulteriori informazioni su ruoli e autorizzazioni, vedere Slack - Iniziare.

Aggiunta dell'integrazione Slack

  1. Vai alla pagina Integrazioni facendo clic sull'icona delle integrazioni (icona Integrazioni) nel menu a sinistra.

  2. Fai clic su Aggiungi nel tile Slack.

  3. Quindi, fare nuovamente clic su Aggiungi.

Introduzione

Le fasi di configurazione di Slack sono quattro:

  • Configurare il bot Slack
  • Collegare watsonx Assistant a Slack
  • Configurare il bot Slack
  • Collegare l'assistente

Configurare il bot Slack

  1. Andate alla pagina Le vostre applicazioni sul sito web di Slack, quindi fate clic sull'applicazione che desiderate utilizzare o createne una nuova.

Collegare watsonx Assistant a Slack

  1. Nella pagina Impostazioni dell'app Slack, andate alla scheda Informazioni di base e scorrete fino alla sezione Credenziali dell'app.

  2. Copiare il token di verifica e incollarlo nella pagina Configurazione dell'assistente.

  3. Nella pagina Impostazioni dell'app Slack, andate su Caratteristiche > OAutenticazione e autorizzazioni e scorrete fino alla sezione Scopi dei token bot.

  4. Fare clic su Aggiungi un ambito OAuth e selezionare i seguenti ambiti:

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write

  5. Scorrete la pagina fino alla sezione OAuth Tokens for Your Workspace e fate clic su Install App to Workspace, quindi su Allow.

    Si dovrebbe essere reindirizzati alla pagina OAuth & Permessi.

  6. Copiare e incollare il token di accesso OAuth dell'utente Bot nella pagina Configurazione dell'assistente.

  7. Fai clic su Next per continuare.

Configurare il bot Slack

  1. Copiare il sito Richiesta generata URL.

  2. Nella pagina Impostazioni dell'app Slack, andate su Caratteristiche > Sottoscrizioni agli eventi e attivate la levetta Abilita eventi on.

  3. Incollare il link dell' URL in Request URL.

    Aspettate di vedere Verificato con un segno di spunta verde accanto a Richiedi URL.

  4. Scorrete verso il basso e fate clic su Iscriviti agli eventi bot.

  5. Selezionare i tipi di eventi a cui ci si vuole abbonare. Devi selezionare almeno uno dei seguenti tipi:

    • message.im: elenca gli eventi messaggio pubblicati in un canale di messaggi diretti.

    • app_mention: elenca solo gli eventi messaggio che citano la tua applicazione o il bot.

      Scegli la voce app_menzionato nel font normale, non la voce app_menzionato che è in grassetto.

  6. Fai clic su Save Changes.

  7. Nella pagina Impostazione assistente, fare clic su Avanti.

Collegare l'assistente

  1. Nella pagina Impostazioni dell'app Slack, andate su Caratteristiche > AppHome e fate clic su Modifica accanto a Nome visualizzato app.

  2. Fare clic su Salva una volta apportate le modifiche.

  3. Passare la levetta Mostra sempre il mio bot come online a on.

  4. Andare nella sezione Mostra schede e spostare la levetta Scheda messaggi su on.

  5. Selezionate la casella di controllo Consenti agli utenti di inviare comandi e messaggi Slash dalla scheda Messaggi.

  6. Se si desidera aggiungere il supporto per la visualizzazione di pulsanti, menu e opzioni di disambiguazione nell'app Slack, procedere come segue:

    1. Accedere alla scheda Interattività e scorciatoie e attivare la funzione
    2. Incollare l' URL della richiesta nell'apposito campo di inserimento testo.
    3. Fai clic su Save Changes.

  7. Nella pagina Impostazione assistente, fare clic su Finisci.

Se un campo token richiesto per l'autenticazione viene modificato, tutte le voci nei campi correlati devono essere riempite e convalidate di nuovo.

Considerazioni sulle azioni

Le risposte complete aggiunte a un'azione vengono visualizzate in un canale Slack, con le seguenti eccezioni:

  • Connettersi all'agente in carne e ossa: Questo tipo di risposta viene ignorato.

  • Option: questo tipo di risposta mostra un elenco delle opzioni tra cui può scegliere l'utente.

    • Dopo che l'utente fa clic su una delle opzioni, le selezioni esistenti scompaiono e vengono sostituite con l'input dell'utente generato dalla sua selezione. Se si includono più tipi di risposta in una singola risposta, è necessario posizionare il tipo di risposta opzionale alla fine, per evitare confusioni dovute alla mescolanza di risposte e input dell'utente.

    • Se le opzioni vengono visualizzate in un elenco a discesa, ogni valore di opzione deve avere una lunghezza massima di 75 caratteri. Quando un elenco comprende 5 o più opzioni, viene visualizzato in un elenco a discesa.

Chat con l'assistente

Per avviare una chat con l'assistente, completa i seguenti passi:

  1. Apri Slack e vai allo spazio di lavoro associato alla tua applicazione.
  2. Fai clic sull'applicazione che hai creato dalla sezione Apps.
  3. Avvia una chat con l'assistente.

L'azione di benvenuto non è elaborata dall'integrazione Slack. Il messaggio di benvenuto non viene visualizzato nel canale Slack come nell'anteprima dell'assistente. Non viene attivato da qui perché i nodi con la condizione speciale welcome vengono saltati nei flussi di azione avviati dagli utenti. Slack attende che l'utente inizi la conversazione.

Il flusso di azioni per la sessione corrente viene riavviato dopo 60 minuti di inattività (5 minuti per i piani Lite e Standard). Ciò significa che se un utente smette di interagire con l'assistente, dopo 60 (o 5) minuti, i valori delle variabili di contesto impostati durante la conversazione precedente vengono impostati su null o riportati ai loro valori predefiniti.