AI Slackbot

BYOA Slack agent. Click below to create the Slack app — scopes, events, and webhook URL are pre-filled from a manifest.

Create Slack App →

Then add SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET, and ANTHROPIC_API_KEY to your val's environment variables. See the README.

\n`);\n});\n\napp.post(\"/events\", async (c) => {\n const rawBody = await c.req.text();\n const payload = JSON.parse(rawBody);\n const requestType = payload.type as \"url_verification\" | \"event_callback\";\n\n // See https://api.slack.com/events/url_verification\n if (requestType === \"url_verification\") {\n return new Response(payload.challenge, { status: 200 });\n }\n\n try {\n await verifyRequest({ requestType, request: c.req.raw, rawBody });\n const botUserId = await getBotId();\n const event = payload.event as SlackEvent;\n console.log(`Received ${event.type}`);\n\n // Fire-and-forget: Slack expects a response within 3 seconds\n // 1. Immediately respond to Slack\n // 2. Continue processing the message asynchronously\n // 3. Send the AI response when it's ready\n switch (event.type) {\n // When you tag your @agent in a Slack channel or thread\n case \"app_mention\":\n handleAppMention(event, botUserId).catch((err) =>\n console.error(\"Error in handleAppMention\", err)\n );\n break;\n\n // When you create a new chat with the agent app in Slack\n case \"assistant_thread_started\":\n handleThreadStarted(event).catch((err) =>\n console.error(\"Error in handleThreadStarted\", err)\n );\n break;\n\n // When you send a message in any channel or thread the agent is in?\n case \"message\": {\n const msgEvent = event as GenericMessageEvent;\n handleMessage(msgEvent, botUserId).catch((err) =>\n console.error(\"Error in handleMessage\", err)\n );\n break;\n }\n }\n\n return new Response(\"Success!\", { status: 200 });\n } catch (error) {\n console.error(\"Error generating response\", error);\n return new Response(\"Error generating response\", { status: 500 });\n }\n});\n\nexport default app.fetch;\n",[145],"6aa3050c-4977-11f1-bd30-42b51c65c3df","README.md","019dfe7f-914f-776b-adce-eae0ce2abdb3",["D",1778091266284],"# ai-slackbot\n\nAn AI agent powered by Claude with web\nsearch, deployed on Val Town.\n\n## Features\n\n- Responds to `@mentions` in channels and threads, with full thread history as\n context\n- Acts as a Slack assistant in DMs (Chat tab), with greeting + suggested prompts\n- Powered by Claude Sonnet 4.6 with Anthropic's built-in web search tool\n- One-click Slack app setup — no manual scope or event configuration\n- Easily extensible: swap models, add tools, change prompts\n\n## Setup (~2 minutes)\n\n1. **Remix this val** if you haven't already.\n2. **Visit your val's HTTP endpoint** (the `/` route) to see the setup page,\n then click **Create Slack App**. The app's manifest — scopes, events, and\n webhook URL — is pre-filled, so just click **Next** → pick workspace →\n **Create**.\n3. **Install to Workspace** in the Slack app's _Install App_ tab.\n4. **Paste 3 secrets** into your val's\n [environment variables](https://docs.val.town/reference/environment-variables/)\n (the slots are already created — just fill the values):\n - `SLACK_BOT_TOKEN` — Slack app → OAuth & Permissions → Bot User OAuth Token\n (`xoxb-...`)\n - `SLACK_SIGNING_SECRET` — Slack app → Basic Information → Signing Secret\n - `ANTHROPIC_API_KEY` — from the\n [Claude console](https://platform.claude.com/settings/keys)\n5. _(Optional)_ Set the bot's icon at Slack app → Basic Information → Display\n Information → App icon. The manifest can't carry an icon — it has to be\n uploaded manually. Square PNG, 512×512+.\n\n## Usage\n\n- **DM the bot** — open the Slack app, click _Messages_, and chat. The\n conversation maintains thread context automatically.\n- **`@mention` in a channel** — the bot replies in a thread on your message.\n Follow-ups in that thread also get full thread context.\n\n> ⚠️ **Invite the bot to the channel first** (`/invite @AI Slackbot`).\n> Without channel membership, the bot receives the mention event but can't\n> read thread history, and will only see your single mention as context.\n\n## Architecture\n\n```\nai-slackbot/\n├── events.ts # HTTP entry point: setup page + Slack event router\n├── prompt.md # System prompt for your agent\n├── README.md\n└── lib/\n ├── generate-response.ts # AI core (Claude + web search)\n ├── handle-app-mention.ts # @mentions in channels and threads\n ├── handle-message.ts # DMs in assistant (Chat tab) threads\n ├── handle-thread-started.ts # Greeting + suggested prompts on new assistant thread\n └── slack-utils.ts # Slack client, request verification, thread fetching\n```\n\nSlack POSTs events to `/events`. The handler verifies the signature, looks up\nthe bot's user ID, and dispatches based on event type. Long-running work runs\nfire-and-forget so the 3-second Slack ack window isn't blocked.\n\n## Customization\n\n- **Swap the model or model provider** → `lib/generate-response.ts` (uses the\n Vercel AI SDK, so any provider works)\n- **Edit the system prompt** → `prompt.md`\n- **Add tools** (database queries, knowledge bases, custom APIs) → extend the\n `tools` object in `lib/generate-response.ts`. See the\n [AI SDK tools docs](https://sdk.vercel.ai/docs/ai-sdk-core/tools-and-tool-calling).\n- **Change greeting or suggested prompts** in DMs → `lib/handle-thread-started.ts`\n- **Change Slack scopes, events, or app metadata** → edit the `manifest`\n object at the top of `events.ts`. Re-create the Slack app from the updated\n setup page.\n\n## Version pinning\n\nThis val uses\n[pinned imports](https://docs.val.town/reference/version-control/#imports--pinning)\nto avoid breaking changes:\n\n1. `@slack/web-api@7.14.1`\n2. `hono@4.12.0`\n3. `ai@6.0.92`\n4. `@ai-sdk/anthropic@3.0.45`\n\n## Credits\n\nBased on Vercel's\n[Slackbot Agent Guide](https://ai-sdk.dev/cookbook/guides/slackbot) and Pete\nMillspaugh's [pmillspaugh/duck](https://www.val.town/x/pmillspaugh/duck), both\nadapted for Val Town.",[151],"6aa30066-4977-11f1-bd30-42b51c65c3df","lib","019dfe7f-914f-776b-adce-e676b559160e",["D",1778091266284],"directory",[157],"pulls","forks","envVars",{"_168":170,"_171":170},"connections",{"_168":56,"_169":56},"count","unfilledCount",3,"emptyCount",{"_20":156,"_13":157,"_131":158,"_133":-5,"_134":21,"_135":30,"_136":52,"_22":227,"_29":56,"_138":160,"_139":-5,"_141":40,"_142":-5,"_182":228,"_94":229},{"_20":220,"_13":221,"_131":222,"_133":158,"_134":21,"_135":30,"_136":52,"_22":223,"_29":56,"_138":195,"_139":224,"_141":40,"_142":-5,"_182":225,"_94":226},{"_20":213,"_13":214,"_131":215,"_133":158,"_134":21,"_135":30,"_136":52,"_22":216,"_29":56,"_138":195,"_139":217,"_141":40,"_142":-5,"_182":218,"_94":219},{"_20":206,"_13":207,"_131":208,"_133":158,"_134":21,"_135":30,"_136":52,"_22":209,"_29":56,"_138":195,"_139":210,"_141":40,"_142":-5,"_182":211,"_94":212},{"_20":199,"_13":200,"_131":201,"_133":158,"_134":21,"_135":30,"_136":52,"_22":202,"_29":56,"_138":195,"_139":203,"_141":40,"_142":-5,"_182":204,"_94":205},{"_20":191,"_13":192,"_131":193,"_133":158,"_134":21,"_135":30,"_136":52,"_22":194,"_29":56,"_138":195,"_139":196,"_141":40,"_142":-5,"_182":197,"_94":198},{"_20":150,"_13":151,"_131":152,"_133":-5,"_134":21,"_135":30,"_136":52,"_22":188,"_29":56,"_138":106,"_139":154,"_141":40,"_142":-5,"_182":189,"_94":190},{"_20":144,"_13":145,"_131":50,"_133":-5,"_134":21,"_135":30,"_136":52,"_22":185,"_29":56,"_138":147,"_139":148,"_141":40,"_142":-5,"_182":186,"_94":187},{"_20":129,"_13":130,"_131":132,"_133":-5,"_134":21,"_135":30,"_136":52,"_22":181,"_29":56,"_138":106,"_139":140,"_141":40,"_142":-5,"_182":183,"_94":184},["D",1778091266284],"children",[],[130],["D",1778091266284],[],[145],["D",1778091266284],[],[151],"6aa2d618-4977-11f1-bd30-42b51c65c3df","slack-utils.ts","019dfe7f-914f-776b-adce-e1ff0178705d",["D",1778091266284],"script","import { WebClient } from \"npm:@slack/web-api@7.14.1\";\nimport { ModelMessage } from \"npm:ai@6.0.92\";\n\nconst signingSecret = Deno.env.get(\"SLACK_SIGNING_SECRET\")!;\n\nexport const client = new WebClient(Deno.env.get(\"SLACK_BOT_TOKEN\"));\n\n// See https://api.slack.com/authentication/verifying-requests-from-slack\nexport async function isValidSlackRequest({\n request,\n rawBody,\n}: {\n request: Request;\n rawBody: string;\n}) {\n const timestamp = request.headers.get(\"X-Slack-Request-Timestamp\");\n const slackSignature = request.headers.get(\"X-Slack-Signature\");\n\n if (!timestamp || !slackSignature) {\n console.log(\"Missing timestamp or signature\");\n return false;\n }\n\n // Prevent replay attacks on the order of 5 minutes\n if (Math.abs(Date.now() / 1000 - parseInt(timestamp)) > 60 * 5) {\n console.log(\"Timestamp out of range\");\n return false;\n }\n\n const encoder = new TextEncoder();\n const base = `v0:${timestamp}:${rawBody}`;\n\n const key = await crypto.subtle.importKey(\n \"raw\",\n encoder.encode(signingSecret),\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n\n const signature = await crypto.subtle.sign(\n \"HMAC\",\n key,\n encoder.encode(base),\n );\n\n const hmacHex = Array.from(new Uint8Array(signature))\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n const computedSignature = encoder.encode(`v0=${hmacHex}`);\n const expectedSignature = encoder.encode(slackSignature);\n\n // Prevent timing attacks with constant-time comparison\n if (computedSignature.length !== expectedSignature.length) return false;\n let result = 0;\n for (let i = 0; i < computedSignature.length; i++) {\n result |= computedSignature[i] ^ expectedSignature[i];\n }\n return result === 0;\n}\n\nexport const verifyRequest = async ({\n requestType,\n request,\n rawBody,\n}: {\n requestType: string;\n request: Request;\n rawBody: string;\n}) => {\n const validRequest = await isValidSlackRequest({ request, rawBody });\n if (!validRequest || requestType !== \"event_callback\") {\n throw new Error(\"Invalid request\");\n }\n};\n\nexport const updateStatus = async (\n { channel, thread_ts, status }: {\n channel: string;\n thread_ts: string;\n status: string;\n },\n) => {\n await client.assistant.threads.setStatus({\n channel_id: channel,\n thread_ts: thread_ts,\n status: status,\n loading_messages: [\n \"quacking...\",\n \"flapping...\",\n \"waddling...\",\n \"splashing...\",\n \"ruffling...\",\n \"paddling...\",\n \"preening...\",\n \"plucking...\",\n \"chirping...\",\n \"bobbling...\",\n ],\n });\n};\n\nexport const updateThreadTitle = async (\n { channel, thread_ts, title }: {\n channel: string;\n thread_ts: string;\n title: string;\n },\n) => {\n await client.assistant.threads.setTitle({\n channel_id: channel,\n thread_ts: thread_ts,\n title: title,\n });\n};\n\nexport async function getThread(\n channel_id: string,\n thread_ts: string,\n botUserId: string,\n): Promise {\n const { messages } = await client.conversations.replies({\n channel: channel_id,\n ts: thread_ts,\n limit: 50,\n });\n\n if (!messages) throw new Error(\"No messages found in thread\");\n\n const result = messages\n .map((message) => {\n const isBot = !!message.bot_id;\n if (!message.text) return null;\n\n // For app mentions, remove the mention prefix\n // For IM messages, keep the full text\n let content = message.text;\n if (!isBot && content.includes(`<@${botUserId}>`)) {\n content = content.replace(`<@${botUserId}> `, \"\");\n }\n\n return {\n role: isBot ? \"assistant\" : \"user\",\n content: content,\n } as ModelMessage;\n })\n .filter((msg): msg is ModelMessage => msg !== null);\n\n return result;\n}\n\nexport const getBotId = async () => {\n const { user_id: botUserId } = await client.auth.test();\n\n if (!botUserId) {\n throw new Error(\"botUserId is undefined\");\n }\n return botUserId;\n};",[],[157,192],"6aa2b214-4977-11f1-bd30-42b51c65c3df","handle-thread-started.ts","019dfe7f-914f-776b-adce-dc30c24a4f6f",["D",1778091266284],"import type { AssistantThreadStartedEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client } from \"./slack-utils.ts\";\n\nexport async function handleThreadStarted(\n event: AssistantThreadStartedEvent,\n) {\n const { channel_id, thread_ts } = event.assistant_thread;\n console.log(`Thread started: ${channel_id} ${thread_ts}`);\n console.log(JSON.stringify(event));\n\n await client.chat.postMessage({\n channel: channel_id,\n thread_ts: thread_ts,\n text:\n \"Hello, I'm an AI agent powered by Val Town\",\n });\n\n await client.assistant.threads.setSuggestedPrompts({\n channel_id: channel_id,\n thread_ts: thread_ts,\n prompts: [\n {\n title: \"What vals have I worked on recently?\",\n message: \"What vals have I worked on recently?\",\n },\n {\n title: \"Create an HTTP val\",\n message: \"Create an HTTP val\",\n },\n {\n title: \"How does persistence work in Val Town?\",\n message: \"How does persistence work in Val Town?\",\n },\n ],\n });\n}",[],[157,200],"6aa2a706-4977-11f1-bd30-42b51c65c3df","handle-message.ts","019dfe7f-914f-776b-adce-db98a9eb0599",["D",1778091266284],"import type { GenericMessageEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client, getThread, updateStatus } from \"./slack-utils.ts\";\nimport { generateResponse } from \"./generate-response.ts\";\n\nexport async function handleMessage(\n event: GenericMessageEvent,\n botUserId: string,\n) {\n console.log(`Message: ${JSON.stringify(event)}`);\n\n if (\n event.bot_id ||\n event.bot_id === botUserId ||\n event.bot_profile ||\n !event.thread_ts\n ) {\n return;\n }\n\n const { thread_ts, channel } = event;\n await updateStatus({ channel, thread_ts, status: \"is thinking...\" });\n\n // TODO: set a dynamic title after the first user message\n // await updateTitle({ channel, thread_ts, title: \"TODO\" });\n\n const messages = await getThread(channel, thread_ts, botUserId);\n const result = await generateResponse(messages);\n\n await client.chat.postMessage({\n channel: channel,\n thread_ts: thread_ts,\n text: result,\n unfurl_links: false,\n blocks: [\n {\n type: \"section\",\n text: {\n type: \"mrkdwn\",\n text: result,\n },\n },\n ],\n });\n}",[],[157,207],"6aa27dc6-4977-11f1-bd30-42b51c65c3df","handle-app-mention.ts","019dfe7f-914f-776b-adce-d7a0fde0931b",["D",1778091266284],"import { AppMentionEvent } from \"npm:@slack/web-api@7.14.1\";\nimport { client, getThread, updateStatus } from \"./slack-utils.ts\";\nimport { generateResponse } from \"./generate-response.ts\";\n\nexport async function handleAppMention(\n event: AppMentionEvent,\n botUserId: string,\n) {\n console.log(`App mention: ${JSON.stringify(event)}`);\n\n if (event.bot_id || event.bot_id === botUserId || event.bot_profile) {\n console.log(\"Skipping app mention\");\n return;\n }\n\n const { thread_ts, channel } = event;\n const threadTs = thread_ts ?? event.ts;\n await updateStatus({\n thread_ts: threadTs,\n channel,\n status: \"is thinking...\",\n });\n\n const messages = thread_ts\n ? await getThread(channel, thread_ts, botUserId)\n : [{ role: \"user\" as const, content: event.text }];\n\n const result = await generateResponse(messages);\n\n await client.chat.postMessage({\n channel,\n thread_ts: threadTs,\n text: result,\n unfurl_links: false,\n blocks: [\n {\n type: \"section\",\n text: {\n type: \"mrkdwn\",\n text: result,\n },\n },\n ],\n });\n}",[],[157,214],"6aa24ef0-4977-11f1-bd30-42b51c65c3df","generate-response.ts","019dfe7f-914f-776b-adce-d1a555cb6373",["D",1778091266284],"import { generateText, ModelMessage, stepCountIs } from \"npm:ai@6.0.92\";\nimport { anthropic } from \"npm:@ai-sdk/anthropic@3.0.45\";\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst prompt = await readFile(\"/prompt.md\");\n\nexport const generateResponse = async (messages: ModelMessage[]) => {\n console.log(`generating LLM response...`);\n\n const { text } = await generateText({\n model: anthropic(\"claude-sonnet-4-6\"),\n tools: {\n webSearch: anthropic.tools.webSearch_20250305({ maxUses: 3 }),\n },\n stopWhen: stepCountIs(5),\n system: prompt,\n messages,\n });\n\n console.log(`generated LLM response: ${text.slice(0, 25)}...`);\n\n // Convert markdown to Slack mrkdwn format\n return text.replace(/\\[(.*?)\\]\$(.*?)\$/g, \"<$2|$1>\").replace(/\\*\\*/g, \"*\");\n};",[],[157,221],["D",1778091266284],[173,174,175,176,177],[157],["D",1778091266284],{"_11":12,"_92":88},{"_11":12,"_85":86,"_87":88,"_47":48,"_89":90,"_91":40},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":32,"_33":34,"_79":42,"_80":81,"_82":58,"_83":14,"_84":12},"ctx",{"_72":-5,"_116":267,"_268":269,"_270":271,"_272":40,"_273":40,"_274":40,"_275":52,"_276":-5,"_277":-7,"_278":-7,"_279":56,"_280":40,"_281":40,"_282":-5,"_283":40,"_284":40,"_285":40,"_286":-5},"ENV",{"_238":239,"_240":241,"_242":26,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","c73f21da490985bff19c279eb0e09db24d688e4f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Branches1

Branches
1