chat-sdk
Build multi-platform chat bots with Chat SDK (`chat` npm package). Use when developers want to build a Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear, or WhatsApp bot, handle mentions, direct messages, subscribed threads, reactions, slash commands, cards, modals, files, or AI streaming, set up webhook routes or multi-adapter bots, send rich cards or streamed AI responses to chat platforms, or build a custom adapter or state adapter.
Security Assessment
About chat-sdk
Chat SDK is a unified TypeScript toolkit designed to simplify building chat bots that work across multiple messaging platforms. It addresses the common problem of platform fragmentation, where developers must typically build and maintain separate bot implementations for services like Slack, Microsoft Teams, Google Chat, Discord, Telegram, GitHub, Linear, and WhatsApp. With this SDK, developers can define their bot logic once and deploy it consistently across supported platforms, reducing duplication and maintenance overhead.
The SDK provides a structured model built around core concepts such as Chat, Thread, Message, and Channel. It includes a flexible adapter system that connects bot logic to different platforms, as well as state adapters for handling persistence tasks like subscriptions, deduplication, locking, and thread state management. It also supports event-driven workflows, allowing bots to respond to mentions, direct messages, subscribed threads, reactions, slash commands, and interactive components like cards and modals. Additional capabilities include message posting, editing, deletion, scheduling, file handling, and streaming AI-style responses for real-time interactions. The system is designed to integrate with webhook routes and supports multi-adapter deployments, enabling a single bot to operate across multiple chat environments simultaneously.
Chat SDK is intended for developers and teams building production-grade chat bots, AI assistants, and automation tools that need to operate across different messaging ecosystems. It is especially useful for building customer support bots, internal productivity assistants, workflow automation agents, and AI-driven conversational interfaces. By abstracting platform-specific differences, it allows engineering teams to focus on conversation logic and user experience rather than integration complexity.
FAQ
Which chat platforms does Chat SDK support?
It supports multiple platforms including Slack, Microsoft Teams, Google Chat, Discord, Telegram, GitHub, Linear, and WhatsApp through platform adapters.
Do I need to use adapters for each platform?
Yes, adapters are used to connect the core Chat logic to each platform, allowing the same bot behavior to run across different services.
Can Chat SDK handle real-time streaming responses?
Yes, it supports streaming semantics for AI-style responses, enabling real-time message updates in supported chat environments.
Does Chat SDK support persistent state?
Yes, state adapters are included for managing persistence such as subscriptions, deduplication, locks, and thread state.
Is it possible to extend or customize the SDK?
Yes, developers can work with custom adapters or state adapters to extend functionality or integrate new platforms.
Install chat-sdk
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
vercel/chat