Webhook

I webhook ti permettono di ricevere notifiche in tempo reale quando i tuoi link vengono cliccati. Quando si verifica un clic, Linkly invia una richiesta POST all'URL specificato con informazioni dettagliate sul clic.

• Piattaforme di Automazione: Attiva flussi di lavoro in Make o Zapier quando i link vengono cliccati
• Analisi Personalizzate: Invia i dati dei clic al tuo sistema di analisi
• Aggiornamenti CRM: Aggiorna i record dei clienti quando cliccano sui link
• Notifiche Slack: Ricevi notifiche in Slack quando vengono cliccati link importanti
• Tracciamento Lead: Traccia quando i potenziali clienti interagiscono con i tuoi link

Suggerimento: Per la maggior parte dei casi d'uso di automazione, la nostra integrazione Make o integrazione Zapier sono più facili da configurare rispetto ai webhook personalizzati. Includono trigger di clic istantanei alimentati da webhook, senza necessità di codifica.

Nota: Se configuri i webhook a entrambi i livelli, entrambi si attiveranno per i clic su quel link.

Quando si verifica un clic, Linkly invia una richiesta POST con il seguente payload 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 sulla Privacy: Gli indirizzi IP non sono mai inclusi nei payload dei webhook.

Per una configurazione più semplice senza codifica personalizzata, usa le nostre integrazioni native:

• Integrazione Make - Piattaforma di automazione visuale con trigger di clic istantanei
• Integrazione Zapier - Connetti Linkly a migliaia di app senza codice

Entrambe le integrazioni utilizzano i webhook internamente ma gestiscono automaticamente tutta la configurazione.

Puoi aggiungere più URL di webhook (uno per riga). Tutti gli URL riceveranno lo stesso payload quando si verifica un clic.

• I webhook sono fire-and-forget - Linkly non riprova le consegne fallite
• Gli errori dei webhook non influenzano mai il reindirizzamento - gli utenti raggiungono sempre la loro destinazione
• Assicurati che il tuo endpoint webhook risponda rapidamente (< 5 secondi consigliati)

• Usa endpoint HTTPS per gli URL dei webhook
• Convalida le richieste in entrata nel tuo gestore di webhook
• Considera l'aggiunta di un parametro segreto all'URL del tuo webhook per la verifica

1. 1Configura un URL di webhook utilizzando un servizio come webhook.site o RequestBin
2. 2Clicca sul tuo link
3. 3Ispeziona il payload ricevuto
4. 4Una volta verificato, passa all'URL del tuo webhook di produzione

Puoi anche gestire i webhook in modo programmatico tramite l'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

Vedi la Documentazione API per i dettagli.