Wiizo Chat n8n Node

Este é um nó personalizado para n8n que permite integração completa com a API Wiizo, oferecendo funcionalidades para envio de mensagens, gerenciamento de contatos, tickets, empresas, tags e agendamentos.

🚀 Funcionalidades

📤 Mensagens

• Enviar Mensagem de Texto: Envio de mensagens de texto simples
• Enviar Lista Interativa: Envio de mensagens com listas de opções interativas
• Suporte a Mídia: Envio de imagens, vídeos, documentos e áudios via URL

👥 Contatos

• Criar Contato: Criação de novos contatos
• Atualizar Contato: Atualização de dados de contatos existentes
• Listar Contatos: Listagem de todos os contatos
• Excluir Contato: Exclusão de contatos

🎫 Tickets

• Atualizar Ticket: Atualização de status, responsável e fila de tickets

🏢 Empresas

• Criar Empresa: Criação de novas empresas com todos os dados necessários

🏷️ Tags

• Criar Tag: Criação de tags com nome, cor e kanban
• Excluir Tag: Exclusão de tags

⏰ Agendamentos

• Criar Agendamento: Agendamento de mensagens para envio futuro
• Listar Agendamentos: Listagem de todos os agendamentos
• Excluir Agendamento: Exclusão de agendamentos

📋 Pré-requisitos

• n8n (versão 0.200.0 ou superior)
• Token de acesso da API Wiizo
• Node.js 16+ (para desenvolvimento)

🔧 Instalação

1. Clone este repositório:

git clone https://github.com/micael/wiizo-chat-n8n.git
cd wiizo-chat-n8n

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

4. Instale o pacote no n8n:

npm install -g .

⚙️ Configuração

Credenciais

1. No n8n, vá para Settings > Credentials
2. Clique em Add Credential e selecione Wiizo Chat API
3. Configure:
   • URL Base: https://api-dev-v2.wiizo.com.br
   • Token de Conexão: Seu token de acesso da API Wiizo

Uso do Nó

1. Adicione o nó Wiizo Chat ao seu workflow
2. Selecione a operação desejada
3. Configure os parâmetros necessários
4. Execute o workflow

📚 Documentação da API

Endpoints Suportados

Operação	Endpoint	Método	Descrição
Enviar Mensagem	/api/messages/send	POST	Envia mensagem de texto ou mídia
Enviar Lista	/api/send/list/message	POST	Envia lista interativa
Criar Contato	/api/contactCreate	POST	Cria novo contato
Atualizar Contato	/api/contactUpdate	PUT	Atualiza contato existente
Listar Contatos	/api/contactList	GET	Lista todos os contatos
Excluir Contato	/api/contactRemove	DELETE	Exclui contato
Atualizar Ticket	/api/updateTicket	PUT	Atualiza ticket
Criar Empresa	/api/companyCreate	POST	Cria nova empresa
Criar Tag	/api/TagCreate	POST	Cria nova tag
Excluir Tag	/api/TagDelete/:id	DELETE	Exclui tag
Criar Agendamento	/api/ScheduleCreate	POST	Cria agendamento
Listar Agendamentos	/api/scheduleList	GET	Lista agendamentos
Excluir Agendamento	/api/ScheduleDelete/:id	DELETE	Exclui agendamento

Exemplos de Uso

Enviar Mensagem de Texto

{
  "number": "555195813085",
  "body": "Olá, esta é uma mensagem de teste!",
  "contact": {
    "name": "João Silva",
    "email": "joao@email.com"
  },
  "queueId": 1,
  "status": "open",
  "userId": 3,
  "tagId": "tag123"
}

Enviar Lista Interativa

{
  "id": "555195813085",
  "type": "user",
  "options": {
    "delay": 0,
    "replyFrom": ""
  },
  "groupOptions": {
    "markUser": "ghostMention"
  },
  "msgdata": {
    "title": "Escolha uma opção",
    "description": "Selecione uma das opções abaixo",
    "buttonText": "Ver Opções",
    "footerText": "Rodapé da lista",
    "sections": [
      {
        "title": "Opções",
        "rows": [
          { "title": "Opção 1", "description": "Descrição da opção 1", "rowId": "opt1" },
          { "title": "Opção 2", "description": "Descrição da opção 2", "rowId": "opt2" }
        ]
      }
    ]
  }
}

🔄 Desenvolvimento

Scripts Disponíveis

• npm run build - Compila o projeto
• npm run dev - Modo de desenvolvimento com watch
• npm run format - Formata o código
• npm run lint - Executa o linter
• npm run lintfix - Corrige problemas do linter

Estrutura do Projeto

src/
├── credentials/
│   └── WiizoChatApi.credentials.ts
├── nodes/
│   └── WiizoChat/
│       ├── WiizoChat.node.ts
│       └── icon.svg
└── index.ts

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

📞 Suporte

Para suporte e dúvidas:

• Abra uma issue no GitHub
• Entre em contato: micael@example.com

🔗 Links Úteis

• Documentação da API Wiizo
• Documentação do n8n
• n8n Community