n8n-nodes-whatmaster

Este é um node personalizado para n8n que permite integração com a API WhatMaster para envio de mensagens via WhatsApp e gestão de tickets.

Funcionalidades

📱 Mensagens

• Enviar mensagens de texto
• Enviar arquivos (PDF, imagens, etc.)
• Enviar arquivos em Base64
• Enviar arquivos via URL
• Enviar stickers
• Enviar localização
• Enviar mensagens com parâmetros

🎫 Tickets

• Mostrar informações do ticket
• Listar todos os tickets
• Definir fila do ticket
• Definir informações do ticket
• Criar ticket
• Listar mensagens do ticket

👥 Contatos

• Definir CRM no contato
• Definir Follow-up no contato
• Definir tags no contato
• Criar contato
• Atualizar contato
• Mostrar informações do contato
• Validar número do WhatsApp
• Listar contatos por filtros

🔧 API Oficial

• Enviar botões
• Enviar listas
• Enviar links
• Solicitar localização
• Enviar templates

⚡ API Plus

• Operações de botão
• Operações de lista

Instalação

1. Clone este repositório
2. Execute npm install
3. Execute npm run build
4. Copie a pasta dist para o diretório de nodes do n8n

Configuração

Credenciais

1. Base URL: https://back.whatmaster.com.br/v1/api/external
2. Bearer Token: Seu token de autenticação da API WhatMaster

External Key

A External Key é opcional e deve ser configurada no campo correspondente. Ela serve para identificação única do sistema cliente para execução de ações com webhook.

Exemplo de URL completa

Se você configurar a External Key como 0d30d795-a231-4d80-9726-e793b86898fc, a URL final será:
https://back.whatmaster.com.br/v1/api/external/0d30d795-a231-4d80-9726-e793b86898fc

Uso

1. Adicione o node WhatMaster ao seu workflow
2. Configure as credenciais (Base URL e Bearer Token)
3. Escolha o recurso (Mensagem, Ticket, Contato, etc.)
4. Selecione a operação desejada
5. Preencha os parâmetros necessários
6. Execute o workflow

Exemplos

Enviar Mensagem de Texto

1. Recurso: Mensagem
2. Operação: Enviar Texto
3. Parâmetros:
   • External Key: sua-chave-externa (opcional)
   • Número do WhatsApp: 5511999999999
   • Mensagem: Olá! Esta é uma mensagem de teste.

Enviar Arquivo

1. Recurso: Mensagem
2. Operação: Enviar Arquivo
3. Parâmetros:
   • External Key: sua-chave-externa (opcional)
   • Número do WhatsApp: 5511999999999
   • Mensagem: Aqui está o documento solicitado.
   • Arquivo: /caminho/para/arquivo.pdf

Criar Contato

1. Recurso: Contato
2. Operação: Criar Contato
3. Parâmetros:
   • External Key: sua-chave-externa (opcional)
   • Número do WhatsApp: 5511999999999
   • Nome do Contato: João Silva
   • Email do Contato: joao@email.com

Desenvolvimento

Estrutura do Projeto

n8n-nodes-whatmaster/
├── nodes/
│   └── WhatMaster/
│       ├── WhatMaster.node.js
│       └── whatmaster.svg
├── credentials/
│   └── WhatMasterApi.credentials.ts
├── dist/
│   ├── nodes/
│   └── credentials/
├── package.json
├── tsconfig.json
└── README.md

Build

npm run build

Lint

npm run lint

Licença

MIT

Suporte

Para suporte, abra uma issue no repositório ou entre em contato com o desenvolvedor.