Para desarrolladores · beta, gratis para todos

Webhooks para
enlaces cortos

Creas un enlace o alguien lo visita, y tu URL recibe un POST con los datos del evento. Es una solicitud normal, sin autorización.

Conexión

Cómo añadir un webhook

Un webhook tiene un evento y una URL. Puedes añadir varios webhooks. Crea enlaces en la página de inicio, en tu panel o con la API.

Añadir un webhook

Eventos

Cuándo llega la solicitud

link.created

Creaste un enlace corto. El payload trae todos sus campos.

link.visited

Alguien abrió el enlace. El payload trae los datos de la visita.

Formato

Qué llega a tu URL

Un POST en formato form-urlencoded, sin autorización. Son cuatro campos. Los datos del evento van como cadena JSON en data[payload].

event          link.created o link.visited
ts             hora del evento, Unix timestamp
data[id]       id del enlace (link.created) o de la visita (link.visited)
data[payload]  cadena JSON con los campos del enlace o de la visita

Ejemplo de payload para link.created

{
  "id": 126,
  "destination_url": "https://example.com/page",
  "default_short_url": "https://lnk.ua/XHxu0jKaP",
  "url_key": "XHxu0jKaP",
  "created_at": "2026-11-16T13:57:30.000000Z"
}

Ejemplo de payload para link.visited

{
  "id": 106,
  "short_url_id": 126,
  "visited_at": "2026-11-16T13:57:30.000000Z",
  "ip_address": "203.0.113.7",
  "operating_system": "OS X",
  "browser": "Chrome",
  "browser_version": "120",
  "device_type": "desktop",
  "referer_url": "https://t.me/"
}

Entrega

Responde con 200

Con un HTTP 200 la solicitud cuenta como entregada. Ante cualquier otra respuesta repetimos la solicitud unas cuantas veces más.

Responde enseguida

link.visited llega con cada visita, también con las de bots. En un enlace con mucho tráfico habrá muchas solicitudes, así que procesa los datos después de responder.

Preguntas frecuentes

Los webhooks forman parte de PRO. Mientras dure la beta son gratis para todos. Consulta los precios.

La solicitud no lleva firma. Añade un secreto a la URL del webhook, por ejemplo https://example.com/hook?secret=abc123, y compáralo en tu servidor. Rechaza las solicitudes que traigan otro secreto.

En form-urlencoded todos los valores se convierten en cadenas y los vacíos se pierden. En una cadena JSON un número sigue siendo un número y null sigue siendo null. Lee la cadena como JSON; en PHP se hace con json_decode.

Sí, link.visited llega con cada visita y no filtramos los bots. Si te estorban, fíltralos en tu servidor: el payload trae la IP, el navegador y el tipo de dispositivo.

Sí. Añade varios webhooks con ese evento y dale a cada uno su URL.

Elimínalo en tu panel, en «Configuración → Webhooks». Si lo necesitas otra vez, añádelo de nuevo.

Añade tu primer webhook

Añadir un webhook