n8n-telegram-custom-json

Este é um nó personalizado do Telegram para n8n com suporte aprimorado a JSON customizado e funcionalidades avançadas.

O Telegram é uma plataforma de mensageria baseada em nuvem que permite comunicação através de mensagens, mídia e bots automatizados.

n8n é uma plataforma de automação de workflow com licença fair-code.

Instalação

Siga o guia de instalação na documentação de nós da comunidade n8n.

npm install n8n-telegram-custom-json

Operações Suportadas

Telegram Node

• Callback: Responder a consultas de callback
• Chat: Gerenciar chats (obter informações, sair, obter membros, administradores)
• File: Obter arquivos do Telegram
• Message: Gerenciar mensagens
  • Enviar mensagens de texto
  • Enviar fotos, vídeos, animações
  • Enviar documentos e áudios
  • Enviar localizações e stickers
  • Enviar grupos de mídia
  • Editar mensagens
  • Deletar mensagens
  • Fixar mensagens no chat
  • Enviar ações de chat (digitando, enviando foto, etc.)
  • Enviar e Aguardar: Funcionalidade exclusiva para enviar mensagem e aguardar resposta

Telegram Trigger Node

• Receber mensagens em tempo real
• Webhooks para atualizações do bot
• Processamento automático de comandos

Credenciais

Para usar este nó, você precisa:

1. Criar um bot no Telegram:

   • Abra o Telegram e procure por @BotFather
   • Digite /newbot e siga as instruções
   • Copie o token do bot fornecido

2. Configurar as credenciais no n8n:

   • Access Token: O token do bot fornecido pelo BotFather
   • Base URL: https://api.telegram.org (padrão)

Funcionalidades Especiais

JSON Customizado

Este nó oferece suporte aprimorado para manipulação de dados JSON, permitindo:

• Formatação personalizada de mensagens
• Processamento avançado de respostas
• Integração com APIs externas

Send and Wait

Uma funcionalidade exclusiva que permite:

• Enviar uma mensagem para um usuário
• Aguardar pela resposta
• Continuar o workflow com base na resposta recebida
• Timeout configurável
• Suporte a respostas em diferentes formatos

Compatibilidade

• Versão mínima do n8n: 0.180.0
• Testado com: n8n v1.0.0+
• Node.js: v16.0.0+

Exemplos de Uso

Envio Simples de Mensagem

{
  "chatId": "123456789",
  "text": "Olá! Esta é uma mensagem do n8n."
}

Envio com Aguardo de Resposta

{
  "chatId": "123456789",
  "text": "Por favor, confirme sua escolha:",
  "waitForResponse": true,
  "timeout": 300
}

Envio de Mídia

{
  "chatId": "123456789",
  "photo": "https://example.com/image.jpg",
  "caption": "Aqui está a imagem solicitada"
}

Recursos

• Documentação da API do Telegram Bot
• Documentação de nós da comunidade n8n
• Como criar um bot no Telegram

Suporte

Para relatar bugs ou solicitar funcionalidades:

• Abra uma issue no repositório GitHub
• Entre em contato: [email protected]

Contribuições

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua funcionalidade
3. Commit suas mudanças
4. Abra um Pull Request

Licença

MIT

Autor

@i.zackz ([email protected])