Como conectar o Nexo ao n8n

Como conectar o Nexo ao n8n

Se você usa (ou quer começar a usar) n8n para automatizar tarefas da escola, agora dá para o Nexo avisar seu n8n toda vez que acontecer algo importante: um aluno faltou, uma cobrança está próxima do vencimento (ou atrasada), um pagamento foi confirmado ou é aniversário de um aluno. A partir daí, o que você faz com essa informação é com você — mandar WhatsApp, gravar numa planilha, avisar no Slack, criar uma tarefa, o que precisar.

Em uma frase: em Admin → Webhooks, você cola a URL do seu n8n, escolhe quais eventos quer receber, e pronto — o Nexo passa a te avisar sozinho.

Passo 1 — Criar o Webhook no n8n

• No seu workflow do n8n, adicione um node Webhook.
• Método: POST.
• Copie a Test URL (para testar agora) ou a Production URL (depois de ativar o workflow) — as duas funcionam, mas só a de produção continua recebendo eventos com o workflow desativado da tela de edição.

Passo 2 — Configurar no Nexo

• Vá em Admin → Webhooks.
• Cole a URL do n8n no campo URL do endpoint.
• Marque os eventos que quer receber: Cobrança, Confirmação de pagamento, Aniversário e/ou Falta.
• Clique em Salvar.
• Clique em Gerar / rotacionar secret e copie o valor mostrado — ele some da tela depois e não tem como ver de novo (só gerar um novo).
• Ligue a chave Webhook ativo.

Pronto: a partir daqui, todo evento habilitado chega no seu n8n assim que acontece.

O que chega no n8n

Cada evento é um POST com este formato:

• event_type: absence, payment_reminder, payment_confirmation ou birthday.
• organization_id: identifica sua escola (útil se você reusa o mesmo workflow para mais de uma unidade).
• occurred_at: data/hora do evento.
• data: os detalhes — nome do aluno, telefone do responsável, valor, atividade, e um texto sugerido pronto (suggested_message) que você pode usar direto ou reescrever do seu jeito.

No n8n, esses campos chegam prontos no node do Webhook — é só usar {{$json.body.data.student_name}} e similares nos próximos nodes do seu fluxo.

Validando que o evento veio mesmo do Nexo (recomendado)

Todo POST chega com o header X-Nexo-Signature no formato ts=<timestamp>,v1=<assinatura>. A assinatura é um HMAC-SHA256 do corpo da requisição usando o secret que você gerou no Passo 2. Se quiser validar (recomendado antes de disparar ações sensíveis, como um envio de cobrança real), adicione um node Code no n8n que recalcula o HMAC com o mesmo secret e compara com o valor recebido — se não bater, descarte a requisição.

Ideias de automação

• Falta → node do WhatsApp (Evolution, Twilio, WhatsApp Business API) usando o suggested_message pronto.
• Cobrança → gravar numa planilha do Google Sheets para o time financeiro acompanhar, ou mandar um lembrete por e-mail.
• Confirmação de pagamento → avisar no Slack/Discord da equipe, ou disparar um card no seu CRM (veja o artigo Como integrar o Nexo com seu CRM).
• Aniversário → agendar um envio automático de mensagem de parabéns.

Perguntas comuns

Preciso ter o n8n na nuvem? Não — funciona com n8n Cloud ou self-hosted, desde que a URL do webhook seja acessível pela internet (https).

Posso desligar sem perder a configuração? Sim, a chave Webhook ativo em Admin → Webhooks liga e desliga sem apagar a URL nem os eventos escolhidos.

O que acontece se o meu n8n estiver fora do ar num momento? O Nexo tenta reenviar automaticamente (com espera crescente entre tentativas) por até 5 tentativas antes de desistir daquele evento específico.