Skip to main content
Los webhooks son la opción genérica para llevar datos de Scanova a tus propios sistemas: eliges un flujo de datos, le das a Scanova una URL de endpoint, y este hace un POST de esos datos a tu servidor en tiempo real conforme ocurren los eventos — sin ninguna app de terceros de por medio.

​
Requisitos previos

  • Un endpoint HTTPS (o HTTP) que acepte peticiones POST y devuelva un código de estado 2xx para confirmar la recepción.
  • Si planeas enviar datos de leads: al menos una lista de leads o un formulario del Form-builder ya configurado como fuente.

​
Configurar un webhook

Los webhooks se abren como una página completa propia (no como un panel lateral).
1

Abrir la integración de Webhooks

Desde Integrations, selecciona Add Integration, busca la tarjeta de Webhooks y selecciona Setup.
2

Elegir los datos a enviar

Selecciona una de las siguientes opciones:
  • Scan Analytics Data — eventos de escaneo de tus códigos QR.
  • Event Tracking Data — datos personalizados de seguimiento de eventos.
  • Lead List Data — respuestas de formularios o listas de leads.
3

Elegir una fuente (solo para Lead List Data)

Si elegiste Lead List Data, selecciona también de qué lista de leads o formulario del Form-builder deben provenir las respuestas.
4

Introducir la URL del endpoint

Introduce la URL completa https:// (o http://) a la que Scanova debe hacer el POST. Selecciona Add another URL para enviar el mismo payload hasta a 5 endpoints en total.
5

Crear el webhook

Selecciona Create webhook. Scanova empieza a hacer POST de los eventos coincidentes a cada URL configurada tan pronto como ocurren.
Scanova hace POST de los payloads de eventos a tu endpoint en tiempo real. Tu endpoint debe devolver una respuesta 2xx para confirmar la recepción — una respuesta que no sea 2xx no provoca un reintento automático.

​
Editar un webhook existente

Abrir un webhook desde Active Connections vuelve a abrir el mismo formulario, ya prellenado. Dado que el modelo de lectura solo expone una URL resuelta por conexión, al editar se muestra un único campo de URL incluso si la configuración original tenía más de una.

​
Qué datos fluyen y hacia dónde

Según el tipo de datos elegido, Scanova envía eventos de escaneo, eventos de seguimiento o respuestas de leads/formularios como un payload JSON a cada URL de endpoint configurada, tan pronto como ocurre el evento subyacente.

​
Relacionado

  • Slack — una integración similar basada en eventos, limitada específicamente a canales de Slack.
  • Zapier — enruta el mismo tipo de datos de eventos a través del catálogo de apps de Zapier en lugar de una URL directa.
  • Google Analytics (GA4) — otra integración de salida de datos del lado del servidor para datos de escaneo/eventos.
  • Management API overview — obtén los mismos datos en tu propio horario en lugar de recibir eventos push.