Zum Hauptinhalt springen

QR-Scans → Zapier

Jeder Scan kann einen HTTP-POST-Webhook mit HMAC-Signaturverifizierung auslösen — perfekt für Zapier-Automatisierungen.

Setup in 3 Schritten

  1. Schritt 1

    Webhook in QRbanner erstellen

    Einstellungen → Webhooks → Endpunkt hinzufügen. Signaturgeheimnis kopieren.

  2. Schritt 2

    Zapier Webhooks by Zapier nutzen

    Zap mit Trigger „Catch Hook“ erstellen. QRbanner-Webhook-URL einfügen.

  3. Schritt 3

    Aktions-App verbinden

    Scan-Daten an Slack, Sheets, Mailchimp, HubSpot oder 5.000+ senden.

Webhook-Payload enthält

  • QR-Code-Name, Kurzcode und Kategorie
  • Scan-Zeitstempel, Gerät, Browser, Betriebssystem
  • Land und Stadt (wenn verfügbar)
  • Header X-QRbanner-Signature zur HMAC-Verifizierung

Beispiel Scan-Webhook JSON

{
  "event": "scan",
  "qr_code_id": "clxxx",
  "qr_name": "Summer Campaign",
  "short_code": "abc123",
  "scan": {
    "country": "US",
    "city": "New York",
    "device": "mobile",
    "browser": "Chrome",
    "os": "iOS",
    "scanned_at": "2026-07-10T12:00:00.000Z"
  }
}

Header: X-QRbanner-Signature

X-QRbanner-Signature prüfen (Node.js)

const crypto = require('crypto');

function verifyWebhook(body, signatureHeader, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signatureHeader),
    Buffer.from(expected)
  );
}
Vollständige API- & Webhook-Dokumentation