📋 Descrição

O DevConnectAi é um nó personalizado para o n8n que permite integração completa com nossa API. Com este nó, você pode enviar mensagens, gerenciar contatos, tickets, tags, agendamentos e empresas de forma simples e intuitiva, transformando o n8n em um poderoso CRM para WhatsApp.

🚀 Funcionalidades

📤 Envio de Mensagens

• Enviar Mensagem: Envie mensagens de texto simples
• Enviar Lista: Envie mensagens com listas interativas (botões)

👥 Gestão de Contatos

• Criar Contato: Adicione novos contatos com informações completas
• Listar Contatos: Visualize todos os contatos
• Atualizar Contato: Modifique dados de contatos existentes
• Remover Contato: Delete contatos

🏷️ Gestão de Tags

• Criar Tag: Crie novas tags com cores personalizadas
• Listar Tags: Visualize todas as tags
• Deletar Tag: Remova tags

📅 Agendamentos

• Criar Agendamento: Programe mensagens para envio futuro
• Listar Agendamentos: Visualize todos os agendamentos
• Deletar Agendamento: Remova agendamentos

🎫 Gestão de Tickets

• Listar Tickets: Visualize todos os tickets
• Mostrar Ticket: Veja detalhes de um ticket específico
• Atualizar Ticket: Modifique status e dados do ticket
• Deletar Ticket: Remova tickets
• Adicionar Tag ao Ticket: Associe tags aos tickets
• Remover Tag do Ticket: Remova associações de tags

🏢 Gestão de Empresas

• Criar Empresa: Crie novas empresas com planos
• Listar Empresas: Visualize todas as empresas
• Mostrar Empresa: Veja detalhes de uma empresa
• Atualizar Empresa: Modifique dados da empresa
• Deletar Empresa: Remova empresas

🔍 Verificações

• Verificar Número: Confirme se um número existe no WhatsApp

⚙️ Configuração

1. Credenciais

Configure as credenciais com os seguintes campos:

• URL Base: URL do seu backend (ex: https://api.dominio.com)
• Token de Conexão: Token da conexão WhatsApp (para envio de mensagens)
• Token da Empresa: Token da empresa (para operações de contatos, tags, etc.)
• Token Admin: Token de administrador (para operações de empresas)

2. Tipos de Token

🔗 Token de Conexão

• Uso: Envio de mensagens e verificações de número
• Onde encontrar: Na configuração da conexão WhatsApp

🏢 Token da Empresa

• Uso: Operações de contatos, tags, agendamentos e tickets
• Onde encontrar: Na aba documentação

👑 Token Admin

• Uso: Operações de criação e gestão de empresas
• Onde encontrar: Na aba documentação

📝 Guia de Uso

Enviando Mensagens

Mensagem Simples

1. Selecione a operação "📤 Enviar Mensagem"
2. Escolha "🔗 Token de Conexão"
3. Digite o número (ex: 5511999999999)
4. Digite a mensagem
5. Execute o nó

Mensagem com Lista

1. Selecione a operação "📋 Enviar Lista"
2. Escolha "🔗 Token de Conexão"
3. Configure:
   • Cabeçalho: Título da lista
   • Corpo: Descrição da lista
   • Rodapé: Texto opcional do rodapé
   • Botão: Texto do botão principal
   • Seções: Configure as opções da lista

Criando Contatos

1. Selecione a operação "👤 Criar Contato"
2. Escolha "🏢 Token da Empresa"
3. Preencha os campos:
   • Nome: Nome do contato
   • Email: Email do contato
   • Telefone: Número do telefone
   • URL da Foto: Link da foto de perfil (opcional)
   • É Grupo: Se é um grupo ou contato individual
   • Canal: WhatsApp, Facebook ou Instagram
   • Informações Extras: Dados adicionais em JSON

Criando Empresas

1. Selecione a operação "🏢 Criar Empresa"
2. Escolha "👑 Token Admin"
3. Preencha todos os campos obrigatórios:
   • Nome: Nome da empresa
   • Email: Email da empresa
   • Telefone: Telefone da empresa
   • Senha: Senha para acesso
   • Status: Ativo ou Inativo
   • ID do Plano: ID do plano contratado
   • Data de Vencimento: Data de vencimento do plano
   • Recorrência: Mensal ou Anual
   • Documento: CNPJ/CPF
   • Método de Pagamento: Cartão, PIX ou Boleto
   • Nome de Usuário: Nome de usuário da empresa

Gerenciando Tickets

Atualizando um Ticket

1. Selecione a operação "✏️ Atualizar Ticket"
2. Escolha "🏢 Token da Empresa"
3. Digite o ID do ticket
4. Configure os dados de atualização em JSON:

   {
     "status": "closed",
     "userId": 1,
     "queueId": 2
   }

Adicionando Tags

1. Selecione a operação "🏷️ Adicionar Tag ao Ticket"
2. Escolha "🏢 Token da Empresa"
3. Digite o ID do ticket
4. Digite o ID da tag

🔗 Endpoints Utilizados

O nó utiliza os seguintes endpoints da API:

• /send - Envio de mensagens
• /send/list/message - Envio de listas
• /checkNumber - Verificação de números
• /api/contactCreate - Criação de contatos
• /api/contactList - Listagem de contatos
• /api/contactUpdate - Atualização de contatos
• /api/contactRemove - Remoção de contatos
• /api/companyCreate - Criação de empresas
• /api/TagCreate - Criação de tags
• /api/TagList - Listagem de tags
• /api/TagDelete/:id - Remoção de tags
• /api/ScheduleCreate - Criação de agendamentos
• /api/ScheduleList - Listagem de agendamentos
• /api/ScheduleDelete/:id - Remoção de agendamentos
• /api/updateTicket - Atualização de tickets
• /api/tickets - Listagem de tickets
• /api/tickets/:id - Detalhes de ticket
• /api/companies - Listagem de empresas
• /api/companies/:id - Detalhes de empresa
• /api/tickets/:id/tags - Adicionar tag ao ticket
• /api/tickets/:id/tags/:tagId - Remover tag do ticket

🎯 Dicas de Uso

Escolhendo o Token Correto

• Para mensagens: Use sempre o Token de Conexão
• Para contatos/tags/agendamentos: Use o Token da Empresa
• Para empresas: Use o Token Admin

Formato de Números

• Use sempre o formato internacional: 5511999999999
• Não use espaços, hífens ou parênteses
• Inclua o código do país (55 para Brasil)

Tratamento de Erros

O nó retorna informações detalhadas sobre erros, incluindo:

• Código de status HTTP
• Mensagem de erro
• Detalhes específicos da API

Performance

• Para operações em lote, use o nó em loops
• Para listagens grandes, considere usar paginação
• Mantenha as credenciais seguras e atualizadas

🏆 Recursos Exclusivos do CRM DevConnectAi

• Interface Intuitiva: Campos organizados e descrições claras
• Emojis Visuais: Identificação rápida de cada operação
• Validação Automática: Verificação de dados antes do envio
• Logs Detalhados: Rastreamento completo de todas as operações
• Suporte Multi-empresa: Gerencie múltiplas empresas simultaneamente
• Integração com Agentes IA: Compatível com ferramentas de inteligência artificial