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 bot Slack con 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 versione 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.

Configura Slack

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

• Un account Slack.
• Un workspace di Slack.

Crea un bot Slack

1. Vai alle tue app Slack.

2. Crea una nuova app Slack da un manifest dell'app. Di seguito è riportato un manifest di esempio. Assicurati che i campi oauth_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'app nel workspace che preferisci:

   • Token OAuth utente bot: vai a Install App (Installa app) > OAuth Tokens for Your Workspace (Token OAuth per il tuo workspace) > Bot User OAuth Token (Token OAuth utente bot).
   • Token di firma: vai a Basic Information (Informazioni di base) > App Credentials (Credenziali app) > Signing Secret (Secret di firma).

Configura Dialogflow CX

1. Vai alla scheda Gestisci nel menu di navigazione.
2. Seleziona Integrations (Integrazioni).
3. Fai clic sul pulsante Connetti nel riquadro Slack.
4. Fornisci le seguenti informazioni:
   • Token di accesso
   • Token di firma
5. Seleziona un ambiente, se applicabile.
6. Fai clic su Avvia.
7. Copia l'URL webhook.

Abilita il webhook in Slack

Vai ad App Slack e incolla l'URL webhook in Sottoscrizioni di eventi > Abilita eventi > URL di richiesta.

Test

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

Per testare l'app configurata nel tuo spazio di lavoro, menzionala in un canale di gruppo o invia un messaggio diretto.

Messaggi di risposta avanzati

I messaggi di risposta avanzata sono supportati utilizzando il payload personalizzato nel fulfillment. Per saperne di più, consulta l'API Slack Message per il formato dei messaggi.

Nota: se non è specificato nel payload personalizzato, il campo channel viene inserito automaticamente con il valore channel_id del messaggio di input.

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

{
  "text": "Hello, world"
}

Risposte specifiche per il canale

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