Slack

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

Limitazioni

Configurare Slack

Per configurare l'integrazione di Slack per il tuo agente, devi disporre di quanto segue:

  • Un account Slack
  • Un workspace 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
    • Token di firma
      • 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 alla tua app Slack e incolla l'URL del webhook in Event Subscriptions > Enable Events > Request URL.

Test

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 per i messaggi di Slack.

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.