Pular para o conteúdo
Voltar ao portfólio

Widget de chat da InBot

  • React
  • TypeScript
  • Vite
  • Shadow DOM
  • TailwindCSS
  • Vitest
  • Stryker

Meu papel

Desenvolvedor líder de um time de 3 pessoas, com QA, UX e UI. Fiz cerca de 350 dos 353 commits, de fevereiro a outubro de 2026.

Reescrevi o widget em React + TypeScript + Vite, entregue como um único arquivo carregado por uma tag <script>. A interface roda isolada em Shadow DOM, então o CSS do site do cliente não interfere nele. O widget renderiza com segurança o HTML que o bot envia, o que permite componentes ricos como cartões de apresentação, carrosséis e catálogos com busca e filtros. Também cobre o transbordo para atendimento humano (fila, digitando, retomada após recarregar a página), anexos, emojis, leitura em voz (TTS), histórico salvo, avaliação da resposta, 4 idiomas (pt, en, es, fr) e uma API window.inbot para o site controlar a conversa. Há dois bundles: o de produção e o de preview da plataforma de configuração.

Antes

Widget legado em JavaScript puro, sem etapa de build, com configuração espalhada e componentes novos adicionados caso a caso.

O problema

O widget de chat é a porta de entrada de todos os bots da InBot nos sites dos clientes. A versão antiga, em JavaScript puro e sem etapa de build, era difícil de evoluir e de testar, e cada componente novo que o bot precisava mostrar (cartões, carrosséis, catálogos) virava um remendo no código.

A solução

Reescrevi o widget em React + TypeScript + Vite, entregue como um único arquivo carregado por uma tag <script>. A interface roda isolada em Shadow DOM, então o CSS do site do cliente não interfere nele. O widget renderiza com segurança o HTML que o bot envia, o que permite componentes ricos como cartões de apresentação, carrosséis e catálogos com busca e filtros. Também cobre o transbordo para atendimento humano (fila, digitando, retomada após recarregar a página), anexos, emojis, leitura em voz (TTS), histórico salvo, avaliação da resposta, 4 idiomas (pt, en, es, fr) e uma API window.inbot para o site controlar a conversa. Há dois bundles: o de produção e o de preview da plataforma de configuração.

Decisões e trade-offs

Shadow DOM para isolar o widget do site do cliente, no lugar de prefixar o CSS. Um único arquivo IIFE para o cliente instalar com uma tag, sem dependências. Bundle separado para o preview da plataforma de configuração, que recebe a config por postMessage. Contrato HTTP, sessão e telemetria mantidos compatíveis com o widget legado, para a migração não exigir mudança no backend.

Os resultados

O novo widget roda em produção em vários bots e está pronto para novos clientes. Só no site da InBot, que migrou para ele no fim de setembro de 2026, são 9 bots, e em 25 dias foram cerca de 3.000 conversas e 9.300 interações pelo computador e pelo celular. Cada ambiente (dev, homologação e produção) tem a sua pasta na CDN, e nada vai para produção sem passar antes por dev e homologação. O código tem 116 arquivos de teste e mutation testing com Stryker.

Resultados em números

  • ~3.000conversas em 25 dias no site da InBot
  • 9.300+interações no mesmo período
  • 9bots do site rodando no widget
  • 4idiomas na interface
  • 116arquivos de teste