Webhooks

Webhooks stellen u in staat om real-time meldingen te ontvangen over uw links — zowel wanneer ze worden aangeklikt als wanneer ze worden gemaakt, bijgewerkt of verwijderd. Linkly stuurt een POST-verzoek naar uw opgegeven URL('s) met gedetailleerde informatie over elk event.

Gebruiksscenario's

  • Automatiseringsplatforms: Workflows activeren in Make of Zapier wanneer links worden aangeklikt
  • Aangepaste analytica: Klikgegevens naar uw eigen analysesysteem sturen
  • CRM-updates: Klantgegevens bijwerken wanneer ze op links klikken
  • Slack-meldingen: Ontvang meldingen in Slack wanneer belangrijke links worden aangeklikt
  • Lead-tracking: Volg wanneer prospects met uw links omgaan

Tip: Voor de meeste automatiseringsgebruiksscenario's zijn onze Make-integratie of Zapier-integratie eenvoudiger in te stellen dan aangepaste webhooks. Ze bevatten directe klik-triggers aangedreven door webhooks, zonder code nodig.

Webhooks op linkniveau instellen

1
2

Scroll omlaag naar de sectie Webhooks.

3

Voer uw webhook-URL('s) in, één per regel.

U kunt meerdere webhook-URL's toevoegen. Alle URL's ontvangen dezelfde payload wanneer op de link wordt geklikt.

Voer uw webhook-URL('s) in, één per regel.
Voer uw webhook-URL('s) in, één per regel.
4

Klik Opslaan.

Webhooks op linkniveau worden alleen geactiveerd wanneer op die specifieke link wordt geklikt.

Webhooks op workspace-niveau instellen

1

Ga naar Instellingen (tandwiel in de zijbalk).

2

Klik op Workspace-instellingen

3

Voer uw webhook-URL('s) in, één per regel.

U kunt meerdere webhook-URL's toevoegen. Alle URL's ontvangen dezelfde payload wanneer op een willekeurige link in uw workspace wordt geklikt.

Voer uw webhook-URL('s) in, één per regel.
Voer uw webhook-URL('s) in, één per regel.
4

Klik Instellingen opslaan.

Webhooks op workspace-niveau worden geactiveerd voor elke klik op een willekeurige link in uw workspace.

Opmerking: Als u webhooks op beide niveaus configureert, worden beide geactiveerd voor klikken op die link.

Events

Elke webhook ontvangt alle event-typen voor zijn bereik — een webhook op linkniveau ontvangt events voor die link, een webhook op workspace-niveau ontvangt events voor elke link in de workspace. Controleer het veld event op het hoogste niveau om ze van elkaar te onderscheiden:

eventVerzonden wanneer
clickEr wordt op een korte link geklikt. Bevat een click-object met de verzoekgegevens van de bezoeker.
link.createdEr wordt een nieuwe link in de workspace gemaakt.
link.updatedDe instellingen van een link veranderen. Wordt bij elke update geactiveerd, inclusief automatisch opgeslagen bewerkingen, dus u kunt er meerdere per bewerkingssessie ontvangen.
link.deletedEen link wordt verwijderd. Het link-object behoud de slug en het domein die het voor verwijdering had.

Webhook-payload

Click-payload

Wanneer er een klik optreedt, stuurt Linkly een POST-verzoek met de volgende JSON-payload:

{
  "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",
    "metadata": {
      "order_id": "A-10293",
      "crm_contact_id": "3f2b8c1e-9a47-4d0e-b6a5-1c2d3e4f5a6b"
    },
    "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": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "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"
    }
  }
}

Payload-velden

Event-info

VeldBeschrijving
eventclick, link.created, link.updated, of link.deleted
timestampISO 8601-tijdstempel van de klik
VeldBeschrijving
idUnieke link-identifier
nameLink-bijnaam
urlOriginele doel-URL
full_urlDe korte link-URL
domainAangepast domein (indien geconfigureerd)
slugURL-pad/slug
metadataUw eigen sleutel-waarde-gegevens die aan de link zijn gekoppeld, bijvoorbeeld ID's uit uw eigen systeem. Altijd een object, leeg als er geen is ingesteld. Zie link-metadata
destinationWerkelijk doel voor deze klik (kan verschillen van url als regels werden toegepast)
workspace_idWorkspace-identifier
enabledOf link actief is
rulesArray van omleidingsregels (geo, apparaat, rotator)
utm_*UTM-parameters indien geconfigureerd
og_*Open Graph-instellingen indien geconfigureerd

Click-object

VeldBeschrijving
idUnieke identifier voor deze klik, een 26-teken ULID. De voorloopkarakters coderen de klijktijd, dus id's worden chronologisch gesorteerd als gewone tekenreeksen
countryLandcode met twee letters (bijv. "US", "GB")
is_eu_countryOf klik afkomstig is uit EU
platformApparaatplatform (desktop, ios, android, enz.)
browser_nameBrowsernaam (Chrome, Safari, Firefox, enz.)
refererVerwijzings-URL (indien beschikbaar)
ispInternet Service Provider
bot_nameBot-identifier (null voor menselijke klikken)
destinationUiteindelijke doel-URL voor deze klik
paramsQuery-parameters doorgegeven aan de link

Privacyopmerking: IP-adressen zijn nooit opgenomen in webhook-payloads.

De link.created-, link.updated- en link.deleted-events delen één vorm. Er is geen click-object — u krijgt de event, een timestamp en de volledige link:

{
  "event": "link.created",
  "timestamp": "2026-06-20T10: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",
    "workspace_id": 1,
    "enabled": true,
    "metadata": {
      "order_id": "A-10293"
    },
    "rules": []
  }
}

Automatiseringsplatform-integraties

Voor eenvoudigere setup zonder aangepaste code, gebruik onze native integraties:

Beide integraties gebruiken webhooks onder de motorkap, maar behandelen alle setup automatisch.

Best practices

Meerdere webhooks

U kunt meerdere webhook-URL's toevoegen (één per regel). Alle URL's ontvangen dezelfde payload wanneer er een klik optreedt.

Foutafhandeling

  • Webhooks zijn fire-and-forget - Linkly voert geen nieuwe pogingen uit voor mislukte leveringen
  • Webhook-fouten hebben nooit invloed op de omleiding - gebruikers bereiken altijd hun bestemming
  • Zorg ervoor dat uw webhook-eindpunt snel reageert (< 5 seconden aanbevolen)

Beveiliging

  • Gebruik HTTPS-eindpunten voor webhook-URL's
  • Valideer inkomende verzoeken in uw webhook-handler
  • Overweeg een geheim parameter aan uw webhook-URL toe te voegen voor verificatie

Testen

  1. 1
    Stel een webhook-URL in met behulp van een service als webhook.site of RequestBin
  2. 2
    Klik op uw link
  3. 3
    Inspecteer de ontvangen payload
  4. 4
    Schakel na verificatie over naar uw production webhook-URL

API-toegang

U kunt webhooks ook programmatisch beheren via de 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

Zie de API-documentatie voor details.

Webhooks FAQ's

Welke events kunnen webhooks verzenden?

Webhooks worden geactiveerd op vier events, geïdentificeerd door het event-veld in de payload. U krijgt click wanneer op een link wordt geklikt, plus link.created, link.updated en link.deleted wanneer links veranderen. Elke webhook ontvangt alle event-typen voor zijn bereik, dus vertakt u op het event-veld om elk ervan af te handelen.

Waarom worden mijn webhooks niet geactiveerd?

Controleer of uw webhook-URL geldig en toegankelijk is, en of webhooks op de link of workspace zijn opgeslagen. Voor click-events moet u er rekening mee houden dat webhooks alleen worden geactiveerd wanneer een klik daadwerkelijk wordt geregistreerd - uitgesloten IP's of overgeslagen crawlers activeren deze niet.

Waarom zijn sommige velden null in de webhook-payload?

Sommige velden kunnen null zijn als de informatie niet beschikbaar was (bijv. geen referer), privacyinstellingen verzameling voorkwamen, of de klik afkomstig was van een bot (in welk geval bot_name zal worden ingevuld in plaats daarvan).

Voert Linkly opnieuw pogingen uit voor mislukte webhook-leveringen?

Nee. Webhooks zijn fire-and-forget. Mislukte leveringen worden niet opnieuw geprobeerd en Linkly volgt de bezorgingsstatus van webhooks niet. Webhook-verzoeken verlopen na 5 seconden.

Ondersteunt Linkly postbacks voor conversie-tracking?

Nee. Linkly-webhooks zijn alleen uitgaand en worden geactiveerd wanneer klikken optreden. We kunnen geen postback-gegevens van affiliate-netwerken of advertentieplatforms ontvangen. Voor conversie-tracking gebruikt u de native tracking van het doelplatform, geeft u een klik-ID door via doorsturen van queryparameters, of gebruikt u onze BigQuery-integratie om klikgegevens met uw conversiegegevens te combineren.

Moet ik webhooks of Make/Zapier gebruiken?

Voor de meeste automatiseringsgebruiksscenario's zijn onze Make- of Zapier-integraties eenvoudiger in te stellen. Ze gebruiken webhooks onder de motorkap, maar behandelen alle configuratie automatisch. Gebruik aangepaste webhooks wanneer u gegevens naar uw eigen systemen wilt sturen of meer controle over de integratie nodig hebt.

Ja. Als u webhooks op beide niveaus configureert, worden beide geactiveerd wanneer op die link wordt geklikt. Dit is nuttig als u workspace-brede registratie plus specifieke acties voor bepaalde links wilt.

Wie kan webhooks instellen?

Webhooks op een enkele koppeling vereisen de Write-rol of hoger. Workspace-webhooks vereisen de Admin- of Eigenaarsrol. Zie gebruikersfuncties en machtigingen.

Beschikbaarheid per plan

Beschikbaar vanaf Business

Plannen vergelijken →

Track 500 maandelijkse klikken gratis.