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 di Slack ti consente di creare facilmente bot di Slack con la comprensione del linguaggio naturale basata sulla tecnologia degli agenti conversazionali (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, gli 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, gli SLA, i prezzi e le quote della terza parte sono applicabili per la 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 l'agente, devi avere quanto segue:

• Un account Slack
• Uno spazio di lavoro Slack

Creare un bot di Slack

1. Vai alle app di Slack.
2. Crea una nuova app Slack da un file 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 dell'utente del bot
     • Vai a Installa app > Token OAuth per il tuo spazio di lavoro > Token OAuth utente bot
   • Token di firma
     • Vai a Informazioni di base > Credenziali app > Secret di firma

Configurare gli agenti conversazionali (Dialogflow CX)

1. Fai clic sulla scheda Gestisci nel riquadro di sinistra.
2. Fai clic su Integrations (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.

Attivare l'webhook in Slack

Torna all'app Slack e incolla l'URL del webhook in Iscrizioni agli eventi > Attiva eventi > URL richiesta.

Test

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

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

Messaggi di risposta avanzati

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

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 canale

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