n8n-nodes-levvex

Community node para n8n que recebe webhooks da plataforma Levvex.

Funcionalidades

• Trigger Node que recebe webhooks da Levvex automaticamente
• 21 eventos suportados (compras, assinaturas, MiniApp, ingressos)
• Filtro de eventos via multi-select — escolha quais eventos ativam o workflow
• Validacao de secret — garante que apenas webhooks legítimos disparam o workflow
• Payload completo — todos os dados da Levvex disponíveis nos nós seguintes

Instalação

No n8n (Community Nodes)

1. Acesse Settings > Community Nodes
2. Clique em Install a community node
3. Digite n8n-nodes-levvex e clique em Install

Via npm (self-hosted)

cd ~/.n8n
npm install n8n-nodes-levvex

Reinicie o n8n após a instalação.

Configuração

1. Criar o trigger no n8n

1. Adicione o nó Levvex Webhook ao seu workflow
2. Selecione os eventos que deseja receber (ou "Todos os Eventos")
3. Copie a Webhook URL gerada (Production URL)
4. Ative o workflow

2. Configurar o webhook na Levvex

1. No painel do seller: Integrações > Webhooks > Novo Webhook
2. Cole a URL do n8n no campo URL
3. Selecione os mesmos eventos que configurou no n8n
4. Copie o Secret gerado pela Levvex

3. Configurar a credencial no n8n

1. No nó Levvex Webhook, clique em Create New Credential
2. Cole o Secret copiado da Levvex
3. Salve

Eventos Disponíveis

Compras

| Evento | Descrição | |--------|-----------| | purchase_approved | Pagamento confirmado | | purchase_refused | Pagamento recusado | | pix_generated | PIX criado aguardando pagamento | | refund | Reembolso processado | | chargeback | Contestação recebida |

Checkout & Entrega

| Evento | Descrição | |--------|-----------| | checkout_abandonment | Carrinho abandonado | | product_access | Acesso ao produto liberado | | product_access_personalized | Entrega personalizada |

Assinaturas

| Evento | Descrição | |--------|-----------| | subscription_renewed | Cobrança recorrente aprovada | | subscription_canceled | Assinatura cancelada | | subscription_failed | Falha na cobrança | | subscription_unpaid | Pagamento pendente | | subscription_expiring | Próxima do vencimento |

MiniApp

| Evento | Descrição | |--------|-----------| | miniapp_lesson_completed | Aluno concluiu aula | | miniapp_student_joined | Aluno adicionado | | miniapp_student_removed | Aluno removido |

Eventos (Ingressos)

| Evento | Descrição | |--------|-----------| | event_ticket_purchased | Ingresso comprado | | event_ticket_cancelled | Ingresso cancelado | | event_checkin | Check-in realizado | | event_attendee_registered | Participante registrado | | event_ticket_transferred | Ingresso transferido |

Acessando os dados no workflow

Os dados ficam disponíveis em $json.data:

{{ $json.event }}                    → Nome do evento
{{ $json.data.customer.name }}       → Nome do cliente
{{ $json.data.customer.email }}      → Email do cliente
{{ $json.data.order.id }}            → ID do pedido (UUID)
{{ $json.data.order.refId }}         → Código do pedido
{{ $json.data.order.status }}        → Status do pedido
{{ $json.data.product.name }}        → Nome do produto
{{ $json.data.offer.name }}          → Nome da oferta
{{ $json.data.offer.price }}         → Preço da oferta
{{ $json.data.transaction.amount }}  → Valor da transação
{{ $json.data.transaction.paymentMethod }}  → Método de pagamento
{{ $json.data.metadata.utmSource }}  → UTM Source

Desenvolvimento

# Instalar dependências
npm install

# Compilar
npm run build

# Modo desenvolvimento (watch)
npm run dev

Licença

MIT