Ir al contenido principal

Escaneos QR → HubSpot

Envíe eventos de escaneo y formularios de leads a HubSpot CRM usando webhooks firmados — no se requiere aplicación nativa.

Receta: Catch Hook → HubSpot

  1. Paso 1

    Cree un webhook de QRbanner

    Configuración → Webhooks → Añadir endpoint. Copie la URL y el secreto de firma.

  2. Paso 2

    Capture el hook en Zapier o Make

    Use Webhooks by Zapier (Catch Hook) o el webhook personalizado de Make. Pegue la URL de QRbanner.

  3. Paso 3

    Cree o actualice un contacto de HubSpot

    Asigne correo/nombre desde los payloads de leads, o cree una nota de línea de tiempo con país de escaneo, dispositivo y nombre del QR.

Campos útiles para HubSpot

  • Correo, nombre, teléfono y mensaje del lead (cuando el formulario de leads está habilitado)
  • Nombre del QR, código corto y categoría de campaña
  • Marca de tiempo del escaneo, país, ciudad, dispositivo
  • X-QRbanner-Signature para verificación HMAC antes de escribir en el CRM

JSON de ejemplo del webhook de escaneo

{
  "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

Asignación sugerida de campos de HubSpot

Webhook fieldHubSpot
qr_namenotes / deal name
short_codecustom property (optional)
scan.citycity
scan.countrycountry
scan.devicenotes (device)
scan.scanned_atlast activity date

Verificar X-QRbanner-Signature (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)
  );
}
Documentación completa de API y webhooks