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, e i dati degli utenti finali vengono inviati sia a Google che 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. Termini di servizio, SLA, prezzi e 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.

Configurare Slack

Per configurare l'integrazione di Slack per il tuo agente, è necessario seguenti:

• Un account Slack
• Uno spazio di lavoro Slack

Crea un bot Slack

1. Vai alle tue app 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 la tua applicazione nell'area di lavoro che preferisci
   • Token OAuth utente 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 a 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 > Abilita 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. Vedi API Slack per formato dei messaggi.

Nota: se non è specificato nel payload personalizzato, il campo del canale verrà viene 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 impostazioni specifiche per il canale risposte personalizzate, il canale DF_CX_SLACK viene usato automaticamente quando l'agente risponde ai messaggi Slack.