n8n-nodes-teamsix-translator

Nó customizado do n8n para traduzir textos sem necessidade de API key! 🌍

📦 Instalação

Opção 1: Instalar via npm (Community Node)

1. Abra sua instância do n8n
2. Vá em Settings → Community Nodes
3. Clique em Install a community node
4. Digite: n8n-nodes-teamsix-translator
5. Clique em Install

Opção 2: Instalação Manual (Auto-hospedado)

Se você está executando n8n com npm:

npm install n8n-nodes-teamsix-translator

Se você está executando n8n com Docker:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_CUSTOM_EXTENSIONS="/home/node/custom" \
  -v ~/.n8n:/home/node/.n8n \
  -v $(pwd)/n8n-nodes-teamsix-translator:/home/node/custom/n8n-nodes-teamsix-translator \
  n8nio/n8n

Opção 3: Desenvolvimento Local

1. Clone este repositório
2. Instale as dependências:

cd n8n-nodes-teamsix-translator
npm install

3. Compile o projeto:

npm run build

4. Vincule o nó localmente:

npm link

5. No diretório do n8n:

npm link n8n-nodes-teamsix-translator

🚀 Como Usar no n8n

Uso Básico

1. Adicione o nó Tradutor ao seu workflow
2. Configure os parâmetros:
   • Texto: O texto que você deseja traduzir
   • Idioma de Origem: Deixe em "Detecção Automática" ou selecione um idioma específico
   • Idioma de Destino: Selecione o idioma para o qual deseja traduzir

Exemplo de Workflow Simples

Trigger → Tradutor → ...

Configuração:

• Texto: Hello, how are you?
• Idioma de Origem: Detecção Automática
• Idioma de Destino: Português

Saída:

{
  "traducao": "Olá, como você está?",
  "idiomaOrigem": "auto",
  "idiomaDestino": "pt"
}

Opções Avançadas

1. Nome do Campo de Saída

Personalize o nome do campo onde a tradução será salva:

{
  "minhaTraducao": "Olá, como você está?"
}

2. Incluir Idioma Detectado

Mostra qual idioma foi detectado automaticamente:

{
  "traducao": "Olá, como você está?",
  "idiomaDetectado": "en",
  "idiomaOrigem": "auto",
  "idiomaDestino": "pt"
}

3. Incluir Texto Original

Mantém o texto original na saída:

{
  "traducao": "Olá, como você está?",
  "textoOriginal": "Hello, how are you?",
  "idiomaOrigem": "auto",
  "idiomaDestino": "pt"
}

🌍 Idiomas Suportados

O nó suporta mais de 100 idiomas, incluindo:

Código	Idioma	Código	Idioma
pt	Português	en	Inglês
es	Espanhol	fr	Francês
de	Alemão	it	Italiano
ja	Japonês	ko	Coreano
zh-CN	Chinês Simplificado	zh-TW	Chinês Tradicional
ru	Russo	ar	Árabe
hi	Hindi	nl	Holandês
pl	Polonês	tr	Turco
sv	Sueco	no	Norueguês
da	Dinamarquês	fi	Finlandês
el	Grego	he	Hebraico
th	Tailandês	vi	Vietnamita
id	Indonésio	ms	Malaio

📝 Exemplos de Uso

Exemplo 1: Traduzir Respostas de API

HTTP Request → Tradutor → Send Email

Traduza automaticamente respostas de APIs antes de processar.

Exemplo 2: Traduzir Mensagens de Chat

Webhook (Slack/Discord) → Tradutor → Resposta Traduzida

Crie um bot multilíngue que traduz mensagens automaticamente.

Exemplo 3: Processar Múltiplos Itens

Google Sheets → Split In Batches → Tradutor → Update Sheet

Traduza várias células de uma planilha em lote.

Exemplo 4: Detecção de Idioma

Webhook → Tradutor (auto) → Switch (por idioma detectado)

Use a detecção automática para rotear workflows baseado no idioma.

⚙️ Configurações de Expressão

Você pode usar expressões do n8n nos campos:

// Traduzir valor de outro nó
{{ $json.textoOriginal }}

// Concatenar múltiplos campos
{{ $json.titulo + ' - ' + $json.descricao }}

// Idioma dinâmico baseado em outro campo
{{ $json.idioma }}

🔧 Como Funciona

Este nó utiliza a API pública do Google Translate (endpoint não-oficial) que não requer autenticação nem API key. É perfeito para:

✅ Automações pessoais
✅ Pequenos projetos
✅ Prototipagem
✅ Workflows de teste

⚠️ Limitações

• Este nó usa um endpoint não-oficial do Google Translate
• Para projetos comerciais de grande escala, considere usar a API oficial
• Taxa de requisições pode ser limitada pelo Google
• Requer conexão com a internet

🛠️ Desenvolvimento

Estrutura do Projeto

n8n-nodes-teamsix-translator/
├── nodes/
│   └── Tradutor/
│       ├── Tradutor.node.ts    # Código principal do nó
│       └── tradutor.svg        # Ícone do nó
├── package.json                # Configuração do pacote
├── tsconfig.json              # Configuração TypeScript
├── gulpfile.js                # Build dos ícones
└── README.md                  # Documentação

Comandos de Desenvolvimento

# Instalar dependências
npm install

# Compilar em modo watch
npm run dev

# Build completo
npm run build

# Lint do código
npm run lint

# Formatar código
npm run format

🤝 Contribuindo

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

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

📄 Licença

MIT - Livre para uso pessoal e comercial

🐛 Reportar Bugs

Encontrou um bug? Abra uma issue no GitHub com:

• Descrição do problema
• Versão do n8n
• Versão do nó
• Passos para reproduzir
• Screenshots (se aplicável)

💡 Suporte

• 📚 Documentação do n8n
• 💬 Comunidade n8n
• 🐛 Reportar Bug

🌟 Agradecimentos

Desenvolvido com ❤️ para a comunidade n8n

---

Nota: Este é um nó comunitário e não é oficialmente mantido pela equipe do n8n.