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.

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
- 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.
- En QRplus, abre el QR desde «Mis QR» y ve a Ajustes › Integraciones.
- Activa la tarjeta «Webhook y API».
- Pega la dirección en «URL del webhook». Tiene que empezar por https://.
- 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.
- 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
- En la misma tarjeta, en «Clave de API», pulsa «Crear clave».
- Copia la clave en ese momento y guárdala en un sitio seguro. Por seguridad no se vuelve a enseñar.
- 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.