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",[],[126],"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)",[],[134],["D",1782761585368],[143,144,145,146,147],[19],{"_36":103,"_13":104,"_67":105,"_69":70,"_71":72,"_73":74,"_75":76,"_38":160,"_17":32,"_78":79,"_80":107,"_82":51,"_83":-5,"_122":161,"_18":162},{"_36":97,"_13":98,"_67":99,"_69":70,"_71":72,"_73":74,"_75":76,"_38":157,"_17":32,"_78":79,"_80":101,"_82":51,"_83":-5,"_122":158,"_18":159},{"_36":91,"_13":92,"_67":93,"_69":70,"_71":72,"_73":74,"_75":76,"_38":154,"_17":32,"_78":79,"_80":95,"_82":51,"_83":-5,"_122":155,"_18":156},{"_36":85,"_13":86,"_67":87,"_69":70,"_71":72,"_73":74,"_75":76,"_38":151,"_17":32,"_78":79,"_80":89,"_82":51,"_83":-5,"_122":152,"_18":153},{"_36":65,"_13":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_38":148,"_17":32,"_78":79,"_80":81,"_82":51,"_83":-5,"_122":149,"_18":150},["D",1782761585368],[],[19,66],["D",1782761585368],[],[19,86],["D",1782761585368],[],[19,92],["D",1782761585368],[],[19,98],["D",1782761585368],[],[19,104],"a4eb63c4-e09b-4aae-b839-378e9ac26575",["D",1782761585368],"legacyEnvVars","httpPrivacy","description","AI Slack bot (Claude + web search) for Charlie test workspace","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/2ba7b5a9-03f6-4d15-bbb8-f758d8342800/square512?exp=1789567199&sig=19a69d34b6dbe7d2438f0e70da29a794916ef3f38b066d9eccbf3ea8843954e2","userId","9319c175-2593-4f88-ba21-04f2ef7b1c28","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","d663a026-6449-42f6-9156-1d4a2d64d38c","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_209":205},"org",{"_11":12,"_202":203,"_204":205,"_171":172,"_206":207,"_208":51},"branch",{"_17":74,"_13":16,"_36":72,"_42":163,"_45":37,"_46":198,"_199":53,"_200":43,"_201":57,"_58":14,"_54":12},3,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","displayName","Charlie","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3e904faa-3764-4629-c475-f561a49b0000/square512?exp=1789567199&sig=e06d2452d15457d897c29ee2d4a45d8ac5b1a1a7b6bc3ec1d7706c1f90e23fa3","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_36":163,"_13":14,"_38":284,"_49":-5,"_165":51,"_52":53,"_166":53,"_167":168,"_169":170,"_171":172,"_173":127,"_174":76,"_175":-5,"_176":-5,"_177":32,"_56":178,"_179":-5,"_180":-5,"_181":-5,"_182":-5,"_183":184,"_185":184,"_186":187,"_188":187,"_189":187,"_190":184,"_191":184,"_192":285,"_194":286,"_196":287,"_50":51},[257,263,264,265],"files",[257,258,259,260,261,262,263,264,265],"counts",{"_248":32,"_249":74,"_250":32,"_35":251,"_252":253},[238,239,240,241,242],{"_36":109,"_13":19,"_67":70,"_69":-5,"_71":72,"_73":74,"_75":76,"_38":236,"_17":32,"_78":110,"_80":-5,"_82":51,"_83":-5,"_18":237},"upstreamProject",{"_36":43,"_13":59,"_167":233,"_169":170,"_52":53,"_192":234},"upstreamBranch",{"_36":37,"_38":231,"_40":232,"_13":16,"_42":43,"_17":44,"_45":-5,"_46":-5,"_47":48,"_49":-5,"_50":51,"_52":53,"_54":55,"_56":57,"_58":59},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1778104052955],["D",1786046294336],"AI Slackbot Quickstart",{"_11":55,"_209":235},"https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/129cab32-3bd7-4c3e-f39b-f12900c76100/square512?exp=1789567199&sig=d8af4f1d5d6ef07a152f6225f86a0227f22fe92650a7f9572d94a5f64256bba9",["D",1782761585368],[19],{"_36":103,"_13":104,"_67":105,"_69":70,"_71":72,"_73":74,"_75":76,"_38":106,"_17":32,"_78":79,"_80":107,"_82":51,"_83":-5,"_18":247},{"_36":97,"_13":98,"_67":99,"_69":70,"_71":72,"_73":74,"_75":76,"_38":100,"_17":32,"_78":79,"_80":101,"_82":51,"_83":-5,"_18":246},{"_36":91,"_13":92,"_67":93,"_69":70,"_71":72,"_73":74,"_75":76,"_38":94,"_17":32,"_78":79,"_80":95,"_82":51,"_83":-5,"_18":245},{"_36":85,"_13":86,"_67":87,"_69":70,"_71":72,"_73":74,"_75":76,"_38":88,"_17":32,"_78":79,"_80":89,"_82":51,"_83":-5,"_18":244},{"_36":65,"_13":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_38":77,"_17":32,"_78":79,"_80":81,"_82":51,"_83":-5,"_18":243},[19,66],[19,86],[19,92],[19,98],[19,104],"pulls","branches","forks",{"_254":198,"_256":198},"connections",{"_254":32,"_255":32},"count","unfilledCount","emptyCount",{"_36":109,"_13":19,"_67":70,"_69":-5,"_71":72,"_73":74,"_75":76,"_38":140,"_17":32,"_78":110,"_80":-5,"_82":51,"_83":-5,"_122":282,"_18":283},{"_36":103,"_13":104,"_67":105,"_69":70,"_71":72,"_73":74,"_75":76,"_38":160,"_17":32,"_78":79,"_80":107,"_82":51,"_83":-5,"_122":280,"_18":281},{"_36":97,"_13":98,"_67":99,"_69":70,"_71":72,"_73":74,"_75":76,"_38":157,"_17":32,"_78":79,"_80":101,"_82":51,"_83":-5,"_122":278,"_18":279},{"_36":91,"_13":92,"_67":93,"_69":70,"_71":72,"_73":74,"_75":76,"_38":154,"_17":32,"_78":79,"_80":95,"_82":51,"_83":-5,"_122":276,"_18":277},{"_36":85,"_13":86,"_67":87,"_69":70,"_71":72,"_73":74,"_75":76,"_38":151,"_17":32,"_78":79,"_80":89,"_82":51,"_83":-5,"_122":274,"_18":275},{"_36":65,"_13":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_38":148,"_17":32,"_78":79,"_80":81,"_82":51,"_83":-5,"_122":272,"_18":273},{"_36":133,"_13":134,"_67":135,"_69":-5,"_71":72,"_73":74,"_75":76,"_38":136,"_17":32,"_78":24,"_80":137,"_82":51,"_83":-5,"_122":270,"_18":271},{"_36":125,"_13":126,"_67":127,"_69":-5,"_71":72,"_73":74,"_75":76,"_38":128,"_17":32,"_78":129,"_80":130,"_82":51,"_83":-5,"_122":268,"_18":269},{"_36":117,"_13":118,"_67":119,"_69":-5,"_71":72,"_73":74,"_75":76,"_38":120,"_17":32,"_78":24,"_80":121,"_82":51,"_83":-5,"_122":266,"_18":267},[],[118],[],[126],[],[134],[],[19,66],[],[19,86],[],[19,92],[],[19,98],[],[19,104],[258,259,260,261,262],[19],["D",1782761585368],{"_11":12,"_209":205},{"_11":12,"_202":203,"_204":205,"_171":172,"_206":207,"_208":51},{"_17":74,"_13":16,"_36":72,"_42":163,"_45":37,"_46":198,"_199":53,"_200":43,"_201":57,"_58":14,"_54":12},"ctx",{"_192":-5,"_228":321,"_322":323,"_324":325,"_326":51,"_327":51,"_328":51,"_329":76,"_330":-5,"_331":-7,"_332":-7,"_333":32,"_334":51,"_335":51,"_336":-5,"_337":51,"_338":51,"_339":51,"_340":-5},"ENV",{"_292":293,"_294":295,"_296":16,"_297":298,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308,"_309":310,"_311":312,"_313":314,"_315":316,"_317":318,"_319":320},"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"]