Enviando Notificação no Telegram via Alteryx

[Ranyaky-Vilela]

Contexto

Normalmente as corporações costumam executar vários fluxos diariamente de diversas áreas de negócios. Normalmente a área de Dados fica responsável por gerar esses fluxos e disponibilizar para os colaboradores, porém algumas corporações não possuem o Alteryx Server para poder facilitar este compartilhamento de informações e acaba sendo feito manualmente.

Rapidamente pensamos em uma solução, onde podemos configurar no fluxo que seja disparado um e-mail avisando os colaboradores que o resultado está pronto e disponível em algum local.

Refletindo mais afundo se esta seria a melhor opção de notificar uma pessoa percebo que, recebemos vários e-mails diariamente alguns importantes outros nem tanto, e seria muito fácil passar despercebido este e-mail.

Então como notificar o usuário que seu fluxo está pronto e disponibilizado?

Cenário:

Sempre estamos com celular por perto e qualquer notificação que chega já visualizamos muito mais rápido, então a ideia foi utilizar um dos mensageiros mais comuns que temos. E a escolha do Telegram se deu a sua API ser gratuita (https://core.telegram.org/api) e sua facilidade de criar Bots (https://core.telegram.org/bots).

Solução:

Vamos criar um Bot para compartilhar mensagens do Alteryx utilizando a API do Telegram.

Você pode enviar uma mensagem para uma ou mais pessoas, criar um grupo e notificar por lá, ou conectar a um fluxo de trabalho para que assim que executar ele seja disparado a notificação. Você pode também obter as últimas interações com o Bot utilizando “Get Bot Updates” e configurar o mesmo para remover usuários de canais que você inseriu seu Bot como Administrador, basta utilizar os parâmetros necessários.

Isso tudo você pode fazer sem a necessidade de um Servidor.

Parte 1:

Criar um  Bot através de outro Bot. O BotFather.

Procure por “BotFather” no Telegram e inicie uma conversa com ele. Um simples “Olá” e ele irá responder com todos os comandos que você precisa.

Digite “/newbot” e ele irá informar o que você precisa fazer, primeiro você escolhe o nome do Bot e depois defini um identificador único por regra o Telegram informa que é necessário terminar com “bot”.

Depois disso você recebe seu token da API para poder autenticar. Exemplo de Token: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

Parte 2:

Após criar o seu bot você procura por ele utilizando o identificar único, uma dica é você usar um “@” na pesquisa para facilitar.

Após clicar em “START” ele irá habilitar a interação. O Bot nunca vai interagir com os usuários primeiro sem que a pessoa interaja com ele com um simples “Olá” mesmo, a não ser que você já tenha coletado o ID dos usuários de outra forma, seja via web ou eles utilizando o Bot Raw e mandando para você.

Como não é nosso caso, os usuários vão pesquisar pelo Bot e mandar uma mensagem dessa forma o Bot já identifica o ID para que depois você guarde-os para  e configure no workfflow para enviar as mensagens ou remover os usuários de algum grupo por exemplo, este ID é único para cada contato, lembrando que você pode adicionar ele em canais de grupos para não ser necessários enviar uma única mensagem para várias pessoas, isso vai depender da sua necessidade e de como você deseja aplicar.

Passo 3:

Após as interações das pessoas você pode utilizar a opção “Get Bot Updates” para obter o ID dos usuários. Além de que você pode ver todas as interações que aconteceram com seu Bot.

Implementação:

Criei uma macro que faça a interação com essa API, você vai encontrar no final deste post.

Você pode usar a macro para enviar uma única mensagem:

Agora caso deseja enviar para várias pessoas ou um grupo, você pode ativar a opção de conexão de entrada e selecionar as entradas especificas.

Os parâmetros da API que o Telegram usa para identificar os usuários é “chat_id” e da mensagem é o “text”. Podemos ver também que existe um para o Bot Token caso você tenha criado outros canais e colocado o Bot ele pode enviar para mais de um grupo.

Dica:

Quando você for encaminhar notificação utilizando as entradas especificas, lembre-se de colocar “0” ou valor randômico no Chat ID, conforme imagem acima, para que não mostre a mensagem de erro para você. O fluxo será executado a notificação chegará com sucesso, mas no seu workflow vai aparecer erro.

Você também pode adicionar emojis a sua mensagem: https://getemoji.com  

Você simplesmente cópia e cola em sua mensagem.

Adicional:

Caso você tenha criado um grupo e colocado seu Bot para realizar esses procedimentos você pode utilizá-lo para que remova usuários deste grupo.

Quando você cria um grupo e adiciona as pessoas e/ou seu bot como membros, é criado um código único para este grupo, e o parâmetro para ele é o chat_id. Mas daí você está pensando como eu vou configurar e usar o id da pessoa sendo que o chat_id é do grupo?

A partir do momento que você adiciona um usuário em algum grupo o código dessa pessoa para você identificar neste grupo agora é user_id.

Então os parâmetros obrigatórios são user_id e chat_id. Como mencionamos user_id vai ser o usuário e chat_id vai ser o grupo.

Neste caso eu coloquei o texto como opcional, caso você remover o usuário do grupo e quiser enviar uma mensagem no grupo.

Bom é isso aí pessoal. Qualquer dúvida, pergunta ou como implementá-lo fique à vontade para me procurar.

Abraço

Ranyaky Vilela

TelegramConnector_Comunidade.yxmc