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

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).

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 Chat Id (JSON Path: "message.from.id), necessário .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 encaminhem as mensagens para os usuários específicoconsigam 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