Como configurar o Telegram na Unit Platform

Para usar a integração da Unit Platform com o Telegram é necessária a criação de um bot (robô) que será responsável pelo envio das mensagens e um grupo de usuários para recebê-las.

Como criar um token no Telegram?

Ao criar um bot, o Telegram fornecerá um token. Para gerar esse token, siga as instruções abaixo:

1) Faça login na sua conta do Telegram no endereço https://web.telegram.org/.
Observação: cada empresa deve possuir o seu próprio bot, para fins de privacidade.

2) No campo de pesquisa do Telegram, procure por @BotFather. O BotFather é o assistente do Telegram para criação de bots, clique nele para iniciar uma conversa.

Procure pelo BotFather

3) Ao iniciar uma conversa com o BotFather, a tela abaixo será exibida. Clique em START.

Inicie uma conversa com o BotFather

4) Digite no campo de mensagem o comando /newbot.

5) A seguir, o Telegram irá solicitar que seja informado um nome para exibição e um nome de usuário para o bot.
A imagem abaixo traz um exemplo da conversa para a criação de um bot. O nome escolhido no exemplo foi “MyCompanyTelegram” e o username “MyCompanyTelegramBot”. Observe que o nome de usuário deve obrigatoriamente ter o sufixo “bot”.

Criação do bot

Como criar um grupo de usuários no Telegram?

A Unit Platform envia mensagens apenas para grupos de contatos. Para criar um grupo, siga as instruções abaixo.
Observação: caso deseje enviar as mensagens para um grupo já existente, apenas siga os passos 4-6.

1) Abra o menu do Telegram e clique em New Group.

Novo grupo

2) Selecione os usuários que farão parte do grupo e clique em NEXT.

3) Informe um nome para o grupo e clique em CREATE GROUP.

Criação do grupo

4) Acesse as propriedades do grupo e adicione o bot criado anteriormente clicando em Add member. Este passo é importante, pois o bot não conseguirá enviar as mensagens se ele não for um membro do grupo.

Adicione o bot no grupo

Adicione o bot no grupo

5) Envie uma mensagem para o bot para confirmar que ele faz parte do grupo.

Confirme a adição do bot no grupo

Configuração do Telegram na Unit Platform

Primeiramente, navegue até a página de configuração do Telegram em Opções > Configurações de notificação > Configurações do Telegram.

No Passo 1 – Telegram Tokens, clique no botão “Adicionar”, informe o token criado anteriormente e clique em Salvar:

Cadastro do token

Nessa mesma página, no Passo 2 – Grupos do Telegram, clique em “Adicionar”.

Na popup que abrirá a seguir, a Unit tentará autodetectar através do token os grupos nos quais o bot foi inserido. Em caso de sucesso será exibida uma lista de grupos para escolha.

A Unit Platform tenta detectar o ID do grupo através do uso do  /getUpdates da API do Telegram. Nem sempre esse webservice retornará o ID do grupo e nesses casos o ID terá que ser informado manualmente.

Cadastro do grupo

Para descobrir o ID do grupo, vá na interface do Telegram, clique no grupo recém criado na lista de conversas. Na URL do grupo será informado o ID:

ID do grupo no Telegram

Este ID deve ser informado no campo “ID do grupo” juntamente com um nome qualquer, que não necessariamente precisa ser igual ao que está cadastrado no Telegram.

Nessa mesma popup é possível testar a configuração do grupo. Ao clicar em Testar a Unit enviará uma mensagem para o grupo em questão e no Telegram poderá ser visualizada uma mensagem como essa:

Teste da configuração do Telegram

Após terminados esses passos, deve-se ativar o envio de notificações pelo Telegram no Multisite Monitoring. Para isso, veja este post.