Como usar o Claude como criador de chatbots (e como criar um bot do Telegram com ele)

Se você está pesquisando como criar um bot do Telegram, o Claude leva você quase até o fim: ele escreve os manipuladores, a máquina de estados, o endpoint do webhook e o arquivo de implantação, além de explicar o que cada parte faz. O que ele não consegue fazer é registrar o bot com o BotFather, guardar seu token, colocar o serviço em um servidor ou observar enquanto ele cai às duas da manhã. O código é a parte rápida. As contas, a hospedagem e o monitoramento continuam sendo responsabilidade sua.

Aceite essa divisão, e criar um bot com uma AI vira uma tarefa normal de uma tarde. Abaixo: a ordem, as escolhas de stack que importam e os prompts que produzem código que você pode executar.

O que o Claude realmente consegue criar e o que ainda precisa de você?

Os chatbots são um problema bem documentado, com bibliotecas estáveis, então este é quase o melhor cenário para o Claude: um manipulador de comandos funcional, uma máquina de estados de conversa, modelos de banco de dados, tratamento de erros e um Dockerfile, com as vantagens e desvantagens explicadas se você pedir. A divisão honesta do trabalho:

• O Claude faz: o código, a estrutura do projeto, a escolha da biblioteca com as justificativas, a configuração, os testes, o arquivo de implantação e a explicação na profundidade que você pedir.
• Você faz: cria a conta do bot e obtém o token, escolhe e paga pela hospedagem, define as variáveis de ambiente, aponta o domínio, executa a implantação e lê os logs quando algo quebra.
• Nenhum dos dois faz: garantir que a biblioteca não tenha mudado desde os dados de treinamento do modelo. Fixe as versões e leia as notas de lançamento quando algo parecer estranho.

Como criar um bot do Telegram com o Claude, passo a passo?

A sequência quase não muda entre os projetos.

• Registre o bot. Envie uma mensagem para o BotFather no Telegram, crie um bot, escolha um nome de usuário e guarde o token. Dois minutos, e ele será seu para fazer o que quiser.
• Decida entre polling e webhook. O polling é mais simples e funciona em qualquer lugar, inclusive no seu laptop. Um webhook precisa de uma URL HTTPS pública. Desenvolva com polling e publique com um webhook.
• Obtenha o esqueleto. Peça um bot em um único arquivo com um comando, execute-o e confirme que uma mensagem é retornada.
• Adicione o estado. Tudo que envolve várias etapas precisa se lembrar de onde o usuário está. Peça uma máquina de estados explícita em vez de um amontoado de instruções if, que é o que torna os bots impossíveis de alterar depois.
• Implante e monitore. Qualquer host pequeno serve. Mantenha o token em uma variável de ambiente, nunca no arquivo nem no repositório, e adicione registros: essa é a parte que você vai querer na primeira interrupção do serviço.

O truque é interromper cedo. Quando você pede "um bot do Telegram", um modelo entrega quatrocentas linhas que você não leu, e depurá-las é mais demorado do que escrever quarenta por conta própria.

Em qual stack o chatbot deve ficar?

Escolha com base em onde o bot precisa ser executado, não na linguagem de que você mais gosta.

Python é o padrão para bots de mensagens: bibliotecas maduras, exemplos por toda parte, e um bot do Telegram talvez tenha cerca de sessenta linhas antes de fazer algo interessante. O Skill de criação de chatbots em Python abrange Flask e Django, porque a resposta certa para um webhook pequeno e a resposta certa dentro de um projeto Django existente não são a mesma.

Node.js é a melhor opção quando o bot fica junto de um back-end JavaScript que você já executa ou quando você precisa de WebSockets e streaming sem um segundo runtime: o Skill de criação de chatbots em Node.js.

React é a outra metade: o widget na página. Respostas em streaming, estado das mensagens, comportamento de rolagem, indicadores de digitação e os detalhes de acessibilidade que acabam ficando de fora. O Skill de criação de chatbots em React funciona com qualquer back-end.

Spring Boot é para o bot dentro de um serviço Java existente, com a autenticação, os logs e o pipeline de implantação da própria empresa. Ninguém escolhe Spring Boot para chatbots Java por diversão, mas, quando ele é a stack padrão da empresa, a Skill considera as restrições corporativas em vez de um projeto de hobby.

WordPress é para o site que já existe e precisa de um widget que um não desenvolvedor consiga manter. A Skill de construção de chatbot para WordPress cuida da estrutura do plugin, dos hooks e da tela de configurações do painel, para que o cliente possa alterar a saudação sem abrir um editor de código. As demais estão na coleção de Skills de tecnologia e desenvolvimento.

