Bookinda + n8n integráció

n8n egy nyílt forráskódú, self-hosted automation platform (mint a Zapier vagy Make, csak nálad fut és nem fizetsz tranzakcióért). Bookinda webhook-jaival ugyanúgy működik mint a többi.

Mikor érdemes n8n-t választani

• Adatvédelem: ha a customer adatok ne hagyják el a saját infrádat
• Volumen: ha sok eventet dolgozol fel és Zapier/Make havidíj > self-host költség
• Custom logic: n8n JavaScript node-ok (Function node, Code node) — bonyolultabb logikát tudsz írni mint Zapier-ben
• Integráció saját rendszerrel: közvetlen DB hozzáférés, internal API-k

Setup

1. n8n telepítés (ha még nincs)

# Docker, gyors módja
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Vagy production setup: https://docs.n8n.io/hosting/

2. n8n: új workflow + Webhook trigger node

1. + New workflow
2. Add node → Webhook (trigger)
3. HTTP Method: POST
4. Path: pl. /bookinda
5. Response Mode: Immediately (200 OK back, async processing)
6. Activate workflow (csak active workflow webhook URL-je él)
7. Másold a Production URL-t (pl. https://n8n.te.com/webhook/bookinda)

3. Bookinda oldalon: új végpont

1. Manager UI → Beállítások → Integrációk → Webhookok → + Új végpont
2. URL: n8n production URL
3. Események: amit szeretnél
4. Létrehozás

4. n8n: aláírás-ellenőrzés

A Webhook node ad neked headers + body-t. Add hozzá egy Code node-ot:

const crypto = require('crypto');
const SECRET = $env.BOOKINDA_WEBHOOK_SECRET; // n8n environment-ből

const sigHeader = $input.item.json.headers['x-bookinda-signature'];
const body = JSON.stringify($input.item.json.body);

const parts = Object.fromEntries(sigHeader.split(',').map(p => p.split('=')));
const t = parseInt(parts.t, 10);
const v1 = parts.v1;

// Replay window: 5 min
if (Math.abs(Math.floor(Date.now() / 1000) - t) > 300) {
  throw new Error('replay window expired');
}

const expected = crypto.createHmac('sha256', SECRET)
  .update(`${t}.${body}`)
  .digest('hex');

if (expected !== v1) {
  throw new Error('invalid signature');
}

return $input.item;

5. További n8n node-ok

• Switch node branch-elésre event-típus alapján
• Postgres / MySQL node — direkt DB-be írás
• HTTP Request node — bármilyen REST API hívás
• Email Send node — saját SMTP-vel email
• Slack node — Slack üzenet
• Code node — bármilyen JavaScript

Példa workflow

1. Webhook (Trigger) — Bookinda webhook
2. Code node — HMAC verify
3. Switch — branch event mező alapján
4. Branch appointment.created:
   • Postgres → INSERT INTO bookings ...
   • Slack → "Új foglalás: {{customer.firstName}}"
5. Branch customer.created:
   • HTTP Request → POST a saját CRM-edre
   • Email → "Új ügyfél" admin notification

Miért n8n vs Zapier/Make