Slack

L'integrazione di Slack di Dialogflow semplifica la creazione di app e bot di Slack e il loro addestramento alla comprensione del linguaggio naturale.

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:

Creare un'app Slack

  1. Vai alla 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.

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 presenti 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 visualizzato dell'app, se necessario (è il nome che gli utenti vedranno per il tuo bot).

Attivazione dell'integrazione in Dialogflow

Nella console per sviluppatori di Slack, fai clic su Informazioni di base nel menu a sinistra e scorri verso il basso fino alla sezione Credenziali 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 valori correlati nei seguenti campi:
    1. ID client
    2. Client secret
    3. Verification Token
  4. Fai clic su Avvia.

Continuazione della configurazione di Slack

Ora che hai configurato Slack e Dialogflow, devi attivare OAuth, gli URL delle richieste di evento (forniti da Dialogflow) e le iscrizioni agli eventi.

Aggiungi l'URL OAuth

  1. Copia l'URL OAuth dalla pagina delle impostazioni di Slack di Dialogflow
  1. Vai alla console per 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 l'URL della richiesta di evento e attiva le iscrizioni agli eventi

  1. Copia l'URL della 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 sul pulsante Aggiungi evento utente del bot

    . Verranno visualizzati il campo di testo e l'elenco degli eventi. In questo campo puoi inserire termini per cercare gli eventi a cui vuoi che il 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 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 Play Console di Slack, fai clic su Gestisci distribuzione nel menu a sinistra.
  2. Nella sezione Condividi la tua app con il tuo posto 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 del tuo agente e fai clic sul pulsante di attivazione/disattivazione 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 denominato @dialogflow-bot. Puoi inviare un messaggio diretto all'agente per testarlo o aggiungerlo ai canali della 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 di Slack.

Messaggi di risposta avanzati

Sono supportati i seguenti messaggi di risposta avanzata.

Risposte con immagini

Formati e dimensioni supportati:

  • gif
  • jpeg
  • png
  • bmp

Risposte con schede

Non sono presenti 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 personalizzati

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`."
  }
}