
Prerequisites
- Access to the Slack API.
Generic endpoint settings
Override snapshot connections
If you activate the Override Snapshot Connections toggle, the endpoint overrides the connections in the snapshot with connections from the project. If only the snapshot has a connection, the connection isn’t overridden. If necessary, you need to update such connections manually. To override the connection of the agent in production, you can:- Make the necessary changes in a staging environment, create a snapshot of the same agent, and select the snapshot in the endpoint settings. Deactivate the Override Snapshot Connections toggle.
- Import connections from another agent using a package. Activate the Override Snapshot Connections toggle.
Mocking
In the Advanced Settings section, you can toggle on the Enable Mocking setting to activate mocking for the endpoint. Mocking lets you change node behaviors and test how they perform through the endpoint without changing the original node settings. Make sure that you also activate mocking at the node level.Additional endpoint settings
You can use the following additional settings to customize the endpoint:- NLU connectors
- Data protection & analytics
- Transformer functions
- Real-time translation
- Session management
- Copilot
- Inject and Notify
Endpoint-specific settings
How to set up
1. Create a Slack endpoint
1. Create a Slack endpoint
- In the left-side menu of your Project, click Deploy > Endpoints.
- On the Endpoints page, click + New Endpoint.
- In the New Endpoint section, do the following:
- Select the Slack Endpoint type.
- Specify a unique name.
- Select a Flow from the list. Save changes.
- Go to the Configuration Information section and copy the URL from the Endpoint URL field.
2. Create a Slack app
2. Create a Slack app
- Go to the Slack API and click Create New App.
- Select From scratch. Enter a name for your app and select the workspace where you want to install it. Click Create App. Make sure your app is installed in the workspace.
- After creating the app, you will be redirected to the Basic Information page of your Slack app.
- In the App Credentials section, you will find the Client ID and Client Secret. You will need these later for OAuth configuration.
- In the left sidebar, go to OAuth & Permissions. Configure the necessary permissions for your app. Under Scopes, add the following app token scopes:
app_mentions:readchat:writeim:writeincoming-webhook
- Go to Settings > Basic Information in your Slack app. In the App Credentials section, copy the value from the Verification Token field and save it for later use.
- Go to the OAuth & Permissions page of your Slack app and scroll to the Tokens for Your Workspace section. Copy the Bot User OAuth Access Token (it starts with
xoxb-) and save it. You can also use the OAuth Access Token; in this case, the app will have the same permissions as your user account. - In the Event Subscriptions section, enable events and set the Request URL to the Cognigy Endpoint URL. In the Subscribe to Bot Events section, add the following events:
app_mentionmessage.im
- To enable Quick Reply messages, follow Slack’s official guide on Interactivity & Shortcuts.
3. Complete the Slack endpoint configuration
3. Complete the Slack endpoint configuration
- In the Cognigy interface, go to the Slack Endpoint you created. Go to the Slack Setup section.
- In the OAuth Access Token field, paste the access token you copied from Slack.
- In the Verification Token field, paste the verification Token you copied from Slack. Save changes.