O plugin do Telegram bot adiciona blocos de programação do tipo servidor ao projeto que oferecem 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 o link 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 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 usuário, também um bot, @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 sobre o @BotFather.o 

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 o @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.

Image Modified

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

Figura 3.2 - Função de resposta do bot

O resultado da execução da função pode ser conferido abaixo.

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