QR-Scans → HubSpot

Scan- und Lead-Formular-Events per signierten Webhooks in HubSpot CRM pushen — keine native App erforderlich.

Rezept: Catch Hook → HubSpot

Schritt 1
QRbanner-Webhook erstellen
Einstellungen → Webhooks → Endpunkt hinzufügen. URL und Signaturgeheimnis kopieren.
Schritt 2
Hook in Zapier oder Make abfangen
Webhooks by Zapier (Catch Hook) oder Makes Custom Webhook nutzen. QRbanner-URL einfügen.
Schritt 3
HubSpot-Kontakt erstellen oder aktualisieren
E-Mail/Name aus Lead-Payloads mappen oder Timeline-Notiz aus Scan-Land, Gerät und QR-Name erstellen.

Nützliche Felder für HubSpot

Lead-E-Mail, Name, Telefon und Nachricht (wenn Lead-Formular aktiviert)
QR-Name, Kurzcode und Kampagnenkategorie
Scan-Zeitstempel, Land, Stadt, Gerät
X-QRbanner-Signature zur HMAC-Verifizierung vor CRM-Schreibvorgang

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

Empfohlenes HubSpot-Feldmapping

Webhook field	HubSpot
qr_name	notes / deal name
short_code	custom property (optional)
scan.city	city
scan.country	country
scan.device	notes (device)
scan.scanned_at	last activity date

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 →