Telegram

A especificação a seguir atua como um guia detalhado para utilização do broker Telegram, fornecendo todas as instruções e orientações necessárias para sua configuração.

Configuração

Para realizar o cadastro do broker, é imprescindível fornecer o token do bot e o identificador do chat. Todos esses dados podem ser facilmente encontrados após a criação do bot no BotFather.

O que é o BotFather?

O BotFather é o bot oficial do Telegram usado para gerenciar e criar novos bots. Com ele, você pode registrar um novo bot, definir o nome, a descrição, o avatar e até gerenciar as permissões do seu bot.

Criar um Bot

Siga os passos abaixo para criar um bot no Telegram e integrá-lo à plataforma low-code.

Abra o aplicativo Telegram e inicie uma conversa com o BotFather.
Digite o comando /newbot e pressione enter.

O BotFather irá pedir que você escolha um nome para o bot. Esse será o nome que aparecerá nos chats. O nome deve terminar com a palavra bot. Por exemplo: Meubot.

Após escolher o nome, o BotFather irá fornecer um token, que será utilizado para o cadastro dentro da plataforma low-code.

Entre no chat com seu bot, que pode ser acessado no link t.me/<nome_do_bot>, e pressione o botão "start".
Em seguida, acesse a URL
https://api.telegram.org/bot<token_do_bot>/getUpdates, e um JSON será retornado. Nele, procure a seção abaixo e copie o identificador (id) do chat para utilizá-lo dentro do low-code.
{ chat: { id:7288249035, first_name: "Nome", last_name:"Sobrenome", type:"private" } }
Para garantir a segurança da comunicação, você precisa criar um segredo que será usado para validar as mensagens entre o bot e a plataforma. Esse segredo pode ser qualquer texto com 1 a 256 caracteres, mas recomenda-se utilizar uma chave aleatória gerada com os comandos abaixo:
É possível gerar chaves aleatórias com os seguintes comandos:
Windows.
Powershell
$chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789' $key = -join ((1..256) | ForEach-Object { $chars[(Get-Random -Maximum $chars.Length)] }) Write-Output $key
Linux.
< /dev/urandom tr -dc 'A-Za-z0-9' | head -c 256
Mac
LC_ALL=C < /dev/urandom tr -dc 'A-Za-z0-9' | head -c 256
Todos devem gerar uma chave similar a essa:
FJHv5Us4MllS6EKK6O3PQEs3TzLJUQURjPp5LoDklIAs3GCZTkUiYMPINkPIreUX7cEhW6zd15y...

Configuração

Normalmente, a configuração é feita automaticamente pelo próprio plugin, mas, em alguns casos, pode falhar. Use esta seção caso o bot não responda após a primeira interação.

ATENÇÃO: Basta copiar e colar as URLs a seguir na barra de pesquisa de qualquer navegador para acionar a API do Telegram.

Após configurar o seu bot, é necessário configurar o webhook. Você pode fazer isso utilizando a seguinte URL:

https://api.telegram.org/bot<TOKEN_DO_BOT>/setWebhook?url=https://{seu-dominio}/{lunaris_embiente}/post/telegram/webhook

Se tudo ocorrer corretamente, a mensagem a seguir será exibida, confirmando que o webhook foi configurado.

{
    "ok":true,
    "result":true,
    "description":"Webhook was set"
}

Configuração

O que é o BotFather?

Criar um Bot

Windows.

Powershell

Linux.

Mac

Configuração