maia

Nó oficial da plataforma MAIA para n8n: Inteligência Comercial, Agenda Inteligente, Catálogo, Estoque, AI Agent Tool e Caixa (POS)

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.3.0
Author: Equipe MAIA

Available Nodes

Documentation generating…

MAIA Atendimento, Caixa & Estoque icon
MAIA Atendimento, Caixa & Estoque
Integração oficial com a inteligência comercial, agenda, catálogo, estoque e caixa do MAIA
MAIA Tool icon
MAIA Tool
Integração oficial com a inteligência comercial, agenda, catálogo, estoque e caixa do MAIA

Documentation

n8n-nodes-maia

MAIA Logo

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

Discussion