Como Fazer

Como Criar um Bot de Telegram Inteligente com BuildShip e OpenAI

Xavier

28 Mai 2025 • 4 min read

Introdução ao Desenvolvimento de Bots no Telegram com BuildShip

Os bots do Telegram tornaram-se ferramentas indispensáveis para automação, atendimento ao cliente e engajamento. Neste artigo, exploraremos como criar um bot para o Telegram de forma eficiente utilizando o BuildShip, uma plataforma low-code que simplifica o desenvolvimento de back-ends robustos. Além disso, vamos potencializar nosso bot com a inteligência artificial da OpenAI, permitindo respostas dinâmicas e contextuais.

O que é o BuildShip?

O BuildShip é uma plataforma inovadora que permite a criação de funções de nuvem, APIs e tarefas agendadas de maneira visual. Combinando a facilidade do no-code com a flexibilidade do código, o BuildShip capacita desenvolvedores e entusiastas a construir back-ends poderosos sem a complexidade tradicional da infraestrutura e do desenvolvimento server-side. Conforme demonstrado em seu material de divulgação, a plataforma é ideal para prototipagem rápida e para escalar projetos com integrações complexas.

Criando seu Primeiro Bot no Telegram com BuildShip

O processo de criação de um bot no Telegram utilizando o BuildShip pode ser dividido em etapas claras e objetivas. Vamos detalhar cada uma delas.

Passo 1: Configurando o Bot no Telegram com o BotFather

Para iniciar, é preciso registrar seu bot no próprio Telegram. Isso é feito através do BotFather, um bot oficial do Telegram para gerenciar outros bots.

Abra uma conversa com o @BotFather no Telegram.
Envie o comando /start para ver as opções disponíveis.
Utilize o comando /newbot para criar um novo bot.
Siga as instruções, fornecendo um nome de exibição para o seu bot (ex: MeuBotBuildShip) e um nome de usuário único, que deve terminar com 'bot' (ex: MeuBuildShip_bot).
Ao final do processo, o BotFather fornecerá um token de API HTTP. Este token é crucial e deve ser guardado em segurança, pois é ele que permitirá a comunicação entre o BuildShip e o seu bot.

Passo 2: Iniciando o Projeto no BuildShip

Com o token em mãos, o próximo passo é configurar o BuildShip.

Acesse sua conta no BuildShip e crie um novo workflow.
Adicione um gatilho (trigger). Na lista de opções, selecione "Telegram Bot".
O gatilho solicitará o "API Token". É aqui que você colará o token fornecido pelo BotFather. O BuildShip permite armazenar tokens e outras informações sensíveis de forma segura através da funcionalidade "Secrets", o que é uma prática recomendada.

Passo 3: Enviando a Primeira Mensagem

Com o gatilho configurado, vamos fazer nosso bot enviar uma mensagem.

Adicione um novo nó (node) ao seu workflow. Procure e adicione o nó "Send Telegram Message".
Este nó requer algumas informações:
- Chat ID: Identificador único da conversa para onde a mensagem será enviada. Para obter o Chat ID de um grupo, você pode adicionar temporariamente um bot como o @RawDataBot ao grupo; ele informará o ID do chat.
- Telegram API Token: Novamente, utilize o token do seu bot, preferencialmente acessando-o via "Secrets".
- Text: A mensagem que você deseja enviar (ex: "Olá do BuildShip!").
Após o nó de envio de mensagem, adicione um nó "Return". Configure o "Status code" para 200 (OK) e o campo "Value" para receber a resposta do nó "Send Telegram Message". Isso garante que o workflow finalize corretamente.

Passo 4: Testando o Bot Básico

Crie um novo grupo no Telegram.
Adicione o bot que você acabou de criar (ex: MeuBuildShip_bot) ao grupo. Se precisar do Chat ID do grupo, adicione também o @RawDataBot.
Publique (ship) seu workflow no BuildShip.
Se tudo estiver configurado corretamente, o bot deverá enviar a mensagem pré-definida ao ser adicionado ao grupo ou quando o gatilho for ativado de outra forma.

Turbinando seu Bot com Inteligência Artificial (OpenAI) via BuildShip

Agora, vamos tornar nosso bot mais interativo e inteligente, integrando-o com a OpenAI.

Integrando o OpenAI GPT

No seu workflow do BuildShip, antes do nó "Send Telegram Message", adicione um nó "OpenAI GPT Text Generator".
Configure este nó:
- API Key: Sua chave de API da OpenAI, que também deve ser armazenada como um "Secret" no BuildShip.
- User Prompt: A entrada do usuário que será enviada ao modelo GPT. Esta informação virá dinamicamente do gatilho do Telegram (message.text), representando a mensagem que o usuário enviou ao bot.
- System Prompt: Uma instrução para guiar o comportamento do modelo GPT (ex: "Responda à mensagem do usuário de forma útil e amigável.").

Adaptando o Envio de Mensagem

Modifique o nó "Send Telegram Message":

O campo "Text" não será mais uma mensagem estática. Em vez disso, ele deverá receber a saída (response) do nó "OpenAI GPT Text Generator". Isso significa que a resposta do bot será o texto gerado pela inteligência artificial.

Testando o Bot Inteligente

Publique as alterações no seu workflow do BuildShip.
No Telegram, envie uma mensagem para o seu bot no grupo (ex: "Olá, mundo!").
O bot agora deverá responder utilizando a inteligência do ChatGPT, com base no seu prompt e na mensagem recebida. Por exemplo, ele pode responder com "Olá! Como posso te ajudar hoje?".

Por Que Usar BuildShip para Desenvolver Bots de Telegram?

Utilizar o BuildShip para o desenvolvimento de bots para Telegram oferece diversas vantagens:

Velocidade de Desenvolvimento: A interface visual e os nós pré-construídos aceleram significativamente o processo.
Facilidade de Integração: Conectar-se a serviços externos, como a API do Telegram e da OpenAI, é simplificado.
Abstração de Infraestrutura: Não há necessidade de se preocupar com servidores, deploy ou escalabilidade inicial, pois o BuildShip gerencia o backend.
Flexibilidade Low-Code: Permite que tanto usuários com menos experiência em programação quanto desenvolvedores experientes criem soluções customizadas, podendo adicionar código JavaScript quando necessário.

Plataformas como o BuildShip são um exemplo claro da evolução do desenvolvimento de software, tornando a criação de aplicações complexas mais acessível.

Conclusão

Criar um bot para Telegram com BuildShip é um processo surpreendentemente simples e poderoso. A capacidade de integrar facilmente serviços de terceiros, como a OpenAI, abre um leque de possibilidades para a criação de bots verdadeiramente inteligentes e úteis. O que demonstramos aqui é apenas o ponto de partida; o BuildShip oferece as ferramentas para expandir essa base e construir backends sofisticados para diversas aplicações. Experimente e descubra o potencial do desenvolvimento low-code para seus projetos!