Slack Setup

The Slack integration delivers notifications to your workspace and lets team members interact with your Zetto agent through DMs. Conversations are thread-based for clean organisation.

Prerequisites

• Slack workspace admin access (to install the app)

Setup

1. Go to api.slack.com/apps and click Create New App.
2. Choose From scratch, name the app (e.g., “Zetto”), and select your workspace.
3. Navigate to OAuth & Permissions and add the following Bot Token Scopes:
   • chat:write
   • channels:history
   • im:history
   • im:write
4. Click Install to Workspace and authorize the app.
5. Copy the Bot User OAuth Token (starts with xoxb-).
6. Go to Settings > Channels > Slack in your Zetto dashboard.
7. Paste the token and select the channel where you want notifications delivered.
8. Back in your Slack app settings, go to Event Subscriptions.
9. Enable events and set the Request URL to:

   https://api.zettoai.com/api/slack/events

10. Under Subscribe to bot events, add:
    • message.im
    • message.channels
11. Click Save Changes.

Caution

The Event Subscriptions URL must be set after you save your token in the Zetto dashboard. The API endpoint needs to know your workspace to verify Slack’s challenge request.

Commands

Command	Description
/clear	Reset the conversation memory for a fresh start
/signup	Link your Slack account to your Zetto account via email verification

Account linking with /signup

Team members can link their Slack accounts to Zetto for authenticated access:

1. Type /signup in a DM with the Zetto bot.
2. Enter the email address associated with your Zetto account.
3. Check your email for an OTP verification code.
4. Enter the OTP in the Slack conversation.
5. Your Slack account is now linked — the bot recognises you as the account owner.

How conversations work

Slack conversations with the Zetto bot are thread-based:

• Each new interaction starts a thread in the DM
• Replies within a thread maintain context
• Notifications are delivered to the configured channel (not DMs)
• DMs with the bot are for interactive management (matches, listings, search)

Troubleshooting

Bot not responding to DMs?

• Ensure im:history and im:write scopes are added.
• Verify Event Subscriptions are enabled with the correct URL.
• Check that message.im is subscribed.

Events URL verification failing?

• Save your Slack token in the Zetto dashboard first, then set the events URL.
• Make sure the URL is exactly https://api.zettoai.com/api/slack/events.

Not receiving channel notifications?

• Invite the bot to the channel: type /invite @Zetto in the channel.
• Verify the correct channel is selected in your Zetto dashboard.

Next steps

• Discord Setup
• Notification Routing