Webhooks

En Growth y Ultimate, Letlink envía JSON mediante POST a cada URL HTTPS registrada en el espacio de trabajo cuando se registra un clic. Los propietarios y administradores agregan o quitan URL en Integraciones → Webhooks. Los miembros pueden ver la lista, pero no pueden cambiarla.

Agregar un endpoint

1. Prepara una URL HTTPS que acepte POST con Content-Type: application/json. HTTP se rechaza.
2. Pégalo en Integraciones → Webhooks y guarda. El nombre del evento es link_visited.
3. Haz clic en uno de tus enlaces cortos (desde una red que no supere el límite mensual). Deberías ver una solicitud en unos segundos: la entrega se pone en cola, no ocurre durante la redirección.

También puedes suscribirte desde la API: POST /api/v1/hooks/subscribe con target_url y un event opcional (por defecto link_visited). Los REST Hooks de Zapier llaman a ese mismo par de rutas de suscripción y cancelación.

Payload

El cuerpo es el objeto de visita canónico. Los campos UTM o de tienda vacíos son null.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Cuando un webhook no se activa

• El espacio de trabajo está en Free o Solo (allowsWebhooks está desactivado).
• Ya se alcanzó el límite mensual de clics registrados: la redirección se produce, pero no se guarda ningún registro, así que no se envía nada.
• Un límite de visitas por dispositivo devolvió 429 antes de que se guardara un clic.
• Una regla de acceso por país rechazó al visitante. Las visitas bloqueadas nunca se guardan como clics.
• La URL de destino no responde. La entrega se hace en la medida de lo posible y nunca debe retrasar al visitante; los envíos fallidos no se reintentan desde esta página.

Quién recibe qué

Los hooks se guardan por usuario. Las URL link_visited de todos los miembros reciben avisos de los clics en cualquier enlace del espacio de trabajo. Si dos compañeros suscribieron Zapier, se ejecutan ambos Zaps. Elimina las URL que no uses para que un Catch Hook sobrante no siga activándose.