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",[],[125],"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.",[],[133],["D",1778091266284],[142,143,144,145,146],[19],{"_36":102,"_13":103,"_66":104,"_68":69,"_70":71,"_72":73,"_74":75,"_38":159,"_17":32,"_77":78,"_79":106,"_81":51,"_82":-5,"_121":160,"_18":161},{"_36":96,"_13":97,"_66":98,"_68":69,"_70":71,"_72":73,"_74":75,"_38":156,"_17":32,"_77":78,"_79":100,"_81":51,"_82":-5,"_121":157,"_18":158},{"_36":90,"_13":91,"_66":92,"_68":69,"_70":71,"_72":73,"_74":75,"_38":153,"_17":32,"_77":78,"_79":94,"_81":51,"_82":-5,"_121":154,"_18":155},{"_36":84,"_13":85,"_66":86,"_68":69,"_70":71,"_72":73,"_74":75,"_38":150,"_17":32,"_77":78,"_79":88,"_81":51,"_82":-5,"_121":151,"_18":152},{"_36":64,"_13":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_38":147,"_17":32,"_77":78,"_79":80,"_81":51,"_82":-5,"_121":148,"_18":149},["D",1778091266284],[],[19,65],["D",1778091266284],[],[19,85],["D",1778091266284],[],[19,91],["D",1778091266284],[],[19,97],["D",1778091266284],[],[19,103],"6a9052c2-4977-11f1-bd30-42b51c65c3df",["D",1778091266284],"legacyEnvVars","httpPrivacy","description","AI Slackbot Quickstart","imageUrl","userId","9319c175-2593-4f88-ba21-04f2ef7b1c28","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_205":201},"org",{"_11":12,"_198":199,"_200":201,"_169":170,"_202":203,"_204":51},"branch",{"_17":73,"_13":16,"_36":71,"_42":162,"_45":37,"_46":34,"_195":53,"_196":43,"_197":56,"_57":14,"_54":12},"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","displayName","Charlie","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3e904faa-3764-4629-c475-f561a49b0000/square512?exp=1789640915&sig=f551f10abf416ac9f0c239b1bfcfd810d377b86eb6a6ab71b2234ede1530298e","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_36":162,"_13":14,"_38":278,"_49":-5,"_164":51,"_52":53,"_165":53,"_166":167,"_168":-5,"_169":170,"_171":126,"_172":75,"_173":-5,"_174":-5,"_175":32,"_55":56,"_176":-5,"_177":-5,"_178":-5,"_179":-5,"_180":181,"_182":181,"_183":184,"_185":184,"_186":184,"_187":181,"_188":181,"_189":279,"_191":280,"_193":281,"_50":51},[251,257,258,259],"files",[251,252,253,254,255,256,257,258,259],"counts",{"_241":32,"_242":73,"_243":32,"_35":244,"_245":246},[231,232,233,234,235],{"_36":108,"_13":19,"_66":69,"_68":-5,"_70":71,"_72":73,"_74":75,"_38":109,"_17":32,"_77":110,"_79":-5,"_81":51,"_82":-5,"_18":230},"upstreamProject",{"_36":43,"_13":58,"_166":167,"_168":-5,"_52":53,"_189":229},"upstreamBranch",{"_36":37,"_38":227,"_40":228,"_13":16,"_42":43,"_17":44,"_45":-5,"_46":-5,"_47":48,"_49":-5,"_50":51,"_52":53,"_54":12,"_55":56,"_57":58},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1778090018788],["D",1778104226347],{"_11":12,"_205":201},[19],{"_36":102,"_13":103,"_66":104,"_68":69,"_70":71,"_72":73,"_74":75,"_38":105,"_17":32,"_77":78,"_79":106,"_81":51,"_82":-5,"_18":240},{"_36":96,"_13":97,"_66":98,"_68":69,"_70":71,"_72":73,"_74":75,"_38":99,"_17":32,"_77":78,"_79":100,"_81":51,"_82":-5,"_18":239},{"_36":90,"_13":91,"_66":92,"_68":69,"_70":71,"_72":73,"_74":75,"_38":93,"_17":32,"_77":78,"_79":94,"_81":51,"_82":-5,"_18":238},{"_36":84,"_13":85,"_66":86,"_68":69,"_70":71,"_72":73,"_74":75,"_38":87,"_17":32,"_77":78,"_79":88,"_81":51,"_82":-5,"_18":237},{"_36":64,"_13":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_38":76,"_17":32,"_77":78,"_79":80,"_81":51,"_82":-5,"_18":236},[19,65],[19,85],[19,91],[19,97],[19,103],"pulls","branches","forks",{"_247":249,"_250":249},"connections",{"_247":32,"_248":32},"count","unfilledCount",3,"emptyCount",{"_36":108,"_13":19,"_66":69,"_68":-5,"_70":71,"_72":73,"_74":75,"_38":139,"_17":32,"_77":110,"_79":-5,"_81":51,"_82":-5,"_121":276,"_18":277},{"_36":102,"_13":103,"_66":104,"_68":69,"_70":71,"_72":73,"_74":75,"_38":159,"_17":32,"_77":78,"_79":106,"_81":51,"_82":-5,"_121":274,"_18":275},{"_36":96,"_13":97,"_66":98,"_68":69,"_70":71,"_72":73,"_74":75,"_38":156,"_17":32,"_77":78,"_79":100,"_81":51,"_82":-5,"_121":272,"_18":273},{"_36":90,"_13":91,"_66":92,"_68":69,"_70":71,"_72":73,"_74":75,"_38":153,"_17":32,"_77":78,"_79":94,"_81":51,"_82":-5,"_121":270,"_18":271},{"_36":84,"_13":85,"_66":86,"_68":69,"_70":71,"_72":73,"_74":75,"_38":150,"_17":32,"_77":78,"_79":88,"_81":51,"_82":-5,"_121":268,"_18":269},{"_36":64,"_13":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_38":147,"_17":32,"_77":78,"_79":80,"_81":51,"_82":-5,"_121":266,"_18":267},{"_36":132,"_13":133,"_66":134,"_68":-5,"_70":71,"_72":73,"_74":75,"_38":135,"_17":32,"_77":24,"_79":136,"_81":51,"_82":-5,"_121":264,"_18":265},{"_36":124,"_13":125,"_66":126,"_68":-5,"_70":71,"_72":73,"_74":75,"_38":127,"_17":32,"_77":128,"_79":129,"_81":51,"_82":-5,"_121":262,"_18":263},{"_36":116,"_13":117,"_66":118,"_68":-5,"_70":71,"_72":73,"_74":75,"_38":119,"_17":32,"_77":24,"_79":120,"_81":51,"_82":-5,"_121":260,"_18":261},[],[117],[],[125],[],[133],[],[19,65],[],[19,85],[],[19,91],[],[19,97],[],[19,103],[252,253,254,255,256],[19],["D",1778091266284],{"_11":12,"_205":201},{"_11":12,"_198":199,"_200":201,"_169":170,"_202":203,"_204":51},{"_17":73,"_13":16,"_36":71,"_42":162,"_45":37,"_46":34,"_195":53,"_196":43,"_197":56,"_57":14,"_54":12},"ctx",{"_189":-5,"_224":315,"_316":317,"_318":319,"_320":51,"_321":51,"_322":51,"_323":75,"_324":-5,"_325":-7,"_326":-7,"_327":32,"_328":51,"_329":51,"_330":-5,"_331":51,"_332":51,"_333":51,"_334":-5},"ENV",{"_286":287,"_288":289,"_290":16,"_291":292,"_293":294,"_295":296,"_297":298,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308,"_309":310,"_311":312,"_313":314},"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"]