Criar um assistente de IA no Telegram (voz + texto) com o n8n
· Por AI Compare
Um bot do Telegram que percebe voz e texto, se lembra do contexto e usa as suas ferramentas, criado no n8n.
O que vai criar
Um assistente pessoal de IA com quem fala no Telegram. Envie-lhe um texto ou uma mensagem de voz; ele transcreve a voz, percebe o pedido, usa ferramentas (calendário, email, contactos, pesquisa na web) e responde em texto ou áudio. Lembra-se da conversa recente, por isso as perguntas de seguimento funcionam.
Segue a estrutura do modelo da comunidade do n8n «Turn Telegram into an AI assistant with OpenAI voice, memory and tools».
O que precisa
- Uma instância do n8n com um URL HTTPS público (n8n Cloud, ou alojamento próprio com domínio). O Telegram tem de conseguir chegar ao seu webhook.
- Uma conta do Telegram.
- Uma chave de API da OpenAI (chat, transcrição e, opcionalmente, texto para voz). Para o chat pode usar outros fornecedores de modelos.
- Opcional: credenciais Google para as ferramentas de Calendar e Gmail.
Passo 1: criar o bot do Telegram
- No Telegram, abra o @BotFather e envie
/newbot. - Escolha um nome de apresentação e um nome de utilizador terminado em
bot(5–32 caracteres). - Copie o token que o BotFather lhe dá.
- No n8n, crie uma credencial Telegram e cole o token como Access Token.
Passo 2: a estrutura do workflow
| # | Nó | Função |
|---|---|---|
| 1 | Telegram Trigger (updates: message) | Recebe todas as mensagens enviadas ao bot |
| 2 | IF: verificação do remetente | Permitir apenas o seu próprio ID de utilizador do Telegram, para que estranhos não usem o seu assistente (nem o seu orçamento de API) |
| 3 | Switch: texto ou voz | Encaminha consoante exista ou não message.voice |
| 4 | Telegram: Get File (ramo de voz) | Descarrega a mensagem de voz como dados binários |
| 5 | OpenAI: Transcribe a recording | Transforma o áudio em texto |
| 6 | Edit Fields (Set) | Coloca o texto de qualquer um dos ramos num só campo, por exemplo prompt |
| 7 | AI Agent | Raciocina sobre o pedido e decide que ferramentas chamar |
| 8 | Modelo de chat + memória (sub-nós) | OpenAI Chat Model e Simple Memory com o ID do chat do Telegram como chave |
| 9 | Ferramentas (sub-nós) | Google Calendar, Gmail, pesquisa na web, calculadora |
| 10 | Telegram: Send Message | Responde no mesmo chat |
Passo 3: configurar o AI Agent
- Prompt: mapeie o campo unificado
promptdo passo 6. - Mensagem de sistema: descreva o papel do assistente, o seu fuso horário e as regras, por exemplo: «És o meu assistente pessoal. Hoje é {{ $now }}. Confirma antes de enviar emails.»
- Memória: use a Simple Memory com a chave de sessão
{{ $('Telegram Trigger').item.json.message.chat.id }}para que cada chat tenha o seu próprio histórico. - Ferramentas: adicione cada ferramenta como sub-nó e dê-lhe uma descrição clara, como «Criar eventos no calendário. Entrada: título, hora de início, hora de fim.»
Passo 4: responder por voz (opcional)
Adicione um nó da OpenAI Generate audio (texto para voz) depois do agente e envie o resultado com o Telegram Send Audio ou Send Voice. Mantenha a resposta em texto como predefinição; as respostas por voz custam mais e são mais lentas.
Dicas de segurança e custo
- Verifique sempre o ID de utilizador do remetente. Um bot público sem esta verificação pode ser usado por qualquer pessoa que o encontre.
- Peça ao agente que confirme antes de ações que enviem emails ou apaguem coisas.
- A transcrição de voz e as conversas longas gastam tokens. Limite a memória às últimas 10–20 mensagens.
n8n vs Zapier e Make neste caso de uso
Os triggers do Telegram existem nas três ferramentas, mas o AI Agent do n8n, com ferramentas e memória num só workflow, torna-o o sítio mais prático para criar um assistente a sério. No Zapier ou no Make precisaria de vários passos por ferramenta e de mais operações por mensagem. Veja Agentes de IA no Zapier, Make e n8n.
