Slack

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

L'integrazione Slack di Dialogflow consente di creare facilmente bot Slack con comprensione del linguaggio naturale basata sulla tecnologia Dialogflow.

Nota: quando utilizzi un'integrazione di terze parti, le richieste e i dati degli utenti finali vengono inviati sia a Google che alla terza parte. I termini di servizio, lo SLA (accordo sul livello del servizio), i prezzi e le quote per la versione dell'agente si applicano alla gestione di queste richieste da parte di Google. I termini di servizio, lo SLA (accordo sul livello del servizio), i prezzi e le quote della terza parte si applicano alla gestione di queste richieste da parte della terza parte.

Limitazioni

• Questa integrazione supporta solo l'input di testo nella lingua predefinita dell'agente.

Configura Slack

Per configurare l'integrazione Slack per l'agente, è necessario quanto segue:

• Un account Slack
• Un'area di lavoro Slack

Creare un bot Slack

1. Vai alle app Slack.
2. Creare una nuova app slack da un file manifest dell'app. Di seguito è riportato un esempio di manifest. Assicurati che i campi oath_config ed event_subscriptions corrispondano al manifest di esempio.

   display_information:
     name: Dialogflow CX
     description: Dialogflow CX Integration
     background_color: "#1148b8"
   features:
     app_home:
       home_tab_enabled: false
       messages_tab_enabled: true
       messages_tab_read_only_enabled: false
     bot_user:
       display_name: CX
       always_online: true
   oauth_config:
     scopes:
       bot:
         - app_mentions:read
         - chat:write
         - im:history
         - im:read
         - im:write
         - incoming-webhook
   settings:
     event_subscriptions:
       request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
       bot_events:
         - app_mention
         - message.im
     org_deploy_enabled: false
     socket_mode_enabled: false
     token_rotation_enabled: false
   

3. Installa l'applicazione nell'area di lavoro che preferisci
   • Token OAuth utente bot
     • Vai a Installa app > Token OAuth per l'area di lavoro > Token OAuth utente bot
   • Token di firma
     • Vai a Informazioni di base > Credenziali app > Secret di firma

Configura Dialogflow

1. Fai clic sulla scheda Gestisci nel riquadro a sinistra.
2. Fai clic su Integrazioni nel menu a sinistra.
3. Fai clic sul pulsante Connetti nel riquadro Slack.
4. Inserisci le seguenti informazioni:
   • Token di accesso
   • Token di firma
5. Scegli un ambiente, a seconda dei casi.
6. Fai clic su Avvia.
7. Copia l'URL webhook.

Abilita il webhook in Slack

Torna all'app Slack e incolla l'URL del webhook in Sottoscrizioni agli eventi > Abilita eventi > URL di richiesta

Test

Nota: assicurati che la fatturazione sia abilitata nel progetto prima di testare l'integrazione.

Per testare l'app configurata, nell'area di lavoro in cui l'hai installata, menzionala in un canale di gruppo o inviale un messaggio diretto.

Messaggi di risposta avanzati

I messaggi di risposta avanzati sono supportati tramite Payload personalizzato in Fulfillment. Per il formato del messaggio, consulta API Slack Message.

Nota: se non viene specificato nel payload personalizzato, il campo del canale verrà inserito automaticamente con l'ID canale del messaggio di input.

Ad esempio, il seguente payload personalizzato fornisce un semplice messaggio di testo Slack:

{
  "text": "Hello, world"
}

Risposte specifiche per i canali

Se configurato, le risposte specifiche per il canale con il canale DF_CX_SLACK verranno utilizzate automaticamente quando l'agente risponde ai messaggi Slack.