Webhookok

A Beállítások → Webhookok oldalon (admin és menedzser) regisztrálhatsz egy saját URL-t, ami HTTP POST-ot kap egy-egy esemény bekövetkeztekor - így a saját CRM-edben vagy egyéb rendszeredben azonnal reagálhatsz.

Esemény-típusok

• `analysis.completed` - amikor egy hívás elemzése elkészült.
• `recording.failed` - amikor egy felvétel feldolgozása véglegesen sikertelen volt.
• Minden webhook aktiválható/deaktiválható a Beállítások oldalon, anélkül hogy törölni kellene.
• Egy sikertelen kézbesítés (pl. a célszerver nem válaszol) nem blokkolja a hívás feldolgozását - a webhook-küldés egy különálló, saját maga is naplózott lépés.

A kiküldött payload felépítése

{
  "event": "analysis.completed",
  "delivery_id": "...",
  "timestamp": "2026-08-15T10:00:00.000Z",
  "data": {
    "recordingId": "...",
    "organizationId": "...",
    "totalScore": 82
  }
}

`recording.failed` esemény esetén a `data` mező más mezőket tartalmaz: itt egy `errorMessage` szöveg írja le, mi hiúsította meg a feldolgozást.

A teljes átiratot és a részletes visszajelzést a payload nem tartalmazza - azt az API-n keresztül kérheted le.

Aláírás ellenőrzése

Minden kiküldött kérés HMAC-SHA256-tal alá van írva - az `X-SalesElit-Signature` fejléc a nyers (nem újra-szerializált) JSON body aláírását hordozza `sha256=<hex>` formában, a webhook létrehozásakor (vagy újragenerálásakor) egyszer megjelenő titokkal számolva.

Példa: aláírás ellenőrzése Node.js-ben

const crypto = require('crypto')

const expected = 'sha256=' + crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(rawRequestBody)
  .digest('hex')

const valid = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers['x-saleselit-signature'])
)