O plugin do Telegram Bot adiciona blocos de programação do tipo servidor ao projeto, o que possibilita uma série de funcionalidades, incluindo envio de mensagens, gerenciamento de conversas, integração de mídia e arquivos, e muito mais. Veja mais detalhes sobre os blocos em API do Telegram Bot.

O Telegram é um aplicativo de mensagens instantâneas conhecido por sua rapidez e segurança. Com ele, você pode enviar mensagens, fotos, vídeos e arquivos de qualquer tipo para seus contatos. Além disso, é possível criar grupos com até 200.000 pessoas ou canais para transmitir para um público ilimitado. O aplicativo também oferece suporte para chamadas de voz e videochamadas criptografadas, além de chats de voz em grupos com milhares de participantes. Com mais de 700 milhões de usuários ativos mensais, o Telegram é uma ferramenta versátil que combina elementos de SMS, e-mail e muito mais para atender às suas necessidades de comunicação pessoal ou comercial.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

  1. Projeto do tipo web/mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse a documentação Criar projeto;

  2. Possuir uma conta na plataforma Telegram.

Adicionar plugin

Siga os passos abaixo para instalar o Plugin Telegram Bot em seu projeto Cronapp.


Figura 1 - Instalando o plugin do Telegram Bot

  1. Acesse o botão do menu do sistema.
  2. Escolha a opção Plugin.
  3. Selecione Instalar Plugins
  4. Na janela de instalação dos plugins, pesquise por Telegram.
  5. Avance até finalizar a instalação.

Bloco de programação

Após instalar o plugin, será possível visualizar os blocos de programação do tipo Servidor, na categoria API do Telegram Bot.


Figura 2 - Blocos gerados a partir do plugin

Exemplo

O processo de criação de um bot no Telegram é bastante simples. Basta acessar sua conta no Telegram e solicitar o bot através do @BotFather. Esse é o bot oficial do Telegram, encarregado de criar e gerenciar os bots criados pelos usuários. Para mais informações, consulte a documentação do Telegram.

Com o chat habilitado com o BotFather, basta digitar:

  • /newbot: comando para criar um bot;
  • <Nome do bot>;
  • <Nome de usuário do bot>: o nome de usuário deve sempre terminar com o termo "bot".

Após isso, o BotFather fornecerá o token que usaremos mais tarde nos blocos de programação (destaque 1 da figura 3).


Atenção!

O token do bot é seu identificador único - armazene-o em um local seguro e compartilhe-o apenas com pessoas que precisam de acesso direto ao bot. Todos que tiverem seu token terão controle total sobre seu bot.

Figura 3 - Criando um bot e obtendo o token de acesso


A função a seguir utiliza três blocos da categoria API do Telegram Bot. O bloco Obter Atualizações obtém a lista com as últimas mensagens (em formato JSON) enviada por qualquer usuário do Telegram para o bot com o 'Bot Token' informado. Essa lista contém o atributo "message.from.id" que identifica o usuário que enviou a mensagem e o atributo "message.chat.id" que pode ser utilizado para identificar o grupo, esses atributos são necessários para que os demais blocos da categoria consigam encaminhar mensagens de retorno.

Com o retorno do bloco Obter Atualizações, percorremos o array utilizando o bloco para cada item na lista, com o objetivo de verificar se algum usuário digitou a palavra "Olá". Se isso for verdadeiro, o bot responderá com a mensagem especificada no parâmetro "Texto" do bloco Enviar mensagem, seguido de um sticker enviado através do bloco Enviar Sticker. Para esses blocos foi necessário informar também o 'Bot Token' e o ID do chat respectivamente.


Figura 3.1 - Função de resposta do bot


O resultado da execução da função pode ser conferido abaixo. Logo após a criação do bot, o BotFather disponibiliza o seu link de acesso (destaque 2 da figura 3). Para iniciar uma conversa, clique em "Start", este botão permanece visível somente enquanto não há mensagem no chat. Envie a mensagem "Olá" para o bot que acabou de criar.

Para simulamos a resposta do bot, rode a aplicação Cronapp com a função da figura 3.1 e execute a função. por exemplo, adicionando no evento de um botão em uma aplicação Cronapp. O bot irá procurar pela última mensagem "Olá" enviada e retornar uma resposta para o usuário que a envidou.


Figura 3.2 - Resultado da execução da função

Nesta página

  • Sem rótulos