painelpuma

n8n community node para integração completa com o PainelPuma (BX Digital)

Package Information

Released: 1 mo ago
Downloads: 43 weekly / 675 monthly
Latest Version: 1.0.21

Available Nodes

PainelPuma icon
PainelPuma
Integração completa com o PainelPuma (BX Digital) — médicos, agendamentos, pacientes, produtos, WhatsApp e muito mais
PainelPuma Trigger icon
PainelPuma Trigger
Dispara fluxos no n8n quando eventos ocorrem no PainelPuma — via Webhook ou Polling
PainelPuma Modo Teste icon
PainelPuma Modo Teste
Verifica se um número de WhatsApp pode seguir no fluxo. Com o modo teste ativo no painel, só números cadastrados passam pela saída "Permitido".

Documentation

n8n-nodes-painelpuma

Community node para o n8n com integração completa ao sistema PainelPuma (BX Digital).

Recursos cobertos (25 recursos / ~80 operações)

Recurso Operações
Autenticação Login, Obter Perfil, Atualizar Perfil, Validar Token, Logout
Médicos Listar, Obter, Criar, Atualizar, Deletar, Importar em Lote
Pacientes Listar, Obter, Criar, Atualizar, Deletar, Estatísticas
Agendamentos Listar, Criar, Criar Combinado, Atualizar Status, Deletar, Slots, Ocupados, Indisponíveis, Config (multi-agenda + config_id), Salvar/Excluir Agenda, Buscar/Deletar/Atualizar por Paciente
Produtos Listar, Criar, Atualizar, Deletar, Importar em Lote
Categorias Listar, Obter, Criar, Atualizar, Deletar, Médicos da Categoria, Produtos da Categoria, Importar
Convênios CRUD completo + Importar em Lote
Endereços CRUD completo + Importar em Lote
FAQs CRUD completo + Importar em Lote
Condutas CRUD completo + Importar em Lote
Quebras de Objeção CRUD completo + Importar em Lote
Informações Gerais CRUD completo + Importar em Lote
Busca Avançada Busca por texto, categoria, médico, endereço, faixa de valor
Dashboard Estatísticas, Gráficos, Leads Stats, Leads Charts
Estatísticas e Exportação Estatísticas globais, Exportar dados por tipo
Configurações Config pública, Listar, Atualizar Tema, Salvar em lote
Usuários CRUD completo (requer admin)
Tokens de API Listar, Criar, Deletar
Logs Listar, Estatísticas, Limpar
Backup Listar Seções, Exportar, Restaurar
IA Config Obter, Atualizar
Evolution (WhatsApp) Configs CRUD, Instâncias, Conectar, Status, Logout
WuzAPI (WhatsApp) Configs CRUD, Proxy Users, Conectar, QR Code
Google Calendar Config, Auth URL, Callback OAuth, Calendários, Sincronizar, Desconectar
SIDS / Kommo Listar, Buscar por Chat ID, Atualizar, Deletar

Instalação

Opção 1 — Via n8n Community Nodes (recomendado)

  1. No n8n, acesse Settings → Community Nodes
  2. Clique em Install
  3. Digite o nome do pacote: n8n-nodes-painelpuma
  4. Confirme a instalação

Opção 2 — Instalação local (desenvolvimento)

# Na pasta de dados do n8n (geralmente ~/.n8n)
cd ~/.n8n/nodes
npm install /caminho/para/n8n-nodes-painelpuma

Ou com link simbólico para desenvolvimento:

cd D:\PainelPuma\n8n-nodes-painelpuma
npm run build
npm link

cd ~/.n8n/nodes  # ou %APPDATA%\n8n\nodes no Windows
npm link n8n-nodes-painelpuma

Configuração de Credenciais

Após instalar, configure as credenciais PainelPuma API:

Campo Descrição Exemplo
URL Base URL do servidor PainelPuma https://meu-painel.com ou http://localhost:3001
Token de Acesso JWT (obtido via operação Login) ou token puma_* eyJhbGci... ou puma_abc123

Dica: Use o nó PainelPuma com operação Autenticação → Fazer Login para obter o JWT e configure-o nas credenciais.

Exemplos de Uso

Buscar slots disponíveis para um médico

  1. Adicione o nó PainelPuma
  2. Recurso: Agendamentos → Operação: Obter Slots Disponíveis
  3. Selecione o Médico na lista (carregada da API)
  4. Opcional: em Agenda (config_id) escolha uma agenda específica ou deixe Todas as agendas (mesclar)
  5. Preencha Data Início e Data Fim

Múltiplas agendas por médico

  • Obter Config da Agenda lista todas as agendas ativas; use Agenda (config_id) para ver o detalhe de uma só
  • Salvar Config da Agenda: modo Criar Nova Agenda (criar_nova) ou Atualizar com select da agenda existente
  • Excluir Agenda do Médico: DELETE /api/agendamentos/config/:config_id (soft delete)

Criar agendamento com paciente novo

  1. Recurso: Agendamentos → Operação: Criar Combinado
  2. Preencha o JSON com dados do paciente + agendamento:
{
  "paciente": { "nome": "João Silva", "celular": "11999999999" },
  "medico_id": "1",
  "data_agendamento": "2026-05-10",
  "hora_inicio": "09:00"
}

Busca avançada de produtos

  1. Recurso: Busca Avançada → Operação: Busca Avançada
  2. Preencha os parâmetros desejados (texto, categoria, médico, etc.)

Desenvolvimento

# Clonar / abrir a pasta
cd D:\PainelPuma\n8n-nodes-painelpuma

# Instalar dependências
npm install

# Compilar TypeScript
npm run build

# Compilar em modo watch
npm run dev

# Lint
npm run lint
npm run lintfix

Estrutura do projeto

n8n-nodes-painelpuma/
├── credentials/
│   └── PainelPumaApi.credentials.ts   # Definição das credenciais
├── nodes/
│   └── PainelPuma/
│       ├── PainelPuma.node.ts          # Nó principal (execute + routing)
│       ├── GenericFunctions.ts          # Helper de requisições HTTP
│       └── descriptions/               # Parâmetros por recurso
│           ├── auth.description.ts
│           ├── medicos.description.ts
│           ├── pacientes.description.ts
│           ├── agendamentos.description.ts
│           ├── produtos.description.ts
│           ├── crud-simples.description.ts   # categorias, convênios, endereços
│           ├── conteudo.description.ts        # FAQs, condutas, quebras, info
│           ├── admin.description.ts           # usuários, tokens, logs, backup, IA, config, dashboard, stats, busca
│           └── whatsapp.description.ts        # Evolution, WuzAPI, Google Calendar, SIDS
├── dist/                               # Arquivos compilados (gerado pelo build)
├── package.json
├── tsconfig.json
└── README.md

Licença

MIT — BX Digital

Discussion