Webhooks: los clics en tus enlaces llegan solos a tu servidor

Lix.li envía un evento por cada clic directamente a tu URL mediante HTTP POST: en tiempo real, firmado con HMAC y con entrega fiable. Sin sondear la API constantemente: los datos llegan solos en el instante del clic.

Configurar un webhook Ver el formato de los datos

Tiempo real · firma HMAC · reintentos y registro de entregas

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

Para qué sirven los webhooks

Recibe los datos de cada clic al instante y construye tus propios flujos sobre ellos

Tiempo real

Los eventos llegan en el momento del clic. No hace falta sondear la API con un cron ni esperar actualizaciones.

Datos de cada clic

País, ciudad, dispositivo, sistema operativo, navegador, referer y marca de bot: todo lo que necesitas para tu propio análisis.

Seguridad de fábrica

Cada solicitud va firmada con HMAC usando tu propio secreto, así distingues sin esfuerzo los eventos reales de los falsos.

Entrega fiable

Si tu servidor no responde, la entrega se reintenta. Todos los intentos y estados quedan visibles en el registro de entregas.

Casos de uso

A dónde suelen enviarse los eventos de clic

Lix.li POST
Tu propio análisis o CRM

Guarda cada clic en tu propia base de datos o CRM y crea informes exactamente como los necesitas.

Lix.li POST
Notificaciones en el chat

Deja que un bot de Telegram, Slack o Discord te avise de los nuevos clics al instante, sin revisiones manuales.

Lix.li POST
Automatización

Lanza flujos en Zapier, Make o n8n: un evento de clic se convierte en el disparador de cualquier acción.

Qué llega en el webhook

El evento redirects.batch: un solo cuerpo agrupa un lote de clics de una ventana de tiempo

{ "delivery_id": "d_01HXY9F0…", "event_type": "redirects.batch", "sent_at": "2026-08-04T10:15:00Z", "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "e_9f86d0…", "link_id": 9053352, "datetime": "2026-08-04T10:14:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.me", "group_id": null, "is_bot": false } ] }

La IP del visitante no se incluye por defecto (son datos personales) y solo se añade si lo habilitas explícitamente para ese endpoint.

Qué puedes hacer con los webhooks

Configuración flexible, seguridad sólida y entrega predecible

Entrega de eventos por lotes

Los clics llegan agrupados (redirects.batch) en una ventana de tiempo, lo que ahorra solicitudes a tu servidor.

Alcance a tu medida

Todos los enlaces de la cuenta, un grupo concreto o un único enlace: recibe solo los eventos que necesitas.

Firma HMAC

Cada solicitud va firmada con tu secreto. Puedes regenerar el secreto cuando quieras.

Reintentos y desactivación automática

Si el servidor no responde, se reintenta el envío; un endpoint "muerto" se desactiva automáticamente.

Registro de entregas

Historial de todos los envíos con estados y cuerpo de la solicitud: útil para encontrar la causa si algo falla.

Envío de prueba (ping)

Comprueba la integración con un clic antes de recibir tráfico real: tu servidor recibirá un evento de prueba.

Datos ricos por evento

link_id, fecha y hora, país, ciudad, sistema operativo, dispositivo, navegador, referer y marca de bot en cada clic.

Privacidad por defecto

La IP no se envía hasta que la habilitas explícitamente para un endpoint concreto.

Probar gratis

Cómo configurar un webhook

Cinco pasos: de la URL de tu servidor a un flujo de eventos de clic en marcha

1
Crea un endpoint

Regístrate en Lix.li, abre la sección de Webhooks e indica la URL de tu servidor, donde Lix.li enviará los eventos de clic.

2
Elige el alcance

Decide de qué enlaces quieres recibir eventos: todos los de la cuenta, un grupo concreto o un único enlace.

3
Guarda el secreto de firma

Lix.li te entrega una clave secreta. Cada solicitud se firma con HMAC: compara la firma de la cabecera para confirmar que el evento viene realmente de Lix.li.

4
Envía una solicitud de prueba

Pulsa "Test" (ping) y comprueba que tu servidor acepta la solicitud y responde con un 2xx. Así validas la integración antes de recibir tráfico real.

5
Vigila el registro de entregas

En el registro se ven todos los envíos, sus estados y los reintentos. Si el servidor no responde, la entrega se reintenta y un endpoint "muerto" se desactiva automáticamente.

Configurar un webhook

Preguntas frecuentes sobre webhooks

Un webhook es una notificación HTTP que Lix.li envía por su cuenta a tu servidor cuando ocurre un evento. No necesitas sondear ninguna API: los datos llegan automáticamente en el momento del clic en tu enlace.
Los clics en tus enlaces cortos. Los eventos llegan en lotes (event_type = redirects.batch); cada clic incluye fecha y hora, país, ciudad, sistema operativo, dispositivo, navegador, referer y marca de bot.
JSON por HTTP POST. El cuerpo incluye campos de control (delivery_id, ventana de tiempo, count) y un array events con los datos de cada clic. Hay un ejemplo completo del cuerpo en esta página.
Cada solicitud va firmada con HMAC a partir de tu clave secreta: compara la firma de la cabecera con el cuerpo de la solicitud y descarta las falsificaciones. Puedes regenerar el secreto (rotación) cuando quieras.
La entrega se reintenta automáticamente. Si el endpoint no responde durante mucho tiempo, se desactiva temporalmente, y todos los intentos y sus estados quedan en el registro de entregas: ningún evento se pierde sin dejar rastro.
Sí. Puedes elegir el alcance: todos los enlaces de la cuenta, los de un grupo concreto o un único enlace. Así no llenas tu servidor de tráfico innecesario.
No por defecto, ya que son datos personales. La IP se incluye en los eventos solo si lo habilitas explícitamente en la configuración de ese endpoint.
Los webhooks están disponibles en el plan Premium. Regístrate y contrata Premium para conectar tu endpoint.

Construye integraciones sobre los eventos de clic

Configura un webhook en un par de minutos y recibe los datos de los clics justo donde los necesitas.

Los webhooks de Lix.li son una forma de recibir notificaciones de clics en tus enlaces cortos de manera automática. En lugar de sondear una API constantemente, indicas la URL de tu servidor y Lix.li envía ahí un HTTP POST en el instante del clic. Es el clásico HTTP callback para enlaces cortos, que hace llegar los eventos de clic a tu sistema en tiempo real.

Cada cuerpo de solicitud es un evento redirects.batch con un array de clics: cada uno incluye fecha y hora, país, ciudad, navegador, sistema operativo, dispositivo, referer y marca de bot. Es fácil volcar esos datos en tu propia base de datos o CRM, convertirlos en notificaciones de clics en Telegram, Slack o Discord, o usarlos como disparador en Zapier, Make y n8n. Las solicitudes están protegidas con firma HMAC: comparas la firma de la cabecera y descartas las falsificaciones, y puedes regenerar el secreto cuando lo necesites.

La entrega es predecible: si el servidor falla, los eventos se reintentan, un endpoint "muerto" se desactiva temporalmente y todos los intentos quedan visibles en el registro de entregas. Puedes limitar el alcance a todos los enlaces, a un grupo o a uno solo, y validar la integración con un envío de prueba (ping) antes de recibir tráfico real. Los webhooks funcionan junto a los enlaces cortos de Lix.li, los códigos QR y las estadísticas, y están disponibles en el plan Premium.

Configurar un webhook