levvex

n8n community node for Levvex — receive webhook events from Levvex platform (purchases, subscriptions, miniapp, events)

Package Information

Downloads: 1,126 weekly / 1,126 monthly
Latest Version: 0.1.9

Available Nodes

Levvex icon
Levvex
Recebe webhooks da plataforma Levvex (compras, assinaturas, MiniApp, eventos)

Documentation

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

Discussion