Como você mantém as respostas do bot dentro do roteiro?

Um chatbot envolve dois problemas com o mesmo nome. A infraestrutura é como as mensagens entram e saem, e essa é a parte fácil. O comportamento é o que o bot diz, e é aí que as coisas são mal implementadas: bots que respondem a perguntas que deveriam recusar, inventam políticas ou soam como alguém que não trabalha na sua empresa. O comportamento é um documento escrito, não um problema de programação: um bot de suporte precisa de um escopo, uma lista de recusas, uma regra de escalonamento e um tom. Para um produto de software, o prompt de chatbot de suporte para SaaS é esse documento: ele responde ao que está documentado e transforma todo o resto em um chamado estruturado que um engenheiro pode resolver sem precisar fazer uma pergunta de acompanhamento. Insira-o no prompt de sistema do que você criou e o bot para de improvisar.

O Telegram tem suas próprias convenções: comandos de barra, mensagens curtas e bots que permanecem em silêncio em chats em grupo. Para um bot empresarial no Telegram, o prompt de chatbot do Telegram para empresas ($14.99) cobre essa camada, incluindo uma frase fixa de encaminhamento.

E quanto aos bots do Discord e do WhatsApp?

A mesma arquitetura, uma porta de entrada diferente, e as diferenças estão nas regras da plataforma, não no código. O Discord oferece uma conexão de gateway, comandos de barra registrados antecipadamente e um modelo de permissões que será o primeiro a falhar. O WhatsApp usa a Business Platform: um remetente aprovado, modelos de mensagem para qualquer coisa fora de uma janela de 24 horas e um processo de revisão que você não consegue contornar programando.

Crie os dois com as Skills acima. O manipulador, a máquina de estados e a especificação de comportamento são idênticos; apenas o transporte muda. Portanto, peça ao Claude para escrever o adaptador como seu próprio módulo, por trás de uma interface pequena, e adicionar uma segunda plataforma depois será uma questão de trocar um arquivo, não de reescrever tudo. Comece pedindo que ele liste todas as contas, aprovações e credenciais de que a plataforma precisa antes que qualquer código exista: no WhatsApp, essa lista é maior que o código.

Onde ele falha?

• As APIs das bibliotecas mudam. Um código correto há uma versão pode compilar e depois se comportar mal. Fixe as versões e consulte o changelog quando algo funciona na explicação, mas não no terminal.
• Ele não consegue ver o seu erro. Cole o traceback completo, não uma paráfrase. Um erro resumido custa três rodadas de tentativas.
• Ele não dirá que o projeto está superdimensionado. Peça uma fila baseada em Redis e você terá uma, mesmo que um dicionário fosse suficiente. Os limites de taxa da plataforma e as regras sobre mensagens não solicitadas também não estão no código: leia-as antes do lançamento.
• A segurança é tão boa quanto o seu prompt. Pergunte explicitamente sobre o tratamento de tokens, a validação de entradas e o que é gravado nos logs, ou você terá um bot funcional que vaza dados.
• Ele não pode executar nem implantar nada. Todo comando que ele fornece é para você executar.

Como você instala as Skills de criação de chatbots?

Cada um é um arquivo SKILL.md dentro de um ZIP. No Claude, abra Personalizar, depois Skills, pressione +, escolha Criar skill, depois Enviar uma skill e selecione o ZIP. Ative-a e ela será aplicada ao seu próximo chat. As Skills funcionam nos planos Free, Pro, Max, Team e Enterprise; o requisito é a execução de código, em Configurações, depois Recursos. A Anthropic documenta isso em seu artigo de ajuda sobre Skills, e os locais das pastas estão em nosso guia de instalação.

No ChatGPT ou Gemini, copie o texto do SKILL.md para as instruções personalizadas ou para um Gem. Os mesmos arquivos são carregados no Claude Code, conforme explicado no guia de Skills do Claude Code.

Guias de Skills relacionados

• Como usar o Claude como desenvolvedor backend: o guia do Skill Niko
• Melhores geradores de AI para desenvolvedores em 2026: regex, SQL, testes unitários e revisão de código
• Como escrever um prompt de sistema: um guia prático (2026)
• Skills do Claude Code: como instalá-los, onde ficam e 15 Skills para desenvolvedores
• Como instalar um Skill do Claude (e onde a pasta de Skills realmente fica)