Slack

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

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 l'input di testo nella lingua predefinita dell'agente

Configurare Slack

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

• Un account Slack
• Un workspace di Slack

Creare un bot di Slack

1. Vai alle tue app di Slack
2. Crea una nuova app di Slack da un manifest dell'app. Di seguito è riportato un manifest di esempio. Assicurati che i campi oath_config e 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 nel workspace che preferisci.
   • Token OAuth dell'utente del bot
     • Vai a Install App (Installa app) > OAuth Tokens for Your Workspace (Token OAuth per il tuo workspace) > Bot User OAuth Token (Token OAuth dell'utente del bot)
   • Token di firma
     • Vai a Basic Information (Informazioni di base) > App Credentials (Credenziali dell'app) > Signing Secret (Secret di firma)

Configurare Dialogflow CX

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, se applicabile.
6. Fai clic su Avvia.
7. Copia l'URL webhook.

Abilitare il webhook in Slack

Torna all'app di Slack e incolla l'URL del webhook in Event Subscriptions (Sottoscrizioni di eventi) > Enable Events (Abilita eventi) > Request URL (URL della richiesta).

Test

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

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

Messaggi di risposta avanzati

I messaggi di risposta avanzati sono supportati tramite Payload personalizzato in evasione. Per il formato del messaggio, consulta l' API dei messaggi di Slack.

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

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

{
  "text": "Hello, world"
}

Risposte specifiche del canale

Dopo aver configurato le risposte specifiche del canale, il canale DF_CX_SLACK viene utilizzato automaticamente quando l'agente risponde ai messaggi di Slack.