Sim. O caminho mais simples é ligar um Telegram Trigger do n8n a uma planilha do Google Sheets e, depois, devolver uma resposta pelo próprio bot. Esse fluxo serve para registrar pedidos, dúvidas, leads ou chamados sem copiar mensagens manualmente.
Neste guia, você vai criar um bot no Telegram, guardar cada mensagem em uma linha da planilha e enviar uma confirmação automática. Não é preciso escrever código, mas será necessário configurar as credenciais e entender um detalhe importante: o token do bot funciona como uma senha.
O que você vai montar
O fluxo terá três partes:
- Telegram Trigger: recebe a mensagem enviada ao bot;
- Google Sheets: grava data, nome, chat ID e texto em uma nova linha;
- Telegram: envia uma confirmação para quem escreveu.
Na prática, isso pode virar uma caixa de entrada simples para uma clínica, um restaurante, uma imobiliária ou uma pequena empresa. A planilha não substitui um CRM, mas já resolve o primeiro problema: não perder a mensagem e dar retorno ao cliente.
Antes de começar
Separe:
- uma conta do Telegram;
- uma conta do n8n Cloud ou uma instalação própria do n8n;
- uma conta Google com acesso ao Sheets;
- uma planilha vazia com as colunas data, nome, chat_id e mensagem.
O Telegram chama o código de acesso do bot de token. A documentação oficial explica que ele é exclusivo de cada bot e é usado nas requisições HTTPS da Bot API. Portanto, não publique esse valor em tutorial, print, repositório ou variável exposta.
1. Crie o bot pelo BotFather
- Abra o Telegram e procure por @BotFather, o bot oficial de gerenciamento.
- Envie o comando
/newbot. - Informe o nome que aparecerá para as pessoas.
- Escolha um username terminado em
bot, comoatendimento_jsms_bot. - Copie o token enviado pelo BotFather e guarde-o em local seguro.
O bot ainda não conversa sozinho. Para testar uma conversa privada, abra o link do username, toque em Iniciar e envie uma mensagem. De acordo com a documentação do Telegram, bots não iniciam conversas com usuários: a pessoa precisa mandar a primeira mensagem ou adicionar o bot a um grupo.
2. Cadastre a credencial do Telegram no n8n
No n8n, crie um workflow novo e adicione o nó Telegram Trigger. Na área de credenciais, crie uma credencial do Telegram e cole o token recebido do BotFather. Salve e selecione o evento de novas mensagens, normalmente identificado como On Message.
O n8n mantém nós próprios para integrar o Telegram a outros serviços. Além de receber mensagens, o nó do Telegram pode enviar texto, fotos, arquivos e executar operações de chat. Para este primeiro fluxo, você só precisa do gatilho e da operação de envio de mensagem.
3. Ligue o gatilho ao Google Sheets
Adicione o nó Google Sheets depois do Telegram Trigger. Crie ou selecione uma credencial do Google, escolha a planilha e a aba onde os dados serão armazenados. Na operação da aba, selecione Append Row, que cria uma nova linha a cada execução.
Mapeie as colunas da planilha usando os dados que chegam do Telegram. Os nomes podem variar de acordo com a versão do n8n, mas um mapeamento inicial fica assim:
| Coluna | Expressão sugerida | Para que serve |
|---|---|---|
| data | {{ $now }} |
Registrar quando a mensagem chegou |
| nome | {{ $('Telegram Trigger').item.json.message.from.first_name || '' }} |
Identificar o remetente |
| chat_id | {{ $('Telegram Trigger').item.json.message.chat.id }} |
Responder ao chat correto |
| mensagem | {{ $('Telegram Trigger').item.json.message.text || '' }} |
Guardar o conteúdo recebido |
Se o gatilho estiver com outro nome, substitua Telegram Trigger pelo nome exibido no seu workflow. Use o painel de dados do n8n para confirmar o caminho exato antes de ativar a automação. Mensagens com foto ou arquivo podem não ter message.text; nesse caso, crie uma regra separada ou grave também o tipo do conteúdo.
4. Envie uma resposta automática
Depois do Google Sheets, adicione um nó Telegram. Escolha a operação Send Message. No campo Chat ID, use o ID vindo do Telegram Trigger, e não um número digitado manualmente. Uma expressão compatível com as versões atuais do n8n é:
{{ $('Telegram Trigger').item.json.message.chat.id }}No campo de texto, use uma resposta curta, por exemplo:
Recebi sua mensagem e registrei o atendimento. Em breve retornaremos.Se quiser personalizar o texto, você pode inserir o primeiro nome com a mesma expressão usada na planilha. Para um atendimento real, evite prometer prazo que a equipe não consegue cumprir: automação responde rápido, mas não resolve sozinha o problema do cliente.
5. Teste e ative o workflow
- Salve o workflow.
- Execute o Telegram Trigger em modo de teste, quando essa opção estiver disponível.
- Abra o bot no Telegram e envie uma mensagem simples, como
Olá. - Confirme no n8n se o gatilho recebeu o evento.
- Verifique se uma nova linha apareceu no Google Sheets.
- Confira se a resposta chegou ao mesmo chat.
- Ative o workflow somente depois de validar as três etapas.
Depois de ativado, o fluxo dependerá da infraestrutura do seu n8n. Em uma instalação própria, a URL de webhook precisa estar publicada de forma acessível e configurada corretamente para que o Telegram consiga entregar os eventos. Também vale acompanhar as execuções com erro, principalmente nas primeiras horas.
Erros comuns e como corrigir
O bot não responde
Verifique se a pessoa abriu o bot e enviou a primeira mensagem, se o workflow está ativo e se o token foi colado sem espaços. Se o n8n for self-hosted, confira domínio, HTTPS e a URL pública usada pelos webhooks.
A planilha recebe uma linha vazia
Abra a saída do Telegram Trigger e confira se a mensagem é texto. Fotos, áudios e documentos usam outros campos da atualização. Para aceitar esses formatos, adicione uma condição que identifique o tipo recebido antes de tentar salvar message.text.
O bot não lê mensagens de um grupo
O Telegram usa o modo de privacidade em grupos. Com ele ativado, o bot recebe comandos dirigidos a ele, respostas e alguns eventos, mas não necessariamente todo texto enviado no grupo. Se o bot precisar acompanhar todas as mensagens, avalie a configuração de privacidade no BotFather e explique aos participantes o que será coletado.
O envio falha por causa do Chat ID
Não confunda username com Chat ID. Em conversas privadas, o valor deve vir do evento recebido. Para grupos, o n8n recomenda obter o ID pelo Telegram Trigger; grupos também costumam usar um identificador numérico com sinal de menos.
Limites importantes antes de usar em produção
Esse fluxo é ótimo para uma triagem inicial, mas não deve ser tratado como sistema completo de atendimento. Uma planilha pode ficar confusa com muitas mensagens, não oferece controle de permissões tão refinado quanto um sistema de chamados e pode expor dados pessoais se o compartilhamento estiver aberto.
O Telegram também aplica limites de envio. A documentação do n8n registra a referência de até 30 mensagens por segundo na API, portanto não use este modelo para disparos em massa sem controlar lotes, intervalos e consentimento. Para atendimento, prefira uma mensagem por evento e registre quem tem autorização para acessar a planilha.
Se a sua necessidade for apenas alertar uma equipe, este guia pode ser reduzido a um caminho de saída. O JSMS já mostrou como criar alertas no Telegram com n8n; aqui, a diferença é que o bot também recebe o contato do usuário e cria um histórico no Sheets.
Perguntas frequentes
Precisa saber programar para criar esse bot?
Não. O fluxo básico usa nós visuais do n8n, mas você precisa configurar credenciais, expressões e permissões corretamente.
O bot pode iniciar uma conversa com qualquer usuário?
Não. A pessoa precisa enviar a primeira mensagem ou adicionar o bot a um grupo antes que ele possa responder.
O token do Telegram pode ficar no workflow?
Sim, na credencial protegida do n8n; não o publique em código, capturas de tela ou mensagens. Se ele vazar, gere outro token pelo BotFather.