Kaptha Agents
Plataforma SaaS multi-tenant para criar e operar assistentes de IA em canais de atendimento, com integração ao Chatwoot, debounce de mensagens e regras de comportamento automáticas.
Kaptha Agents é uma plataforma SaaS multi-tenant para criar, configurar e operar assistentes de IA em canais de atendimento ao cliente, com foco inicial em integração com o Chatwoot. Organizações criam assistentes com instruções personalizadas, publicam em canais Chatwoot e definem regras automáticas de comportamento — debounce, inatividade, encerramento e reativação.
O sistema é monorepo Turborepo (apps/web em Next.js 16 com oRPC + TanStack Query, apps/server em Elysia) e é totalmente orientado a eventos: um webhook do Chatwoot chega, as mensagens são acumuladas com debounce, mídia é processada (Whisper para áudio, visão para imagens), um ToolLoopAgent do AI SDK v6 roda com Claude Sonnet via AI Gateway com as ferramentas do Chatwoot disponíveis, e a resposta é enviada de volta em streaming.
Cada conversa vive como sessão no Redis com TTL, e workers BullMQ cuidam da resposta de IA, mensagens de inatividade, encerramento e resumo de conversas arquivadas. A configuração do assistente é separada de `assistant_version` (snapshot imutável publicado via deployment), permitindo rollback fiel sem afetar conversas ativas.
Desafios técnicos
- –Debounce e acúmulo de mensagens em sessões Redis sem perder contexto entre mensagens fragmentadas do cliente
- –Diferenciar mensagens do próprio bot das de atendentes humanos via botUserId, evitando loops e marcando sessões como transferidas corretamente
- –Orquestrar workers BullMQ para resposta de IA, inatividade e encerramento sem condições de corrida entre jobs da mesma sessão
O que aprendi
- →Arquitetura orientada a eventos com BullMQ para debounce, inatividade e encerramento de conversas de forma assíncrona
- →oRPC + TanStack Query para uma API type-safe de ponta a ponta entre Next.js e Elysia