Criando uma Credencial do Telegram no n8n

Este tutorial irá guiá-lo no processo de criação de um bot do Telegram e na configuração de uma credencial no n8n para interagir com o Telegram usando o nó Telegram Trigger do n8n.

Pré-requisitos

Uma conta no n8n (versão auto-hospedada ou em nuvem).
Uma conta no Telegram (aplicativo desktop ou móvel).

Passo 1: Crie um Novo Workflow no n8n

Faça login na sua instância do n8n.
Crie um Novo Workflow:

Clique no botão “Create” ou navegue até “Workflows” e clique em “New Workflow“.

Passo 2: Adicione o Nó Telegram Trigger

Adicione um Nó:

No editor de workflows, clique no botão cinza “+” (Adicionar Nó) no meio do canvas.

Procure por Telegram:

No painel “Nodes” que aparece, digite “Telegram” na barra de busca.

Selecione Telegram Trigger:

Na lista de nós, clique em “Telegram“.
Escolha o nó “Telegram Trigger” das opções disponíveis.

Selecione o Evento:

Nas configurações do nó, configure o campo “Event” para “On Message“.

Passo 3: Configure a Credencial do Telegram no n8n

Crie uma Nova Credencial:

Nas configurações do nó “Telegram Trigger“, encontre o campo “Credentials“.
Clique no menu suspenso e selecione “Create New” (ou “Create new credential“).

Campo Access Token:

Uma nova janela ou painel aparecerá solicitando o “Access Token“.

Passo 4: Crie um Novo Bot do Telegram e Obtenha o Access Token

Para interagir com a API do Telegram, você precisa criar um novo bot e obter o token de acesso do bot.

Passo 4.1: Abra o Telegram e Inicie um Chat com o BotFather

Abra o Telegram:

Inicie o aplicativo do Telegram no seu computador ou dispositivo móvel.

Inicie um Chat com o BotFather:

Na barra de busca no topo, digite “@BotFather” e selecione a conta verificada do BotFather.

Inicie o Chat com o BotFather:

Se for a primeira vez que você interage com o BotFather, clique em “Start” ou digite /start e envie a mensagem.

Passo 4.2: Crie um Novo Bot

Envie o Comando para Criar um Novo Bot:

Digite /newbot e envie a mensagem.

Dê um Nome ao Seu Bot:

O BotFather perguntará: “Alright, a new bot. How are we going to call it? Please choose a name for your bot.” (Certo, um novo bot. Como vamos chamá-lo? Por favor, escolha um nome para o seu bot.)
Insira um nome para o seu bot (pode ser qualquer nome, por exemplo, Meu Bot n8n).

Defina um Nome de Usuário para o Seu Bot:

Após enviar o nome, o BotFather dirá: “Now let’s choose a username for your bot. It must end with bot. Like this, for example: TetrisBot or tetris_bot.” (Agora vamos escolher um nome de usuário para o seu bot. Ele deve terminar com bot. Como estes exemplos: TetrisBot ou tetris_bot.)
Insira um nome de usuário único para o seu bot. Lembre-se:
- O nome de usuário deve ser único em todo o Telegram.
- Deve terminar com bot.
- Exemplos: meu_n8n_bot, supermemoriabot.
Nota: Se o nome de usuário já estiver em uso, o BotFather solicitará que você tente outro.

O BotFather Fornece o Access Token:

Uma vez que você tenha nomeado com sucesso o seu bot e fornecido um nome de usuário único, o BotFather confirmará: Done! Congratulations on your new bot. You will find it at t.me/seu_nome_de_usuario_bot. You can now add a description, about section, and profile picture for your bot. Use this token to access the HTTP API: <Seu_Access_Token> Keep your token secure and store it safely; it can be used by anyone to control your bot.
Copie o Access Token.

Passo 5: Cole o Access Token no n8n

Retorne ao n8n:

Volte para o workflow do n8n onde você parou.

Cole o Access Token:

No campo “Access Token” da configuração da credencial, cole o token de acesso que você copiou do BotFather.

Salve a Credencial:

Clique em “Save” para armazenar a credencial no n8n.

Confirmação:

O n8n deve confirmar que a conexão foi bem-sucedida.
Feche a janela de credenciais para retornar ao editor de workflows.

Passo 6: Teste o Nó Telegram Trigger

Comece a Escutar (Opcional):

No nó Telegram Trigger, você pode precisar ativar o workflow ou começar a escutar eventos, dependendo da sua configuração do n8n.

Envie uma Mensagem para o Seu Bot:

No Telegram, navegue até o seu novo bot:
- Clique no link fornecido pelo BotFather (por exemplo, t.me/seu_nome_de_usuario_bot), ou
- Procure pelo nome de usuário do seu bot no Telegram.
Inicie uma conversa com o seu bot clicando em “Start” ou enviando qualquer mensagem.

Verifique o n8n:

No n8n, você deve ver que o nó Telegram Trigger responde à mensagem que você enviou.
Agora você pode usar este trigger para desenvolver o seu workflow.

Dicas Adicionais

Protegendo o Seu Access Token:
Nunca compartilhe o token de acesso do seu bot publicamente. Trate-o como uma senha.
Se você acredita que o seu token foi comprometido, você pode regenerá-lo enviando /revoke para o BotFather e selecionando o seu bot.
Personalizando o Seu Bot:
Você pode definir uma foto de perfil, descrição e texto “sobre” para o seu bot usando comandos como /setuserpic, /setdescription e /setabouttext no BotFather.
Adicionando Funcionalidades:
A partir daqui, você pode usar vários nós do Telegram no n8n para enviar mensagens, responder aos usuários e construir workflows complexos integrando o Telegram com outros serviços.

Resolução de Problemas

Erro de Access Token Inválido:
Certifique-se de que você copiou todo o token de acesso sem espaços ou caracteres extras.
Bot Não Responde:
Certifique-se de que o seu bot foi iniciado enviando uma mensagem para ele no Telegram.
Verifique se o seu workflow no n8n está ativo e se o nó Telegram Trigger está configurado corretamente.
Problemas com o Nome de Usuário:
Lembre-se de que os nomes de usuário dos bots devem ser únicos e terminar com bot.
Se você estiver tendo dificuldade em encontrar um nome de usuário disponível, tente adicionar números ou underscores.

Resumo

Você criou com sucesso um bot do Telegram e configurou uma credencial no n8n para interagir com o Telegram. Agora você pode usar o nó Telegram Trigger para responder a mensagens e construir workflows automatizados que se integram com o Telegram.

Sinta-se à vontade para continuar desenvolvendo o seu workflow adicionando mais nós e lógica para lidar com mensagens do seu bot do Telegram. Se você tiver alguma dúvida ou precisar de mais assistência, não hesite em perguntar!

Pesquisa, Edição, formatação e finalização:
Werney A. Lima, segunda-feira, 3 de fevereiro de 2025 – 15:24 (segunda-feira)