L'integrazione Slack di Dialogflow semplifica la creazione di app e bot Slack e l'addestramento alla comprensione del linguaggio naturale.
Limitazioni
Questa integrazione supporta solo la lingua predefinita dell'agente.
Configurazione di Slack
Per configurare l'integrazione Slack per l'agente, è necessario quanto segue:
- un account Slack
- un team di Slack
Crea un'app Slack
- Vai a Slack Developer Console.
- Inserisci un nome per l'app
- Scegli un team a cui desideri associare l'app
- Fai clic sul pulsante Crea app
Aggiungi utente bot
- Fai clic su OAuth e autorizzazioni nel menu a sinistra.
- Vai alla sezione Ambiti e assicurati che i seguenti ambiti OAuth siano nella sezione Ambiti dei token del bot
- Fai clic su Home page dell'app nel menu a sinistra.
- Attiva Mostra sempre il mio bot come online e, se necessario, modifica Nome visualizzazione app (questo è ciò che gli utenti vedranno per il tuo bot)
Abilitazione dell'integrazione in Dialogflow
In Slack Developer Console, fai clic su Informazioni di base nel menu a sinistra e scorri verso il basso fino alla sezione Credenziali dell'app. Prendi nota di ID client, client secret e token di verifica.
Collegare Slack a Dialogflow
- In Dialogflow, vai a Integrations (Integrazioni) nel menu a sinistra.
- Fai clic sul riquadro Slack
- Inserisci i relativi valori nei seguenti campi:
- ID client
- Client secret
- Token di verifica
- Fai clic su Avvia
Proseguimento della configurazione di Slack
Dopo aver configurato Slack e Dialogflow, attiverai OAuth, URL per le richieste di eventi (forniti da Dialogflow) e Sottoscrizioni agli eventi.
Aggiungi URL OAuth
- Copia l'URL OAuth dalla pagina delle impostazioni Slack di Dialogflow
- Vai alla Console per gli sviluppatori di Slack e fai clic su OAuth e autorizzazioni nel menu a sinistra
- Fai clic sul pulsante Aggiungi un nuovo URL di reindirizzamento e incolla l'URL OAuth
- Fai clic su Aggiungi.
- Fai clic sul pulsante Salva URL.
Aggiungi URL richiesta evento e Abilita sottoscrizioni eventi
- Copia l'URL richiesta evento dalla pagina delle impostazioni Slack di Dialogflow.
- Vai alla Developer Console di Slack e fai clic su Event Subscriptions (Abbonamenti eventi) nel menu a sinistra
- Fai clic sull'opzione per abilitare gli eventi e incolla l'URL di iscrizione all'evento nel campo URL richiesta
Dopo qualche istante dovresti vedere una dicitura verde "Verificato" sopra il campo URL richiesta. In Iscriviti agli eventi del bot , fai clic sul pulsante Aggiungi evento utente bot
Verranno visualizzati il campo di testo e l'elenco degli eventi. Puoi inserire termini in questo campo per cercare gli eventi a cui vuoi che il tuo bot risponda. Ecco un elenco di eventi che ti consigliamo di aggiungere:Nome evento Descrizione evento message.im È stato pubblicato un messaggio in un canale di messaggi diretti message.groups È stato pubblicato un messaggio su un canale privato message.channels È stato pubblicato un messaggio su un canale im_created È stato creato un messaggio diretto. Nella sezione Iscriviti agli eventi per conto degli utenti, fai clic sul pulsante Aggiungi evento Workspace per aggiungere l'evento im_create, quindi premi Salva modifiche. Dopo avere aggiornato queste impostazioni, fai clic sul pulsante Salva modifiche nella parte inferiore della pagina.
Aggiungi il tuo bot Slack a un team
- In Slack Developer Console, fai clic su Gestisci distribuzione nel menu a sinistra
- Nella sezione Condividi la tua app con il tuo luogo di lavoro, fai clic sul pulsante Aggiungi a Slack
- Nella pagina successiva, fai clic sul pulsante Autorizza per aggiungere l'agente
Test
Puoi testare l'agente senza creare un bot Slack pubblico. Per farlo, vai alla pagina Integrazioni per l'agente e fai clic sull'opzione nel riquadro Slack. Nella finestra popup, fai clic sul pulsante Testa in Slack.
Ti verrà chiesto di accedere a Slack. Dopo aver eseguito l'accesso, vai all'istanza e individua l'utente del bot chiamato @dialogflow-bot. Puoi inviare un messaggio all'agente per testarlo o aggiungerlo ai canali nella tua istanza.
Eventi
I seguenti eventi vengono richiamati da questa integrazione:
Evento | Descrizione |
---|---|
SLACK_WELCOME |
Si attiva quando un utente avvia una conversazione con il tuo bot Slack. |
Messaggi di risposta avanzati
Sono supportati i seguenti messaggi di risposta avanzati.
Risposte immagine
Formati e dimensioni supportati:
- gif
- jpeg
- png
- bmp
Risposte alle schede
Non ci sono campi obbligatori per le schede in Slack. È possibile utilizzare qualsiasi combinazione di elementi.
Sono supportati i pulsanti con un URL e con un postback di testo. I pulsanti con un URL vengono visualizzati come link ipertestuali.
Risposte di risposta rapida
Le risposte rapide sono supportate nelle integrazioni Slack con un solo clic e corrispondono a una versione di testo dei pulsanti interattivi Slack.
Risposte payload personalizzate
Testo formattato nell'integrazione Slack con un solo clic
I bot Slack possono inviare testo formattato, come illustrato nell'esempio seguente:
{ "slack": { "text": "This is an example of *bold*, _italic_, and `code`." } }