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.
Projeto do tipo web/mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link a documentação Criar projeto;
- 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
- Acesse o botão do menu do sistema.
- Escolha a opção Plugin.
- Selecione Instalar Plugins
- Na janela de instalação dos plugins, pesquise por Telegram.
- Avance até finalizar a instalação.
Bloco de programação
Após instalar o plugin, será possível visualizar nos 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.
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).
| Nota | ||
|---|---|---|
| ||
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. |
| Âncora | ||||
|---|---|---|---|---|
|
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.
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 '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 é 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 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.2 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
| Índice |
|---|