n8n-nodes-maia

Nó oficial da plataforma MAIA para o n8n com suporte completo a Inteligência Comercial, Agenda Inteligente, Catálogo em Tempo Real e Frente de Caixa (POS).

⚡ Recursos Principais

• Agenda & Horários:
  • Consultar horários livres (getAvailableSlots) respeitando o expediente da empresa (Business Hours) e evitando conflitos de horários.
  • Criar agendamento (create) categorizado por modalidade (Showroom, Retirada, Delivery, Serviço), profissional e produto de interesse.
  • Remarcar horário (reschedule) e Cancelar (cancel).
• Caixa & Vendas (POS):
  • Registrar venda ganha (convertSale) criando automaticamente o pedido na tabela orders do Caixa com status PAID.
  • Suporte a carrinho de múltiplos produtos (items) com baixa automática de estoque.
  • Suporte a Trade-In (abatimento do valor com aparelho de entrada, ex: iPhone usado).
  • Suporte a parcelamento no cartão de crédito (installments).
• Catálogo & Estoque:
  • Consultar todos os produtos e serviços ativos com saldo de estoque em tempo real, códigos de barras e variações.
• CRM & Inteligência:
  • Raio-X Contexto 360° do cliente (getLeadContext): estágio do lead, compras anteriores, pedidos no Caixa e agendamento ativo.
  • Mover lead de etapa no Kanban e sincronizar etiquetas com WhatsApp.
  • Gerenciar tags de segmentação.
• Atendimento & Chat:
  • Acionar transbordo para operador humano (humanTakeover) pausando a IA.
  • Enviar mensagem no WhatsApp com autoria de IA (sendMessage).

📦 Como Instalar no n8n

Opção 1: Pela Interface do n8n (Recomendado)

1. No seu n8n, acesse Settings (Configurações) -> Community Nodes.
2. Clique em Install a community node.
3. Digite o nome do pacote:

   n8n-nodes-maia

4. Marque a caixa confirmando os riscos e clique em Install.
5. O nó MAIA estará disponível na sua lista de nós!

Opção 2: Instalação Manual via Docker / CLI

No container ou servidor onde o n8n está instalado:

npm install n8n-nodes-maia

Ou no diretório de nós customizados:

cd ~/.n8n/custom
npm install n8n-nodes-maia

🔐 Configuração de Credenciais

1. Adicione o nó MAIA a qualquer workflow.
2. Na seção Credential to connect with, selecione Create New Credential.
3. Preencha:
   • URL Base do MAIA: https://multforme.com (ou URL do seu servidor)
   • Chave Secreta de API (x-api-key): Sua chave sk_live_... obtida no painel do MAIA em Automações -> IA de Atendimento -> Chave de API.
4. Clique em Test Connection para validar a comunicação.

🛠️ Desenvolvimento Local

Para clonar e testar localmente:

git clone https://github.com/erickpiter/MAIA.git
cd MAIA/packages/n8n-nodes-maia
npm install
npm run build
npm link

Na pasta de dados do n8n:

cd ~/.n8n/custom
npm link n8n-nodes-maia

📄 Licença

MIT © Equipe MAIA