---
title: Telegram
slug: aura/telegram
docTags: 
createdAt: 2025-07-07T20:39:55.891Z
---

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](https://telegram.me/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.

1. Abra o aplicativo Telegram e inicie uma conversa com o [BotFather](https://telegram.me/BotFather).
2. Digite o comando `/newbot` e pressione enter.

:::BlockQuote
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`.
:::

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

![inicio](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/B98LEACrAf9Y04-XM41wj_botfatherinicio.png)

1. Entre no chat com seu bot, que pode ser acessado no link `t.me/<nome_do_bot>`, e pressione o botão "start".
2. 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.

   ```json
   {
       chat: {
           id:7288249035,
           first_name: "Nome",
           last_name:"Sobrenome",
           type:"private"
       }
   }
   ```
3. 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:

   :::BlockQuote
   É possível gerar chaves aleatórias com os seguintes comandos:
   :::

   ### Windows.

   ### Powershell

   ```powershell
       $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
       $key = -join ((1..256) | ForEach-Object { $chars[(Get-Random -Maximum $chars.Length)] })
       Write-Output $key
   ```

   ### Linux.

   ```bash
   < /dev/urandom tr -dc 'A-Za-z0-9' | head -c 256
   ```

   ### Mac

   ```bash
       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.

:::BlockQuote
**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.

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

```