Skip to main content

​
Create the Slack app

1

Open Slack API and create the app

Go to Slack API → Your Apps → Create New App → Create from scratch. Name it “Neo Agent” and select your workspace.
Create a new Slack app
Create app from scratch in Slack
Name the app and select workspace
2

Add bot token scopes

On OAuth & Permissions, add:
  • app_mentions:read
  • channels:history
  • chat:write
  • im:history
  • users:read
Add required bot token scopes
3

Enable event subscriptions

On Event Subscriptions, set the Request URL to your Neo Slack endpoint and subscribe to channel message events.
Configure event subscriptions in Slack
If you need your workspace-specific Request URL, contact the Neo team for your tenant’s endpoint.
4

Install to workspace

On OAuth & Permissions, click Install to workspace. The app appears under Apps in Slack.
Neo Agent app installed in Slack
5

Share credentials with Neo admin

Provide your Bot User OAuth Token and App ID to your Neo administrator to complete configuration.

​
Add Neo to channels and test

1

Add to a channel

Open the Neo Agent app in Slack and add it to the target channel.
Add Neo Agent to a Slack channel
2

Send a test message

Mention Neo or send a direct message to validate the integration.
Test message to Neo Agent

​
Configure channel notifications

Use the channel ID in the Notify Internal Team action.
Copy a channel link in Slack and use the last segment as the channel ID (for example: C1234567890).