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 webhookEventos
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.