Template estrutural open-source para chatbots conversacionais via WhatsApp Cloud API.

Abstract

Este trabalho apresenta um template estrutural open-source para o desenvolvimento de chatbots conversacionais integrados à WhatsApp Cloud API, com foco em arquitetura modular, reutilização e escalabilidade. A pesquisa é de natureza aplicada, com abordagem qualitativa e caráter experimental. A proposta é disponibilizar ao leitor uma base de código que abstrai camadas de servidor (Node.js/Express), controle de mensagens e códigos utilitários, de modo que o desenvolvedor concentre seus esforços apenas na lógica de negócio do bot. A validação experimental empregou Ngrok para homologação de webhooks e testes de desempenho, estabilidade e tratamento de falhas, incluindo o envio e recebimento de texto, imagens e botões interativos. Como aplicação prática, o template foi utilizado em uma empresa de engenharia em Belo Horizonte para vistorias veiculares via WhatsApp: o motorista responde a um checklist guiado (placa obrigatória, itens de segurança e integridade, fotos e observações), e as respostas são armazenadas em banco de dados, no caso deste projeto, optou-se pelo PostgreSQL. Uma API REST desenvolvida em Python abastece um dashboard web que permite consultar vistorias por placa, visualizar fichas, gerar relatórios e baixar PDFs. Os resultados indicam que a solução é estável, escalável e extensível, confirmando sua adequação como infraestrutura base para projetos de automação conversacional e como contribuição reutilizável à comunidade.