Chat SDK

Chat SDK

Unified TypeScript SDK for building chat bots across Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear, and WhatsApp. Write bot logic once, deploy everywhere.

Start with published sources

When Chat SDK is installed in a user project, inspect the published files that ship in node_modules:

node_modules/chat/docs/                    # bundled docs
node_modules/chat/dist/index.d.ts          # core API types
node_modules/chat/dist/jsx-runtime.d.ts    # JSX runtime types
node_modules/chat/docs/contributing/       # adapter-authoring docs
node_modules/chat/resources/guides/        # framework/platform guides (markdown)
node_modules/chat/resources/templates.json # starter templates (title, description, href)

If one of the paths below does not exist, that package is not installed in the project yet.

Read these before writing code:

• node_modules/chat/docs/getting-started.mdx — install and setup
• node_modules/chat/docs/usage.mdx — Chat config and lifecycle
• node_modules/chat/docs/handling-events.mdx — event routing and handlers
• node_modules/chat/docs/threads-messages-channels.mdx — thread/channel/message model
• node_modules/chat/docs/posting-messages.mdx — post, edit, delete, schedule
• node_modules/chat/docs/streaming.mdx — AI SDK integration and streaming semantics
• node_modules/chat/docs/cards.mdx — JSX cards
• node_modules/chat/docs/actions.mdx — button/select interactions
• node_modules/chat/docs/modals.mdx — modal submit/close flows
• node_modules/chat/docs/slash-commands.mdx — slash command routing
• node_modules/chat/docs/direct-messages.mdx — DM behavior and openDM()
• node_modules/chat/docs/files.mdx — attachments/uploads
• node_modules/chat/docs/state.mdx — persistence, locking, dedupe
• node_modules/chat/docs/adapters.mdx — cross-platform feature matrix
• node_modules/chat/docs/api/chat.mdx — exact Chat API
• node_modules/chat/docs/api/thread.mdx — exact Thread API
• node_modules/chat/docs/api/message.mdx — exact Message API
• node_modules/chat/docs/api/modals.mdx — modal element and event details

For the specific adapter or state package you are using, inspect that installed package's dist/index.d.ts export surface in node_modules.

Available resources

<!-- RESOURCES:START -->

Guides

• node_modules/chat/resources/guides/how-to-build-an-ai-agent-for-slack-with-chat-sdk-and-ai-sdk.md — Build a Slack AI agent using Chat SDK, AI SDK's ToolLoopAgent, and Vercel AI Gateway. Covers project setup, tool definitions, streaming responses, deployment to Vercel, and scaling tool selection with toolpick.
• node_modules/chat/resources/guides/run-and-track-deploys-from-slack.md — Build a Slack deploy bot with Chat SDK and Vercel Workflow. Dispatch GitHub Actions from a slash command, gate production behind approval, poll for completion, and notify Linear and GitHub when the run finishes.
• node_modules/chat/resources/guides/triage-form-submissions-with-chat-sdk.md — Build a Slack bot that triages form submissions with interactive cards. Forward, edit, or mark as spam without leaving Slack. Built with Chat SDK, Hono, and Resend.
• node_modules/chat/resources/guides/how-to-build-a-slack-bot-with-next-js-and-redis.md — This guide walks through building a Slack bot with Next.js, covering project setup, Slack app configuration, event handling, interactive features, and deployment.
• node_modules/chat/resources/guides/create-a-discord-support-bot-with-nuxt-and-redis.md — This guide walks through building a Discord support bot with Nuxt, covering project setup, Discord app configuration, Gateway forwarding, AI-powered responses, and deployment.
• node_modules/chat/resources/guides/ship-a-github-code-review-bot-with-hono-and-redis.md — This guide walks through building a GitHub bot that reviews pull requests on demand. When a user @mentions the bot on a PR, Chat SDK picks up the mention, spins up a Vercel Sandbox with the repo cloned, and uses AI SDK to analyze the diff.

Templates

Listed in node_modules/chat/resources/templates.json:

• Chat SDK Liveblocks Bot — Build a bot that you can engage with inside Liveblocks. (https://vercel.com/templates/next.js/chat-sdk-liveblocks-bot)
• Knowledge Agent — Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base. (https://vercel.com/templates/nuxt/chat-sdk-knowledge-agent)
• Community Agent — Open source AI-powered Slack community management bot with a built-in Next.js admin panel. Uses Chat SDK, AI SDK, and Vercel Workflow. (https://vercel.com/templates/next.js/chat-sdk-community-agent)

<!-- RESOURCES:END -->

Quick start

import { Chat } from "chat";
import { createSlackAdapter } from "@chat-adapter/slack";
import { createRedisState } from "@chat-adapter/state-redis";

const bot = new Chat({
  userName: "mybot",
  adapters: {
    slack: createSlackAdapter(),
  },
  state: createRedisState(),
  dedupeTtlMs: 600_000,
});

bot.onNewMention(async (thread) => {
  await thread.subscribe();
  await thread.post("Hello! I'm listening to this thread.");
});

bot.onSubscribedMessage(async (thread, message) => {
  await thread.post(`You said: ${message.text}`);
});

Core concepts

• Chat — main entry point; coordinates adapters, routing, locks, and state
• Adapters — platform-specific integrations for Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear, and WhatsApp
• State adapters — persistence for subscriptions, locks, dedupe, and thread state
• Thread — conversation context with post(), stream(), subscribe(), setState(), startTyping()
• Message — normalized content with text, formatted, attachments, author info, and platform raw
• Channel — container for threads and top-level posts