Chatbots em TypeScript: guia completo para criar do zero

Por que o TypeScript é a melhor escolha para chatbots?

Quando se trata de criar chatbots, muitos desenvolvedores pensam imediatamente em Python ou JavaScript. Mas existe uma linguagem que combina a flexibilidade da tipagem dinâmica com a segurança da verificação estática — é o TypeScript. Neste guia prático, vamos abordar como criar chatbots em TypeScript que não apenas funcionam de forma estável, mas também são fáceis de manter.

TypeScript não é apenas um "superset" do JavaScript. É uma ferramenta completa que permite escrever código mais difícil de quebrar. Imagine: você está escrevendo um bot para o Telegram e, de repente, seu colega passa para a função não uma string, mas um número. Em JavaScript, você descobriria isso em tempo de execução, quando o bot falhasse. Em TypeScript, o compilador informa o erro antes mesmo da execução. Isso não é mágico?

Por onde começar: configuração do ambiente

Antes de mergulharmos no código, vamos configurar o ambiente de trabalho. Precisaremos do Node.js (versão 16 ou superior) e do gerenciador de pacotes npm ou yarn.

Passo 1: Inicialização do projeto

mkdir my-chat-bot\ncd my-chat-bot\nnpm init -y\n

Passo 2: Instalação das dependências

Para trabalhar com chatbots, usaremos a biblioteca popular telegraf (para Telegram) e discord.js (para Discord). Mas neste guia, focaremos em uma abordagem universal.

npm install typescript @types/node telegraf dotenv\nnpx tsc --init\n

O arquivo tsconfig.json precisa ser ajustado: ative strict: true e defina outDir: "./dist". Isso tornará o código mais seguro.

Estrutura do projeto para chatbots em TypeScript

Uma boa arquitetura é a chave para o sucesso. Aqui está como recomendo organizar os arquivos:

src/\n├── bot/\n│   ├── index.ts          # Ponto de entrada\n│   ├── handlers/         # Manipuladores de comandos\n│   ├── middleware/        # Manipuladores intermediários\n│   └── types/            # Tipos e interfaces\n├── config/\n│   └── index.ts          # Configuração\n└── utils/\n    └── logger.ts         # Registro de logs\n

Escrevendo o primeiro chatbot em TypeScript

Vamos criar um bot simples para o Telegram que responde ao comando /start e a mensagens de eco.

Arquivo: src/config/index.ts

import dotenv from 'dotenv';\ndotenv.config();\n\nexport const config = {\n  BOT_TOKEN: process.env.BOT_TOKEN || '',\n  PORT: parseInt(process.env.PORT || '3000')\n};\n

Arquivo: src/bot/index.ts

import { Telegraf } from 'telegraf';\nimport { config } from '../config';\nimport { startHandler } from './handlers/start';\nimport { echoHandler } from './handlers/echo';\n\nconst bot = new Telegraf(config.BOT_TOKEN);\n\n// Registramos os manipuladores\nbot.start(startHandler);\nbot.on('text', echoHandler);\n\n// Iniciamos o bot\nbot.launch()\n  .then(() => console.log('Bot iniciado!'))\n  .catch((err) => console.error('Erro ao iniciar:', err));\n\n// Desligamento gracioso\nprocess.once('SIGINT', () => bot.stop('SIGINT'));\nprocess.once('SIGTERM', () => bot.stop('SIGTERM'));\n

Arquivo: src/bot/handlers/start.ts

import { Context } from 'telegraf';\n\nexport const startHandler = async (ctx: Context) => {\n  const userName = ctx.from?.first_name || 'amigo';\n  await ctx.reply(`Olá, ${userName}! Sou um bot em TypeScript. Escreva algo para mim.`);\n};\n

Arquivo: src/bot/handlers/echo.ts

import { Context } from 'telegraf';\n\nexport const echoHandler = async (ctx: Context) => {\n  const message = ctx.message?.text || '';\n  await ctx.reply(`Você escreveu: "${message}". Legal!`);\n};\n

Observe a tipagem: Context da biblioteca telegraf é totalmente tipado. Isso significa que a IDE sugerirá todos os métodos e propriedades disponíveis. Chatbots em Ty