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",[150],"cb583f8e-481d-449b-abd2-50dd65339d02","README.md","019f14de-fb34-7268-8bbc-5c66f70ad12c",["D",1782761585368],"# ai-slackbot\n\nAn AI agent powered by Claude with web search, 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. Click [**Remix**](https://www.val.town/x/templates/ai-slackbot/?intent=remix)\n to get your own copy of this val.\n2. **Open your val's HTTP endpoint in a new tab** (you should see it in the\n homepage of your remixed val), then click **Create Slack App**. The app's\n [manifest](./events.ts) — scopes, events, and webhook URL — is pre-filled, so\n just click **Next** → pick 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## 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`). Without\n> channel membership, the bot receives the mention event but can't read thread\n> 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 →\n `lib/handle-thread-started.ts`\n- **Change Slack scopes, events, or app metadata** → edit the `manifest` object\n at the top of `events.ts`. Re-create the Slack app from the updated setup\n 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)",[156],"a7092403-f2b3-46f3-a0fb-c260e94d2fd8","lib","019f14de-fb34-7268-8bbc-5964e68d3f86",["D",1782761585368],"directory",[162],"pulls","forks","envVars",{"_173":34,"_175":34},"connections",{"_173":57,"_174":57},"count","unfilledCount","emptyCount",{"_20":161,"_13":162,"_136":163,"_138":-5,"_139":21,"_140":30,"_141":53,"_22":231,"_29":57,"_143":165,"_144":-5,"_146":40,"_147":-5,"_186":232,"_96":233},{"_20":224,"_13":225,"_136":226,"_138":163,"_139":21,"_140":30,"_141":53,"_22":227,"_29":57,"_143":199,"_144":228,"_146":40,"_147":-5,"_186":229,"_96":230},{"_20":217,"_13":218,"_136":219,"_138":163,"_139":21,"_140":30,"_141":53,"_22":220,"_29":57,"_143":199,"_144":221,"_146":40,"_147":-5,"_186":222,"_96":223},{"_20":210,"_13":211,"_136":212,"_138":163,"_139":21,"_140":30,"_141":53,"_22":213,"_29":57,"_143":199,"_144":214,"_146":40,"_147":-5,"_186":215,"_96":216},{"_20":203,"_13":204,"_136":205,"_138":163,"_139":21,"_140":30,"_141":53,"_22":206,"_29":57,"_143":199,"_144":207,"_146":40,"_147":-5,"_186":208,"_96":209},{"_20":195,"_13":196,"_136":197,"_138":163,"_139":21,"_140":30,"_141":53,"_22":198,"_29":57,"_143":199,"_144":200,"_146":40,"_147":-5,"_186":201,"_96":202},{"_20":155,"_13":156,"_136":157,"_138":-5,"_139":21,"_140":30,"_141":53,"_22":192,"_29":57,"_143":108,"_144":159,"_146":40,"_147":-5,"_186":193,"_96":194},{"_20":149,"_13":150,"_136":51,"_138":-5,"_139":21,"_140":30,"_141":53,"_22":189,"_29":57,"_143":152,"_144":153,"_146":40,"_147":-5,"_186":190,"_96":191},{"_20":134,"_13":135,"_136":137,"_138":-5,"_139":21,"_140":30,"_141":53,"_22":185,"_29":57,"_143":108,"_144":145,"_146":40,"_147":-5,"_186":187,"_96":188},["D",1782761585368],"children",[],[135],["D",1782761585368],[],[150],["D",1782761585368],[],[156],"0588bd4d-c001-4fa6-829c-416f9f37cb32","slack-utils.ts","019f14de-fb34-7268-8bbc-576e90f2f555",["D",1782761585368],"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};",[],[162,196],"3fb69a02-ef91-468c-81b8-6975649ab16b","handle-thread-started.ts","019f14de-fb34-7268-8bbc-5288ad4e8a44",["D",1782761585368],"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}",[],[162,204],"35da5e07-d509-46f4-970c-43b96f524257","handle-message.ts","019f14de-fb34-7268-8bbc-4d31bb8669fe",["D",1782761585368],"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}",[],[162,211],"3222bef9-8481-454e-a06b-8b736d99d011","handle-app-mention.ts","019f14de-fb34-7268-8bbc-4ae367baa510",["D",1782761585368],"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}",[],[162,218],"9f6a198a-c179-4cc2-a17b-6fafcfe388b9","generate-response.ts","019f14de-fb34-7268-8bbc-447e25cfe6dd",["D",1782761585368],"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};",[],[162,225],["D",1782761585368],[177,178,179,180,181],[162],["D",1782761585368],{"_11":12,"_94":90},{"_11":12,"_87":88,"_89":90,"_48":49,"_91":92,"_93":40},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":32,"_33":34,"_80":42,"_81":82,"_83":84,"_85":14,"_86":12},"ctx",{"_73":-5,"_118":271,"_272":273,"_274":275,"_276":40,"_277":40,"_278":40,"_279":53,"_280":-5,"_281":-7,"_282":-7,"_283":57,"_284":40,"_285":40,"_286":-5,"_287":40,"_288":40,"_289":40,"_290":-5},"ENV",{"_242":243,"_244":245,"_246":26,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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