n8n-nodes-up-api

Este é um node customizado do n8n para integração com a Up API - uma API completa para WhatsApp com Agentes de IA.

🚀 Funcionalidades

📱 Instâncias

• Criar, listar e gerenciar instâncias WhatsApp
• Obter QR Code para conexão
• Reconectar e desconectar instâncias

💬 Mensagens

• Enviar mensagens de texto
• Enviar texto com indicador de "digitando" ⌨️ (NOVO!)
• Enviar imagens com legenda
• Enviar documentos
• Enviar áudios
• Enviar áudio com indicador de "gravando" 🎤 (NOVO!)
• Enviar indicadores de presença (digitando/gravando/pausado) (NOVO!)
• Ver histórico de mensagens

🔗 Webhooks

• Criar webhooks para receber eventos
• Listar webhooks configurados
• Deletar webhooks

🤖 Agentes IA

• Criar agentes com OpenAI (GPT) ou Groq (Llama)
• Listar, atualizar e deletar agentes
• Configurar prompts personalizados

📦 Instalação

Via n8n Community Nodes

1. Abra o n8n
2. Vá em Settings → Community Nodes
3. Clique em Install
4. Digite: n8n-nodes-up-api
5. Clique em Install

Via npm (para desenvolvimento)

cd ~/.n8n/nodes
npm install n8n-nodes-up-api

🔑 Configuração

1. Obter API Key

1. Acesse o painel da Up API
2. Vá em Configurações
3. Copie sua API Key

2. Configurar Credenciais no n8n

1. No n8n, adicione o node Up API
2. Clique em Create New Credentials
3. Preencha:
   • Base URL: https://seu-dominio.com (ou http://localhost:5825 para local)
   • API Key: Sua chave API

📖 Exemplos de Uso

Exemplo 1: Enviar Mensagem com Digitação Automática

Trigger → Up API (Enviar Texto com Digitação)

Configuração:

• Resource: Mensagem
• Operation: Enviar Texto com Digitação
• Instância: minha-instancia
• Número: 5511999999999
• Mensagem: Olá! Como posso ajudar?
• Duração da Digitação: 3000 (3 segundos)

Exemplo 2: Enviar Indicador de "Digitando"

Trigger → Up API (Enviar Presença)

Configuração:

• Resource: Mensagem
• Operation: Enviar Presença
• Instância: minha-instancia
• Número: 5511999999999
• Tipo de Presença: Digitando
• Duração: 5000 (5 segundos)

Exemplo 3: Criar Agente IA

Trigger → Up API (Criar Agente)

Configuração:

• Resource: Agente IA
• Operation: Criar
• Instância: minha-instancia
• Nome do Agente: Atendente Virtual
• Provider: Groq
• Modelo: llama-3.3-70b-versatile
• API Key do Provider: sua-groq-api-key
• Prompt do Sistema: Você é um assistente virtual amigável

Exemplo 4: Workflow Completo de Atendimento

Webhook → 
  Up API (Enviar Presença: Digitando) → 
  Wait (3 segundos) → 
  Up API (Enviar Texto)

🆕 Novidades v1.1.0

Indicadores de Presença

Agora você pode enviar indicadores de "digitando" e "gravando" para tornar suas conversas mais naturais!

Tipos de Presença:

• composing - Digitando... ⌨️
• recording - Gravando áudio... 🎤
• paused - Parar indicador

Operações Novas:

1. Enviar Texto com Digitação - Envia o indicador "digitando" antes da mensagem
2. Enviar Áudio com Gravação - Envia o indicador "gravando" antes do áudio
3. Enviar Presença - Envia apenas o indicador (sem mensagem)

🔧 Recursos Disponíveis

Instância

• ✅ Criar
• ✅ Listar
• ✅ Status
• ✅ QR Code
• ✅ Reconectar
• ✅ Logout
• ✅ Deletar

Mensagem

• ✅ Enviar Texto
• ✅ Enviar Texto com Digitação (NOVO!)
• ✅ Enviar Imagem
• ✅ Enviar Documento
• ✅ Enviar Áudio
• ✅ Enviar Áudio com Gravação (NOVO!)
• ✅ Enviar Presença (NOVO!)
• ✅ Histórico

Webhook

• ✅ Criar
• ✅ Listar
• ✅ Deletar

Agente IA

• ✅ Criar
• ✅ Listar
• ✅ Atualizar
• ✅ Deletar

🤝 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

👤 Autor

Andre Zambuja

• Email: [email protected]
• GitHub: @upandreazambuja

🔗 Links

• Up API Documentation
• n8n Community
• Report Issues

📝 Changelog

v1.1.0 (2026-02-12)

• ✨ Adicionado suporte para indicadores de presença (typing/recording)
• ✨ Nova operação: Enviar Texto com Digitação
• ✨ Nova operação: Enviar Áudio com Gravação
• ✨ Nova operação: Enviar Presença
• 📝 Documentação atualizada
• 🐛 Correções de bugs

v1.0.0 (2026-01-15)

• 🎉 Lançamento inicial
• ✨ Suporte para instâncias, mensagens, webhooks e agentes IA