n8n-nodes-zappify

Pacote de nodes customizados para integrar o n8n com a API Zappify para WhatsApp.

Instalacao

Via npm (Comunidade n8n)

npm install n8n-nodes-zappify

Instalacao Manual

1. Clone ou baixe este repositorio
2. Execute npm install para instalar dependencias
3. Execute npm run build para compilar
4. Copie a pasta dist para o diretorio de nodes customizados do n8n:
   • Linux: ~/.n8n/custom/
   • Windows: %USERPROFILE%\.n8n\custom\

Configuracao de Credenciais

Para usar este node, voce precisa configurar as credenciais da API Zappify:

1. Base URL: URL base da sua instancia Zappify (ex: https://api.zappify.cloud)
2. API Key: Chave de API da sua instancia (ex: sk_xxxxxxxxxxxxx)

Recursos Disponiveis

Conexao

• Obter conexao (QR Code ou status)
• Reiniciar instancia
• Desconectar
• Status da API
• Health check

Perfil

• Alterar nome
• Alterar status/recado
• Alterar foto
• Remover foto
• Configuracoes de privacidade

Mensagens

• Texto: Enviar mensagens de texto com suporte a mencoes, divisao de mensagens e processamento de links
• Audio: Enviar mensagens de audio
• Midia: Enviar imagens e videos com legenda
• Documento: Enviar arquivos/documentos
• Sticker: Enviar figurinhas
• Localizacao: Enviar localizacao
• Contato: Enviar cartao de contato
• Botoes: Enviar mensagens com botoes interativos
• Carrossel: Enviar carrossel de produtos
• Lista: Enviar lista interativa
• Status: Publicar status/stories
• PIX: Enviar QR Code PIX
• Evento: Enviar convite de evento
• Video PTV: Enviar video circular
• Album: Enviar album de fotos/videos
• Reagir: Reagir a mensagens
• Excluir: Excluir mensagens
• Editar: Editar mensagens enviadas
• Fixar: Fixar/desafixar mensagens
• Ler: Marcar mensagens como lidas
• Encaminhar: Encaminhar mensagens
• Download: Baixar midia de mensagens

Grupos

• Criar grupo
• Listar grupos
• Obter informacoes do grupo
• Atualizar grupo
• Obter codigo de convite
• Aceitar convite
• Adicionar participantes
• Remover participantes
• Promover a admin
• Rebaixar admin
• Sair do grupo

Contatos

• Listar contatos
• Verificar numeros (se tem WhatsApp)
• Bloquear usuario
• Desbloquear usuario
• Lista de bloqueados

Webhooks

Configurar webhooks para os seguintes eventos:

• Mensagens recebidas (upsert)
• Mensagens atualizadas
• Mensagens deletadas
• Mensagens enviadas
• Atualizacao de conexao
• QR Code atualizado
• Contatos atualizados/modificados
• Chats atualizados/modificados/deletados
• Grupos atualizados/modificados
• Participantes de grupo
• Atualizacao de presenca
• Inicio da aplicacao

Fila e Jobs

• Pausar fila
• Retomar fila
• Listar jobs
• Resumo de jobs

Configuracoes

• Obter configuracoes
• Atualizar configuracoes
• Obter/Rotacionar fingerprint

Integracoes

• Criar integracao (ChatVolt, GPT Maker)
• Obter integracao
• Excluir integracao
• Ativar/Desativar integracao

Text to Speech (ElevenLabs)

• Listar vozes disponiveis
• Obter configuracoes TTS
• Atualizar API Key
• Atualizar voz padrao
• Converter texto em audio

Estatisticas

• Estatisticas de mensagens

Exemplos de Uso

Enviar Mensagem de Texto

{
  "resource": "messages",
  "operation": "sendText",
  "jid": "5511999999999",
  "message": "Ola! Esta e uma mensagem enviada pelo n8n.",
  "textOptions": {
    "mentionsEveryone": false,
    "processImageLink": true
  }
}

Verificar Numeros

{
  "resource": "contacts",
  "operation": "checkNumbers",
  "checkNumbersList": ["5511999999999", "5511888888888"]
}

Configurar Webhook

{
  "resource": "webhooks",
  "operation": "create",
  "webhookType": "messages-upsert",
  "webhookUrl": "https://seu-servidor.com/webhook"
}

Desenvolvimento

# Instalar dependencias
npm install

# Compilar
npm run build

# Compilar em modo watch (desenvolvimento)
npm run dev

Licenca

MIT

Suporte

Para suporte, entre em contato com a equipe Zappify ou acesse a documentacao em https://docs.zappify.cloud