Slack

L'integrazione Slack di Dialogflow semplifica la creazione di app e bot Slack e addestrarli a 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, gli SLA, i prezzi e le quote per la tua versione dell'agente sono applicabili alla gestione di queste richieste da parte di Google. I termini di servizio, gli SLA, i prezzi e le quote della terza parte sono applicabili per la gestione di queste richieste da parte della terza parte.

Limitazioni

Solo la lingua predefinita dell'agente è supportata da questa integrazione.

Configurazione di Slack

Per configurare l'integrazione di Slack per l'agente, devi avere quanto segue:

• un account Slack
• un team di Slack

Crea un'app Slack

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

Aggiungi 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 token bot
3. Fai clic su Home page dell'app nel menu a sinistra.
4. Attiva Mostra sempre il mio bot come online e modifica Nome descrizione dell'app se necessaria (questo è ciò che gli utenti vedranno per il tuo bot)

Abilitazione dell'integrazione in Dialogflow

Nella console per gli sviluppatori di Slack, fai clic su Informazioni di base a sinistra. e scorri verso il basso fino alla sezione Credenziali app. Prendi nota ID client, client secret e token di verifica.

Collega Slack a Dialogflow

1. In Dialogflow, vai a Integrations (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. Verification Token
4. Fai clic su Avvia.

Continuazione della configurazione di Slack

Dopo aver configurato Slack e Dialogflow, attiverai le azioni OAuth, Event URL delle richieste (forniti da Dialogflow) e Abbonamenti agli eventi.

Aggiungi l'URL OAuth

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

Nota: se l'app Slack è un'app classica di Slack di cui non hai ancora eseguito l'upgrade, devi fare clic su Mostra URL per il flusso di lavoro Slack precedente nel flusso di lavoro di Dialogflow pagina delle impostazioni di Slack e copia l'URL OAuth. Per ulteriori informazioni, consulta la guida rapida: differenze tra le app Slack precedenti e quelle nuove.

1. Vai alla Developer Console di Slack e fai clic su OAuth & 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.

Aggiungi URL di richiesta dell'evento e abilita le sottoscrizioni agli eventi

1. Copia l'URL richiesta di evento dalla pagina delle impostazioni di Slack di Dialogflow
2. Vai alla console per sviluppatori di Slack e fai clic su Iscrizioni agli eventi nel menu a sinistra.
3. Fai clic sul pulsante di attivazione per attivare gli eventi e incolla l'URL di sottoscrizione all'evento nel campo URL richiesta.
   
   Dopo alcuni istanti, dovresti visualizzare il messaggio "Verificato" in verde sopra il campo URL richiesta.

4. In Iscriviti agli eventi del bot , fai clic su Aggiungi evento utente bot. pulsante
   
   Verranno visualizzati un campo di testo e un elenco di eventi. In questo campo puoi inserire termini per cercare gli eventi a cui vuoi che il bot risponda. Ecco un elenco di eventi che suggeriamo di aggiungere:
   

   Nome evento	Descrizione evento
   message.im	È stato pubblicato un messaggio su 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 Iscriviti agli eventi per conto degli utenti, fai clic sul pulsante Aggiungi evento dello spazio di lavoro per aggiungere l'evento im_created, quindi premi Salva modifiche.

   

5. Al termine dell'aggiornamento di queste impostazioni, fai clic sul pulsante Salva modifiche nella parte inferiore della pagina.

Aggiungere il tuo bot di Slack a un team

1. Nella console per gli sviluppatori di Slack, fai clic su Gestisci distribuzione a sinistra. menu
2. Nella sezione Condividi la tua app con il tuo luogo di lavoro, fai clic sul pulsante Aggiungi a Pulsante Slack
3. 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 sezione Pagina Integrazioni per l'agente e fai clic sull'opzione nel riquadro Slack. Nella finestra popup, fai clic sul pulsante Test in Slack.

Ti verrà chiesto di accedere a Slack. Dopo aver 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 nella tua istanza.

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

Eventi

I seguenti eventi sono 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

Le seguenti messaggi di risposta avanzata sono supportati.

Risposte immagine

Formati e dimensioni supportati:

• GIF
• jpeg
• png
• bmp

Risposte con schede

In Slack non ci sono campi obbligatori per le schede: è 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 rapide

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

Risposte del payload personalizzate

Testo formattato nell'integrazione di Slack con un solo clic

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

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