Slack

L'integrazione di Slack di Dialogflow semplifica la creazione di app e bot di Slack e l'addestramento per comprendere il linguaggio naturale.

Nota: quando utilizzi un'integrazione di terze parti, le richieste e i dati degli utenti finali vengono inviati sia a Google sia alla terza parte. I termini di servizio, lo SLA, i prezzi e le quote per la tua edizione dell'agente sono applicabili alla gestione di queste richieste da parte di Google. I termini di servizio, lo SLA, i prezzi e le quote della terza parte sono applicabili alla gestione di queste richieste da parte della terza parte.

Limitazioni

Questa integrazione supporta solo la lingua predefinita dell'agente

Configurazione di Slack

Per configurare l'integrazione di Slack per il tuo agente, devi avere:

• Un account Slack
• Un team Slack

Creare un'app Slack

1. Vai alla Slack Developer Console
2. Inserisci un nome per l'app
3. Scegli un team a cui vuoi associare l'app
4. Fai clic sul pulsante Crea app

Aggiungere un utente bot

1. Fai clic su OAuth e autorizzazioni nel menu a sinistra
2. Vai alla sezione Ambiti e assicurati che i seguenti ambiti OAuth siano nella sezione Ambiti del token bot
3. Fai clic su Home app nel menu a sinistra
4. Attiva Mostra sempre il mio bot come online e modifica Nome visualizzato dell'app se necessario (questo è ciò che gli utenti vedranno per il tuo bot)

Abilitare l'integrazione in Dialogflow

Nella 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

1. In Dialogflow, vai a Integrazioni nel menu a sinistra
2. Fai clic sul riquadro Slack
3. Inserisci i valori correlati nei seguenti campi:
   1. ID client
   2. Client secret
   3. Token di verifica
4. Fai clic su Avvia

Continuare la configurazione di Slack

Ora che hai configurato Slack e Dialogflow, devi abilitare OAuth, gli URL delle richieste di eventi (forniti da Dialogflow) e gli abbonamenti agli eventi.

Aggiungere l'URL OAuth

1. Copia l'URL OAuth dalla pagina delle impostazioni di Slack di Dialogflow

Nota: se la tua app Slack è un'app Slack classica e non l'hai ancora eseguito l'upgrade, dovrai fare clic su Mostra URL per il flusso di lavoro Slack legacy nella pagina delle impostazioni di Slack di Dialogflow e poi copiare l'URL OAuth. Per ulteriori informazioni, consulta la guida rapida: differenze tra le vecchie e le nuove app Slack.

1. Vai alla Slack Developer Console e fai clic su OAuth e autorizzazioni nel menu a sinistra
2. Fai clic sul pulsante Aggiungi un nuovo URL di reindirizzamento e incolla l'URL OAuth
3. Fai clic su Aggiungi
4. Fai clic sul pulsante Salva URL

Aggiungere l'URL della richiesta di eventi e abilitare gli abbonamenti agli eventi

1. Copia l'URL della richiesta di eventi dalla pagina delle impostazioni di Slack di Dialogflow
2. Vai alla Slack Developer Console e fai clic su Abbonamenti agli eventi nel menu a sinistra
3. Fai clic sull'opzione per abilitare gli eventi e incolla l'URL dell'abbonamento agli eventi nel campo URL della richiesta
   
   Dopo qualche istante, sopra il campo URL della richiesta dovrebbe essere visualizzato un messaggio verde "Verificato".

4. In Abbonati agli eventi bot , fai clic sul pulsante Aggiungi evento utente bot
   
   Verranno visualizzati un campo di testo e un elenco di eventi. Puoi inserire i 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 in un canale privato
   message.channels	È stato pubblicato un messaggio in un canale
   im_created	È stato creato un messaggio diretto. Nella sezione Abbonati agli eventi per conto degli utenti , fai clic sul pulsante Aggiungi evento dell'area di lavoro per aggiungere l'evento im_created, quindi premi Salva modifiche.

   

5. Al termine dell'aggiornamento di queste impostazioni, fai clic sul Salva modifiche pulsante in fondo alla pagina.

Aggiungere il bot di Slack a un team

1. Nella Slack Developer Console, fai clic su Gestisci distribuzione nel menu a sinistra
2. Nella sezione Condividi la tua app con il tuo ambiente di lavoro, fai clic sul pulsante Aggiungi a Slack
3. Nella pagina successiva, fai clic sul pulsante Autorizza per aggiungere l'agente

Test

Puoi testare l'agente senza creare un bot di Slack pubblico. Per farlo, vai alla pagina Integrazioni dell'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. Una volta eseguito l'accesso, vai all'istanza e individua l'utente bot chiamato @dialogflow-bot. Puoi inviare un messaggio diretto all'agente per testarlo o aggiungerlo ai canali della tua istanza.

Nota: per modificare il nome dell'agente o aggiungere un logo, devi rendere pubblico il bot.

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 di Slack.

Messaggi di risposta avanzati

Sono supportati i seguenti messaggi di risposta avanzati.

Risposte con immagini

Formati e dimensioni supportati:

• gif
• jpeg
• png
• bmp

Risposte con schede

Non esistono campi obbligatori per le schede in Slack: puoi 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 rapide

Le risposte rapide sono supportate nelle integrazioni di Slack con un solo clic e corrispondono a una versione di testo dei pulsanti interattivi di Slack.

Risposte con payload personalizzato

Testo formattato nell'integrazione di Slack con un solo clic

I tuoi bot di Slack possono inviare testo formattato, come mostrato nell'esempio seguente:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}