Documentação de Arquitetura - JoaoMelloD/py-chatbot GitHub Wiki

Visão Geral

Um “robô de conversa” – ou chatbot – que responde automaticamente às dúvidas mais comuns dos clientes. Quando a pergunta foge do script ou exige atenção especial, ele chama um atendente humano e entrega toda a conversa já ocorrida para que o atendente continue sem perda de contexto.

  • Quem se beneficia?

    • O cliente se beneficia pois recebe respostas instantâneas 24 h por dia, sem esperar em uma fila por atendimento.
    • A equipe de suporte ao cliente fica livre das perguntas repetitivas e pode focar nos casos realmente complexos.
    • A empresa ganha eficiência, reduz tempo de espera, mantém o mesmo padrão de atendimento em site, app, WhatsApp e redes sociais.

Escolha de Tecnologia

Buscamos o uso de python como principal tecnologia por fatores como ecossistema já que o python possui ferramentas e bibliotecas robustas para integração com IA e NLP, além de sua facilidade de aprendizado e sua sintaxe limpa, que nos ajuda na hora de documentar. Como interface, preferimos pelo uso de tecnologias mais populares para a geração de interface, que no caso seria o React, visto que é a escolha que apresenta uma curva de aprendizado melhor além de um bom conhecimento da equipe em cima dessa tecnologia para o front-end.

imagem chatbot

Como funciona?

  1. Cliente inicia o chat

    • Pode ser no site, aplicativo, WhatsApp ou rede social.

  2. Chatbot analisa a mensagem

    • Ele compara a dúvida com uma base de conhecimento alimentada pela equipe.

  3. Dá a resposta automática

    • Se encontrar resposta, envia na hora.

  4. Detecta casos mais complexos

    • Se a pergunta é diferente do que ele conhece, ou o cliente insiste, o bot sinaliza que precisa de um humano.

  5. Transfere para atendente

    • Envia o histórico completo da conversa; o atendente assume sem o cliente precisar repetir tudo.

  6. Aprendizado contínuo

    • Perguntas que o bot não soube responder viram sugestões para ampliar a base de conhecimento, tornando‑o cada vez mais esperto.

fluxograma do chatbot

Principais tecnologias utilizadas:

  • Python 3.12

    • Python reduzindo esforço de integração e tem a curva de aprendizado curta, é de fácil utilização.

  • Github Wiki

    • Fácil documentação e profissionalidade da plataforma.

  • Github Projects

    • Organização do Kambam do projeto e Cronograma sequencial.

  • Figma

    • Criação do protótipo.