Slack

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:

Crea un'app Slack

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

Aggiungi 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 dei token del bot
  3. Fai clic su Home page dell'app nel menu a sinistra.
  4. 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.

  1. In Dialogflow, vai a Integrations (Integrazioni) nel menu a sinistra.
  2. Fai clic sul riquadro Slack
  3. Inserisci i relativi valori nei seguenti campi:
    1. ID client
    2. Client secret
    3. Token di verifica
  4. 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

  1. Copia l'URL OAuth dalla pagina delle impostazioni Slack di Dialogflow
  1. Vai alla Console per gli sviluppatori di Slack 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.

Aggiungi URL richiesta evento e Abilita sottoscrizioni eventi

  1. Copia l'URL richiesta evento dalla pagina delle impostazioni Slack di Dialogflow.
  2. Vai alla Developer Console di Slack e fai clic su Event Subscriptions (Abbonamenti eventi) nel menu a sinistra
  3. 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.

  4. 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.

  5. Dopo avere aggiornato queste impostazioni, fai clic sul pulsante Salva modifiche nella parte inferiore della pagina.

Aggiungi il tuo bot Slack a un team

  1. In Slack Developer Console, fai clic su Gestisci distribuzione nel menu a sinistra
  2. Nella sezione Condividi la tua app con il tuo luogo 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 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`."
  }
}