n8n-nodes-uazapi-api

N8N Community Node para integração com a API UAZAPI - WhatsApp Business

Descrição

Este pacote contém um node customizado para o n8n que permite integrar com a API UAZAPI para envio e recebimento de mensagens do WhatsApp Business.

Características

🔧 Operações de Instância

• Get Status: Verificar status da instância (conectado, desconectado, conectando)
• Connect: Conectar instância ao WhatsApp
• Disconnect: Desconectar instância do WhatsApp

💬 Envio de Mensagens

• Send Text: Enviar mensagens de texto
• Send Media: Enviar mídias (imagem, vídeo, áudio, documento)
• Send Contact: Enviar cartão de contato (vCard)
• Send Location: Enviar localização geográfica
• Send Status: Enviar Stories (Status)
• Send Menu: Enviar menus interativos (botões, carrossel, lista)

📥 Webhook e Busca

• Get Messages: Obter mensagens recebidas
• Download Media: Baixar arquivos de mídia

Instalação

Via NPM (Recomendado)

npm install n8n-nodes-uazapi-api

Via Interface do n8n

1. Acesse as configurações do n8n
2. Vá para "Community Nodes"
3. Clique em "Install a community node"
4. Digite: n8n-nodes-uazapi-api
5. Clique em "Install"

Configuração

Credenciais

1. Token da Instância: Token de autenticação da sua instância UAZAPI
2. Subdomínio: Subdomínio da sua empresa (ex: free, suaempresa)
3. Base URL: URL base da API (padrão: https://{subdomain}.uazapi.com)

Como obter as credenciais

1. Acesse UAZAPI
2. Crie uma conta e faça login
3. Crie uma nova instância
4. Copie o token gerado
5. Use o subdomínio fornecido (geralmente "free" para contas gratuitas)

Uso Básico

1. Verificar Status da Instância

{
  "resource": "instance",
  "operation": "getStatus"
}

2. Conectar Instância

{
  "resource": "instance",
  "operation": "connect",
  "phone": "5511999999999"
}

3. Enviar Mensagem de Texto

{
  "resource": "message",
  "operation": "sendText",
  "phoneNumber": "5511999999999",
  "message": "Olá! Esta é uma mensagem enviada via n8n!"
}

4. Enviar Mídia

{
  "resource": "message",
  "operation": "sendMedia",
  "phoneNumber": "5511999999999",
  "mediaUrl": "https://exemplo.com/imagem.jpg",
  "mediaType": "image",
  "caption": "Legenda da imagem"
}

Exemplos de Workflows

Workflow de Boas-vindas

1. Webhook Trigger - Recebe dados do formulário
2. UAZAPI - Get Status - Verifica se a instância está conectada
3. UAZAPI - Send Text - Envia mensagem de boas-vindas
4. UAZAPI - Send Media - Envia imagem promocional

Workflow de Atendimento

1. UAZAPI - Get Messages - Busca mensagens recebidas
2. IF - Verifica tipo de mensagem
3. UAZAPI - Send Text - Responde automaticamente
4. UAZAPI - Send Contact - Envia contato do atendente

Recursos Avançados

Envio de Status/Stories

{
  "resource": "message",
  "operation": "sendStatus",
  "statusType": "text",
  "statusText": "Promoção especial!",
  "backgroundColor": 1
}

Envio de Localização

{
  "resource": "message",
  "operation": "sendLocation",
  "phoneNumber": "5511999999999",
  "latitude": -23.5505,
  "longitude": -46.6333,
  "locationName": "São Paulo, SP"
}

Envio de Contato

{
  "resource": "message",
  "operation": "sendContact",
  "phoneNumber": "5511999999999",
  "contactName": "João Silva",
  "contactPhone": "5511888888888"
}

Estados da Instância

• disconnected: Desconectado do WhatsApp
• connecting: Em processo de conexão
• connected: Conectado e autenticado com sucesso

Limitações

• O servidor possui um limite máximo de instâncias conectadas
• Quando o limite é atingido, novas tentativas receberão erro 429
• Servidores gratuitos/demo podem ter restrições adicionais de tempo de vida

Suporte

• Documentação UAZAPI: https://docs.uazapi.com
• Issues: GitHub Issues
• Contato: eduardo@astrixcore.com

Desenvolvido por

Eduardo Core - @astrixcore

Licença

MIT

Changelog

v1.0.0

• Implementação inicial
• Suporte a operações de instância
• Suporte a envio de mensagens básicas
• Suporte a webhook e busca de mensagens