O plugin do Telegram bot Bot adiciona blocos de programação do tipo servidor ao projeto que oferecem possibilitam uma série de funcionalidades poderosas, 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

Utilizaremos agora o bot @userinfobot para obter o id do usuário, ele é necessário para informar ao bot para qual usuário encaminhar as mensagens. Confira na figura abaixo.

Figura 3.1 - Obtendo o identificador do usuário através do bot userinfobot

A função a seguir utiliza três blocos da categoria API do Telegram Bot. Em dois deles, Enviar mensagem e Enviar Sticker, precisamos passar o token e o ID do chat respectivamente, os quais foram obtidos nos passos anteriores. 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 ID 'Bot Token' informado. Essa lista contém o atributo Chat Id, necessário para que os demais blocos da categoria encaminhem as mensagens para os usuários específico. Para simplificar esse exemplo, estamos informando o Chat id de forma estática, mas em uma situação real, seria necessário obter o ID do chat a partir da lista obtida.

Com o retorno do bloco Obter Atualizações, percorremos o array utilizando o é responsável por buscar as mensagens que o usuário enviou para o bot e tem como parâmetro obrigatório somente o token do bot. Seu retorno é um array de objetos JSON. Percorremos esse array utilizando um bloco para cada item na lista, com o objetivo de verificar se o 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  ID 'Bot Token' e o ID do chat respectivamente.

Figura 3.2 - 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. Em seguida, enviamos a mensagem "Olá" e simulamos a resposta do bot através do clique em um botão em uma view do Cronapp que recebe executando de forma manual a função da figura 3.2 no evento Ao Clicar. 

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