Pasar al contenido principal

Noticias · Guías ·

Webhook y API para códigos QR: conecta los escaneos a tu CRM

Recibe cada visita y cada clic de tu QR en tu CRM, Zapier o Make con un webhook, y lee las estadísticas desde tus herramientas con una clave de API.

Programador trabajando frente a pantallas de código y tarjetas con códigos QR

Un webhook y una API para códigos QR sirven para que los escaneos no se queden en un panel: el webhook avisa a tus sistemas en el momento de cada visita y cada clic, y la API te deja leer las estadísticas desde tus propias herramientas. En QRplus las dos cosas se activan en Ajustes › Integraciones › «Webhook y API», sin instalar nada.

Qué es cada cosa y cuándo conviene

  • Webhook. Es una dirección tuya a la que QRplus llama cada vez que pasa algo en tu QR. No tienes que preguntar: te llega solo. Es lo que usas para disparar una acción, como apuntar una fila en una hoja, mandar un mensaje a un canal del equipo o crear una actividad en el CRM.
  • API. Funciona al revés: es tu herramienta la que pregunta cuando quiere y recibe los eventos del QR. Es lo que usas para pintar tus propios informes o cuadros de mando.

Conviene cuando ya trabajas con un CRM, con herramientas de automatización como Zapier o Make, o con un cuadro de mando propio, y quieres que el QR sea una fuente de datos más. Si solo quieres mirar cuánta gente escanea, las estadísticas del editor, la exportación a CSV o el aviso por email son más sencillos.

Ejemplos de uso

  • Una empresa de eventos apunta en una hoja de cálculo cada escaneo de las acreditaciones, con su hora.
  • Una inmobiliaria usa una variante del QR para cada cartel de «Se vende» y recibe en su CRM qué cartel se ha escaneado.
  • Una agencia lee por la API las visitas de los QR de sus clientes y las enseña en su propio informe mensual.

Qué datos envía el webhook

El webhook recibe una petición POST con un JSON por cada visita y cada clic. Lleva la fecha y la hora, el tipo de evento (visita o clic), la dirección del QR, la variante que se escaneó, el bloque que se pulsó en los clics y datos generales del visitante: tipo de dispositivo, sistema, navegador, idioma y la web desde la que llegó.

No lleva cookies ni identificadores de la persona. Con el webhook sabes qué ha pasado y cuándo, no quién ha sido.

Cómo activar el webhook paso a paso

  1. Crea en tu herramienta la dirección que va a recibir los datos. En Zapier o Make es un disparador de tipo webhook, que te da una dirección; en un CRM o en un desarrollo propio, la que te indique tu técnico.
  2. En QRplus, abre el QR desde «Mis QR» y ve a Ajustes › Integraciones.
  3. Activa la tarjeta «Webhook y API».
  4. Pega la dirección en «URL del webhook». Tiene que empezar por https://.
  5. Pulsa «Enviar una prueba». QRplus manda un evento de prueba y te dice si se ha entregado o si tu dirección ha respondido con un error.
  6. Cuando la prueba llegue bien, termina de montar la automatización en tu herramienta con ese evento de ejemplo.

Cómo usar la clave de API

  1. En la misma tarjeta, en «Clave de API», pulsa «Crear clave».
  2. Copia la clave en ese momento y guárdala en un sitio seguro. Por seguridad no se vuelve a enseñar.
  3. En tu herramienta, pide las estadísticas a la API de QRplus mandando la clave en la cabecera X-Api-Key. La respuesta trae los eventos de visitas y clics del QR, con el historial de tu plan.

Si pierdes la clave o crees que alguien la ha visto, pulsa «Crear otra»: la anterior deja de valer al instante. La API admite hasta 120 peticiones por hora con cada clave, de sobra para refrescar un informe.

En qué plan está

El webhook y la API están en QRplus VIP. En los demás planes la tarjeta aparece con el candado. Cada QR tiene su propio webhook y su propia clave, así que se configuran en el QR que quieras conectar. Los precios están en las tarifas.

Consejos y dudas frecuentes

  • La prueba da error. Comprueba que la dirección empieza por https:// y que tu herramienta está escuchando. En Zapier y Make, el disparador tiene que estar activo o esperando datos.
  • Trata la clave como una contraseña. No la pegues en documentos compartidos ni en el código de una web pública.
  • Filtra en destino. El webhook envía tanto visitas como clics. Si solo te interesa uno de los dos, filtra por el tipo de evento en tu automatización.
  • Usa variantes para saber de dónde viene. Con una variante del QR por mesa, cartel o folleto, cada evento te dice desde qué soporte llegó.
  • No esperes datos personales. Para recoger el nombre o el email de quien visita, usa el formulario de contacto o la suscripción de tu página.

Con el webhook y la API, tu código QR deja de ser un cartel con una gráfica y pasa a formar parte de las herramientas con las que ya llevas el negocio.