Slack

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

The Slack Integration lets you create Slack bots with natural language understanding based on Dialogflow CX technology.

Note: When using a third party integration, requests and end-user data are sent to both Google and the third party. The terms of service, SLA, pricing, and quotas for your agent edition are applicable for Google's handling of these requests. The third party's terms of service, SLA, pricing, and quotas are applicable for the third party's handling of these requests.

Limitations

• Only text input in the agent's default language is supported by this integration.

Set Up Slack

To set up the Slack integration for your agent, you need the following:

• A Slack account.
• A Slack workspace.

Create a Slack bot

1. Go to your Slack Apps.

2. Create a new Slack app from an app manifest. The following is an example manifest. Make sure that the oauth_config and event_subscriptions fields match with the example manifest:

   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. Install your app into the workspace of your choice:

   • Bot User OAuth Token: Go to Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token.
   • Signing Token: Go to Basic Information > App Credentials > Signing Secret.

Set up Dialogflow CX

1. Go to the Manage tab on the navigation menu.
2. Select Integrations.
3. Click the Connect button on the Slack tile.
4. Provide the following information:
   • Access token
   • Signing token
5. Select an environment, as applicable.
6. Click Start.
7. Copy the Webhook URL.

Enable webhook in Slack

Go to Slack Apps and paste your Webhook URL under Event Subscriptions > Enable Events > Request URL.

Testing

Note: Verify that billing is enabled on your project before testing the integration.

To test your configured app in your workspace, mention it in a group channel or send a direct message.

Rich response messages

Rich response messages are supported using Custom Payload in Fulfillment. For more information, see the Slack message API for the message format.

Note: If it isn't specified in the custom payload, the channel field is automatically injected with the channel_id of the input message.

For example, the following custom payload provides a Slack text message:

{
  "text": "Hello, world"
}

Channel-specific responses

After you configure the channel-specific responses, the channel DF_CX_SLACK is automatically used when the agent responds to Slack messages.