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": "[email protected]"
  },
  "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: [email protected]

🔗 Links Úteis

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