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\n// ─── Slack event intake: verify, then dispatch to /process ──────────────────\n// Val Town kills detached promises after the HTTP response is sent, so the\n// fire-and-forget pattern truncates slow handlers (long threads + tool calls).\n// We use the \"early return\" pattern: dispatch heavy work to /process as a\n// separate HTTP request with its own full execution lifecycle.\n// See: https://docs.val.town/vals/http/early-return/\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(`[Events] Received ${event.type}, dispatching to /process`);\n\n // Fire off a NEW HTTP request to /process — this gets its own execution\n // lifecycle. Include an internal secret so /process rejects unauthorized\n // callers.\n const processUrl = new URL(\"/process\", c.req.url).toString();\n const internalSecret = Deno.env.get(\"SLACK_SIGNING_SECRET\")!;\n fetch(processUrl, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-Internal-Secret\": internalSecret,\n },\n body: JSON.stringify({ event, botUserId }),\n }); // intentionally NOT awaited\n\n return new Response(\"OK\", { status: 200 });\n } catch (error) {\n console.error(\"[Events] Error:\", error);\n return new Response(\"Error\", { status: 500 });\n }\n});\n\n// ─── Process route: does the actual heavy lifting ───────────────────────────\n// This runs as its own HTTP request, so it gets the full timeout window.\n\napp.post(\"/process\", async (c) => {\n // Verify this request came from our own /events handler\n const internalSecret = Deno.env.get(\"SLACK_SIGNING_SECRET\")!;\n const providedSecret = c.req.header(\"X-Internal-Secret\");\n if (providedSecret !== internalSecret) {\n console.warn(\"[Process] Rejected unauthorized request\");\n return new Response(\"Unauthorized\", { status: 401 });\n }\n\n const { event, botUserId } = await c.req.json();\n console.log(`[Process] Handling ${event.type}`);\n\n try {\n switch (event.type) {\n case \"app_mention\":\n await handleAppMention(event, botUserId);\n break;\n\n case \"assistant_thread_started\":\n await handleThreadStarted(event);\n break;\n\n case \"message\":\n await handleMessage(event as GenericMessageEvent, botUserId);\n break;\n\n default:\n console.log(`[Process] Unknown event type: ${event.type}`);\n }\n\n return new Response(\"Done\", { status: 200 });\n } catch (error) {\n console.error(`[Process] FAILED for ${event.type}:`, error);\n return new Response(\"Error\", { status: 500 });\n }\n});\n\nexport default app.fetch;\n",[141],"412f1528-498e-11f1-9272-42b51c65c3df","README.md","019dff15-3d47-712d-aef1-5fa97593c798",["D",1778101075191],"# 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. **Open your val's HTTP endpoint in a new tab** (you should see it in the homepage of your remixed val),\n then click **Create Slack App**. The app's [manifest](./events.ts) — scopes,\n events, and webhook URL — is pre-filled, so just click **Next** → pick\n workspace → **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)\n\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, then\ndispatches the heavy work to `/process` as a separate HTTP request — Val Town\nkills detached promises after the response is sent, so the\n[early-return pattern](https://docs.val.town/vals/http/early-return/) gives the\nreal handler its own full execution lifecycle.\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.",[147],"412f0da8-498e-11f1-9272-42b51c65c3df","lib","019dff15-3d47-712d-aef1-5aacb26c891b",["D",1778101075191],"directory",[153],"pulls","branches","forks","envVars",{"_165":167,"_168":167},"connections",{"_165":42,"_166":42},"count","unfilledCount",3,"emptyCount",{"_18":152,"_20":153,"_127":154,"_129":-5,"_130":68,"_131":66,"_132":38,"_22":224,"_65":42,"_134":156,"_135":-5,"_137":26,"_138":-5,"_179":225,"_89":226},{"_18":217,"_20":218,"_127":219,"_129":154,"_130":68,"_131":66,"_132":38,"_22":220,"_65":42,"_134":192,"_135":221,"_137":26,"_138":-5,"_179":222,"_89":223},{"_18":210,"_20":211,"_127":212,"_129":154,"_130":68,"_131":66,"_132":38,"_22":213,"_65":42,"_134":192,"_135":214,"_137":26,"_138":-5,"_179":215,"_89":216},{"_18":203,"_20":204,"_127":205,"_129":154,"_130":68,"_131":66,"_132":38,"_22":206,"_65":42,"_134":192,"_135":207,"_137":26,"_138":-5,"_179":208,"_89":209},{"_18":196,"_20":197,"_127":198,"_129":154,"_130":68,"_131":66,"_132":38,"_22":199,"_65":42,"_134":192,"_135":200,"_137":26,"_138":-5,"_179":201,"_89":202},{"_18":188,"_20":189,"_127":190,"_129":154,"_130":68,"_131":66,"_132":38,"_22":191,"_65":42,"_134":192,"_135":193,"_137":26,"_138":-5,"_179":194,"_89":195},{"_18":146,"_20":147,"_127":148,"_129":-5,"_130":68,"_131":66,"_132":38,"_22":185,"_65":42,"_134":100,"_135":150,"_137":26,"_138":-5,"_179":186,"_89":187},{"_18":140,"_20":141,"_127":36,"_129":-5,"_130":68,"_131":66,"_132":38,"_22":182,"_65":42,"_134":143,"_135":144,"_137":26,"_138":-5,"_179":183,"_89":184},{"_18":125,"_20":126,"_127":128,"_129":-5,"_130":68,"_131":66,"_132":38,"_22":178,"_65":42,"_134":100,"_135":136,"_137":26,"_138":-5,"_179":180,"_89":181},["D",1778101075191],"children",[],[126],["D",1778101075191],[],[141],["D",1778101075191],[],[147],"412eeb66-498e-11f1-9272-42b51c65c3df","slack-utils.ts","019dff15-3d47-712d-aef1-55f53cedc810",["D",1778101075191],"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 \"thinking...\",\n \"pondering...\",\n \"musing...\",\n \"ruminating...\",\n \"reflecting...\",\n \"contemplating...\",\n \"cogitating...\",\n \"mulling...\",\n \"noodling...\",\n \"deliberating...\",\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};",[],[153,189],"412ee2ec-498e-11f1-9272-42b51c65c3df","handle-thread-started.ts","019dff15-3d47-712d-aef1-507d4c5a3816",["D",1778101075191],"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: \"How does persistence work in Val Town?\",\n message: \"How does persistence work in Val Town?\",\n },\n {\n title: \"What can I build on Val Town?\",\n message: \"What can I build on Val Town?\",\n },\n {\n title: \"What's new in Val Town?\",\n message: \"What's new in Val Town?\",\n },\n ],\n });\n}",[],[153,197],"412ed73e-498e-11f1-9272-42b51c65c3df","handle-message.ts","019dff15-3d47-712d-aef1-4f8af75b2988",["D",1778101075191],"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}",[],[153,204],"412eccf8-498e-11f1-9272-42b51c65c3df","handle-app-mention.ts","019dff15-3d47-712d-aef1-4b42ad0bb5b9",["D",1778101075191],"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}",[],[153,211],"412e9c10-498e-11f1-9272-42b51c65c3df","generate-response.ts","019dff15-3d47-712d-aef1-45147a4680b7",["D",1778101075191],"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};",[],[153,218],["D",1778101075191],[170,171,172,173,174],[153],["D",1778101075191],{"_16":17,"_87":83},{"_16":17,"_80":81,"_82":83,"_33":34,"_84":85,"_86":26},{"_65":66,"_20":67,"_18":68,"_69":19,"_70":71,"_72":73,"_74":28,"_75":76,"_77":44,"_78":21,"_79":17},"ctx",{"_58":-5,"_110":264,"_265":266,"_267":268,"_269":26,"_270":26,"_271":26,"_272":38,"_273":-5,"_274":-7,"_275":-7,"_276":42,"_277":26,"_278":26,"_279":-5,"_280":26,"_281":26,"_282":26,"_283":-5},"ENV",{"_235":236,"_237":238,"_239":67,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261,"_262":263},"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"]