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",[],[250],"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.",[],[257],["D",1778101075191],[],[18,77],["D",1778101075191],[],[18,89],["D",1778101075191],[],[18,95],["D",1778101075191],[],[18,101],["D",1778101075191],[],[18,106],["D",1778101075191],[233,234,235,236,237],[18],["D",1778101075191],{"_11":12,"_159":83},{"_11":12,"_154":155,"_82":83,"_31":81,"_156":157,"_158":30},{"_39":40,"_13":16,"_33":36,"_144":110,"_145":72,"_146":147,"_148":114,"_149":150,"_151":42,"_152":14,"_153":12},"ctx",{"_52":-5,"_180":318,"_319":320,"_321":322,"_323":30,"_324":30,"_325":30,"_326":24,"_327":-5,"_328":-7,"_329":-7,"_330":26,"_331":30,"_332":30,"_333":-5,"_334":30,"_335":30,"_336":30,"_337":-5},"ENV",{"_289":290,"_291":292,"_293":16,"_294":295,"_296":297,"_298":299,"_300":301,"_302":303,"_304":305,"_306":307,"_308":309,"_310":311,"_312":313,"_314":315,"_316":317},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","899124c68db8496248a17ee95f074b807335ea7b","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"]

History · lib