Slack

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle offerte pre-GA" nella sezione 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 delle fasi di lancio.

L'integrazione di Slack ti consente di creare facilmente bot Slack con la comprensione del linguaggio naturale basata sulla tecnologia Conversational Agents (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 disporre di quanto segue:

• Un account Slack
• Un workspace di Slack

Creare un bot Slack

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

   display_information:
     name: Conversational Agents (Dialogflow CX)
     description: Conversational Agents (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 nello spazio di lavoro che preferisci
   • Token OAuth utente bot
     • Vai a Installa app > Token OAuth per il tuo spazio di lavoro > Token OAuth utente bot
   • Signing Token
     • Vai a Informazioni di base > Credenziali app > Secret di firma

Configura Conversational Agents (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 Slack e incolla l'URL del webhook in Event Subscriptions > Enable Events > Request URL

Test

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

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

Messaggi di risposta avanzati

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

Nota: se non è 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 di 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.