Assistente de Suporte Guiado por Fluxo JSON, sem IA

← voltar ao portfólio

08/2025 – 08/2026 · 1 semana

Primeira linha de suporte técnico de um PABX em nuvem, com o diálogo inteiro declarado em JSON e nenhuma dependência de IA.

JavaScript (ES6+)HTML5CSS3JSONmáquina de estados

O problema

Suporte técnico gasta a maior parte do tempo com as mesmas perguntas de configuração. A resposta da moda é colocar um modelo de linguagem na frente, mas isso traz três custos que nem sempre se justificam: cobrança por atendimento, dependência de rede e, o mais sério aqui, a possibilidade de inventar um passo de configuração que não existe. Em instrução técnica de PABX, uma resposta plausível e errada faz o cliente mexer no que estava certo.

A arquitetura

O diálogo é dado, não código. Cada nó do fluxo declara sua mensagem e suas opções, e cada opção aponta para o próximo nó — uma máquina de estados escrita em JSON, com 58 nós e 200 caminhos de navegação. O painel de configuração carrega esse JSON em tempo de execução e guarda um histórico de configurações, de modo que o mesmo aplicativo atende fluxos diferentes: um de Suporte Técnico, outro de Vendas. Quem mantém o atendimento edita texto, não JavaScript. A implementação é HTML, CSS e JavaScript puros, sem framework e sem etapa de build, e roda de um único arquivo no navegador — sem servidor, sem chave de API e sem chamada de rede. O indicador de digitação existe para dar ritmo de conversa a uma interação que, por baixo, é instantânea.

O resultado

Assistente de 1.334 linhas cobrindo oito áreas de suporte do produto — introdução, login e conta, chamadas e mensagens, filas, Caller ID, SMS e WhatsApp, softphone, códigos de função e suporte técnico — com resposta imediata e determinística. Como não há inferência, o custo por atendimento é zero e o comportamento é auditável: dado um caminho de cliques, a resposta é sempre a mesma, e conferi-la é ler o JSON.

O atendimento em uso: o cliente escolhe, o assistente responde e o submenu do tema aparece
O atendimento em uso: o cliente escolhe, o assistente responde e o submenu do tema aparece
O diálogo é dado: o painel carrega o fluxo em JSON e guarda configurações distintas
O diálogo é dado: o painel carrega o fluxo em JSON e guarda configurações distintas

🔒 Código-fonte

git clone https://git.programandosolucoes.com.br/git/repos/manual-chat.git

Código-fonte privado. As credenciais de leitura são liberadas sob solicitação — me chame para conversar sobre o projeto.

Carlos Alberto — carlosalberto4ti@gmail.com · +55 11 2615-2880