Velt Chat SDK Adapter Best Practices

Comprehensive guide for building bots that integrate with Velt comment threads via the Chat SDK Adapter (@veltdev/chat-sdk-adapter). The adapter bridges the cross-platform Chat SDK with Velt's comment threading system, so a single bot can run on Velt, Slack, Discord, and other Chat SDK-compatible platforms.

When to Apply

Reference these guidelines when:

• Building a bot that responds to @-mentions in Velt comment threads
• Setting up webhook routes to receive Velt comment/reaction events
• Configuring createVeltAdapter with proper credentials and user resolution
• Handling reactions (read on managed Velt, write requires self-hosting)
• Deploying a Velt bot to Vercel, other serverless platforms, or a Node.js server
• Building an AI agent that streams LLM replies into Velt threads

Core Architecture

The adapter is server-side only — it runs in your API routes, not in the browser. There is no VeltProvider or authProvider involved (those are client-side patterns for the Velt React SDK). The adapter authenticates via VELT_API_KEY and auto-generates auth tokens scoped to each organization.