n8n-nodes-teamsix-zap-solution

Biblioteca de nodes do n8n para integração com TeamSix Zap Solution.

📦 Instalação

Instalação Local (Desenvolvimento)

1. Clone o repositório:

git clone https://github.com/Jeffersonp2/TeamSix-Zap-Solution.git
cd TeamSix-Zap-Solution/n8n-nodes-teamsix-zap-solution

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

4. No n8n, adicione o caminho da biblioteca:
   • Vá em Settings > Community Nodes
   • Adicione o caminho: C:\n8n\teamsix-zap-solution\n8n-nodes-teamsix-zap-solution

Instalação via NPM (quando publicado)

npm install n8n-nodes-teamsix-zap-solution

🔧 Configuração

Credenciais

1. Crie uma credencial do tipo "TeamSix Zap Solution API"
2. Configure a URL base da API (padrão: http://localhost:3000)

📚 Nodes Disponíveis

1. Send Text

Envia mensagem de texto via WhatsApp.

Parâmetros:

• Remote JID (obrigatório): ID do chat/contato
• Text (obrigatório): Texto da mensagem
• Quoted Message ID (opcional): ID da mensagem para responder

Exemplo:

Remote JID: [email protected]
Text: Olá, como vai?
Quoted Message ID: (deixe vazio se não for responder)

2. Send Media

Envia mídia (imagem, vídeo, áudio, documento, sticker) via WhatsApp.

Parâmetros:

• Remote JID (obrigatório): ID do chat/contato
• Media Type (obrigatório): Tipo de mídia
  • Image
  • Video
  • GIF
  • Audio
  • Document
  • Sticker
• Media (obrigatório): URL, base64 ou caminho do arquivo
• Caption (opcional): Legenda da mídia
• Quoted Message ID (opcional): ID da mensagem para responder
• File Name (opcional, apenas Document): Nome do arquivo
• MIME Type (opcional, apenas Document): Tipo MIME (ex: pdf, docx)

Exemplo:

Remote JID: [email protected]
Media Type: Image
Media: https://example.com/image.jpg
Caption: Veja esta imagem!
Quoted Message ID: (deixe vazio se não for responder)

3. Presence

Controla a presença (digitando, gravando, parar).

Parâmetros:

• Operation (obrigatório): Tipo de operação
  • Digitando
  • Gravando
  • Parar
• Remote JID (obrigatório): ID do chat/contato

Exemplo:

Operation: Digitando
Remote JID: [email protected]

4. Read Messages

Marca mensagens como lidas.

Parâmetros:

• Message Keys (obrigatório): Array JSON de WAMessageKey

Exemplo:

[
  {
    "remoteJid": "[email protected]",
    "id": "3EB0123456789ABCDEF"
  }
]

🚀 Uso

1. Adicione um node do TeamSix Zap Solution no seu workflow
2. Configure as credenciais
3. Preencha os parâmetros necessários
4. Execute o workflow

📝 Notas

• O campo Quoted Message ID é opcional em todos os nodes que o suportam
• Se o campo estiver vazio, a mensagem será enviada normalmente (sem responder)
• Para Send Media, o tipo de mídia deve ser selecionado no campo Media Type
• A URL base padrão é http://localhost:3000, mas pode ser alterada nas credenciais

🔗 Links

• Repositório GitHub
• Documentação da API

📄 Licença

MIT

👨‍💻 Autor

Jefferson Oliveira