Webhooks

Webhooks permitem que você receba notificações em tempo real quando seus links são clicados. Quando ocorre um clique, o Linkly envia uma solicitação POST para sua(s) URL(s) especificada(s) com informações detalhadas sobre o clique.

• Plataformas de Automação: Acione fluxos de trabalho no Make ou Zapier quando os links são clicados
• Análises Personalizadas: Envie dados de cliques para seu próprio sistema de análise
• Atualizações de CRM: Atualize registros de clientes quando eles clicam em links
• Notificações do Slack: Seja notificado no Slack quando links importantes são clicados
• Rastreamento de Leads: Rastreie quando prospects interagem com seus links

Dica: Para a maioria dos casos de uso de automação, nossa integração com Make ou integração com Zapier são mais fáceis de configurar do que webhooks personalizados. Eles incluem gatilhos de cliques instantâneos alimentados por webhooks, sem necessidade de código.

Nota: Se você configurar webhooks em ambos os níveis, ambos serão disparados para cliques nesse link.

Quando ocorre um clique, o Linkly envia uma solicitação POST com a seguinte carga 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 Privacidade: Endereços IP nunca são incluídos nas cargas de webhook.

Para uma configuração mais fácil sem codificação personalizada, use nossas integrações nativas:

• Integração com Make - Plataforma de automação visual com gatilhos de cliques instantâneos
• Integração com Zapier - Conecte o Linkly a milhares de aplicativos sem código

Ambas as integrações usam webhooks internamente, mas gerenciam toda a configuração automaticamente.

Você pode adicionar várias URLs de webhook (uma por linha). Todas as URLs receberão a mesma carga quando ocorrer um clique.

• Webhooks são fire-and-forget - O Linkly não tenta reenviar entregas falhadas
• Falhas de webhook nunca afetam o redirecionamento - os usuários sempre chegam ao seu destino
• Certifique-se de que seu endpoint de webhook responda rapidamente (< 5 segundos recomendado)

• Use endpoints HTTPS para URLs de webhook
• Valide solicitações recebidas em seu manipulador de webhook
• Considere adicionar um parâmetro secreto à sua URL de webhook para verificação

1. 1Configure uma URL de webhook usando um serviço como webhook.site ou RequestBin
2. 2Clique em seu link
3. 3Inspecione a carga recebida
4. 4Uma vez verificado, mude para sua URL de webhook de produção

Você também pode gerenciar webhooks programaticamente via 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

Consulte a Documentação da API para detalhes.