Slack agent

This guide takes you through building a Slack agent in Val Town, using the Vercel AI SDK. It is an updated version of Vercel’s own Slackbot Agent Guide, adapted for Val Town.

In 5 or 10 minutes, you’ll have an agent that can respond to DMs and mentions in Slack channels.

Setup

1. Go to api.slack.com/apps to create a Slack app — choose “From scratch”
2. Under OAuth & Permissions > Scopes > Bot Token Scopes, add the following:
   • app_mentions:read
   • assistant:write
   • channels:history
   • chat:write
   • im:history
   • im:write
3. Under App Home > Show Tabs > Chat Tab, check “Allow users to send Slash commands and messages from the chat tab”
4. Under OAuth & Permissions > OAuth Tokens, install the app to your workspace
5. Remix this slack agent template val
6. Add environment variables in your val sidebar:
   1. SLACK_BOT_TOKEN in your Slack app: OAuth & Permissions > OAuth Tokens > Bot User OAuth Token
   2. SLACK_SIGNING_SECRET in your Slack app: Basic Information > Signing Secret
   3. ANTHROPIC_API_KEY from the Claude console
7. Copy your HTTP url in events.ts (note: you can add a custom subdomain), then in your Slack app paste it under Event Subscriptions > Request URL
8. In your Slack app under Events Subscription > Enable Events > Subscribe to bot events, add app_mention, assistant_thread_started, and message.im

Test it

At this point, you should already be able to chat with your agent in Slack via @mention in channels, or directly via the Slack app’s chat interface. Next, we’ll walk through how the code works so you can make it your own.

How it works

Files

• Directorylib

  • generate-response.ts
  • handle-app-mention.ts
  • handle-message.ts
  • handle-thread-started.ts
  • slack-utils.ts
• events.ts
• prompt.md
• README.md

Dependencies

• Slack’s Web API (v7.14.1)
• Hono (v4.12.0)
• Vercel’s AI SDK (v6.0.92)

Webhook handler

The events.ts file exposes an API from the val’s HTTP URL using Hono. The POST /events route is where Slack webhooks come in and get routed based on their event type (@mention, thread started, or generic message).

The POST route verifies that webhooks are indeed coming from Slack then handles three types of events in its core try-catch loop:

1. app_mention fires when you @mention your agent in a Slack channel or thread
2. assistant_thread_started fires when you create a new chat directly with the agent app
3. message fires when you send a message in an agent app chat

Note

Slack expects a response within 3 seconds to confirm the request is being handled. It’ll retry automatically if a response takes too long. Since LLM inference can take longer, we use a fire-and-forget pattern that responds to the HTTP request immediately then continues with the LLM call and sends it back to Slack when done.

App mentions

When you mention your bot in a channel or channel thread, the app_mention event is triggered, which we handle in handle-app-mention.ts:

1. Checks if the message is from a bot to avoid infinite response loops
2. Creates a status updater to show the bot is “thinking”
3. If the mention is in a thread, it retrieves the thread history
4. Calls the LLM with the message content

Assistant thread messages

When you start a thread with your assistant in its dedicated Slack app chat interface, the assistant_thread_started event is triggered, which we handle in handle-thread-started.ts:

1. Your agent sends a welcome message to the thread
2. Sets up suggested prompts to help users get started

You should tailor these, of course, based on your needs.

DMs

For direct messages to your bot in its dedicated Slack app chat interface, the message event is triggered, which we handle in handle-message.ts:

1. Ignore messages from the agent (bot) itself
2. Update the status ahead of the LLM call
3. Retrieve the conversation history
4. Call the LLM with the conversation context
5. Post the LLM’s response to the thread

LLM calls

The core AI parts of your agent live in generate-response.ts:

1. Loads your system prompt
2. Uses the Vercel AI SDK’s generateText function with Anthropic’s claude-sonnet-4.6 model
3. Passes tools to the LLM: web search
4. Formats the response for Slack’s markdown format

Make it your own

We’ve set up this val template and guide with web search as its only tool, but the goal is for you to make it your own! You could connect to the Val Town MCP server, like we’ve done with this demo townie val. Or you could create a customer support bot, like this template for Pylon. Feel free to reach out in our Discord server for help or to share what you’ve made.