Webhooks

Los webhooks te permiten recibir notificaciones en tiempo real cuando se hace clic en tus enlaces. Cuando ocurre un clic, Linkly envía una solicitud POST a tu(s) URL(s) especificada(s) con información detallada sobre el clic.

• Plataformas de Automatización: Activa flujos de trabajo en Make o Zapier cuando se hace clic en los enlaces
• Analíticas Personalizadas: Envía datos de clics a tu propio sistema de analíticas
• Actualizaciones de CRM: Actualiza registros de clientes cuando hacen clic en enlaces
• Notificaciones de Slack: Recibe notificaciones en Slack cuando se hace clic en enlaces importantes
• Seguimiento de Leads: Rastrea cuando los prospectos interactúan con tus enlaces

Consejo: Para la mayoría de los casos de uso de automatización, nuestra integración con Make o integración con Zapier son más fáciles de configurar que los webhooks personalizados. Incluyen activadores de clic instantáneos impulsados por webhooks, sin necesidad de código.

Nota: Si configuras webhooks en ambos niveles, ambos se activarán para los clics en ese enlace.

Cuando ocurre un clic, Linkly envía una solicitud POST con la siguiente carga útil JSON:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Nota de Privacidad: Las direcciones IP nunca se incluyen en las cargas útiles de los webhooks.

Para una configuración más fácil sin codificación personalizada, usa nuestras integraciones nativas:

• Integración con Make - Plataforma de automatización visual con activadores de clic instantáneos
• Integración con Zapier - Conecta Linkly a miles de aplicaciones sin código

Ambas integraciones usan webhooks internamente pero manejan toda la configuración automáticamente.

Puedes agregar múltiples URLs de webhook (una por línea). Todas las URLs recibirán la misma carga útil cuando ocurra un clic.

• Los webhooks son de disparar y olvidar - Linkly no reintenta entregas fallidas
• Las fallas de webhooks nunca afectan la redirección - los usuarios siempre llegan a su destino
• Asegúrate de que tu endpoint de webhook responda rápidamente (< 5 segundos recomendado)

• Usa endpoints HTTPS para las URLs de webhook
• Valida las solicitudes entrantes en tu manejador de webhook
• Considera agregar un parámetro secreto a tu URL de webhook para verificación

1. 1Configura una URL de webhook usando un servicio como webhook.site o RequestBin
2. 2Haz clic en tu enlace
3. 3Inspecciona la carga útil recibida
4. 4Una vez verificada, cambia a tu URL de webhook de producción

También puedes gestionar webhooks programáticamente a través de la API:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

Consulta la Documentación de la API para más detalles.