up-api

n8n nodes for Up API - WhatsApp API with AI Agents, Typing & Recording indicators

Package Information

Downloads: 25 weekly / 976 monthly
Latest Version: 2.0.5
Author: Andre Zambuja

Available Nodes

Up API icon
Up API
WhatsApp API com Agentes de IA

Documentation

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

🔗 Links

📝 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

Discussion