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
Ga naar Links en klik op de link die u wilt configureren.
Scroll omlaag naar de sectie Webhooks.
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.

Klik Opslaan.
Webhooks op linkniveau worden alleen geactiveerd wanneer op die specifieke link wordt geklikt.
Webhooks op workspace-niveau instellen
Ga naar Instellingen (tandwiel in de zijbalk).
Klik op Workspace-instellingen
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.

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:
event | Verzonden wanneer |
|---|---|
click | Er wordt op een korte link geklikt. Bevat een click-object met de verzoekgegevens van de bezoeker. |
link.created | Er wordt een nieuwe link in de workspace gemaakt. |
link.updated | De instellingen van een link veranderen. Wordt bij elke update geactiveerd, inclusief automatisch opgeslagen bewerkingen, dus u kunt er meerdere per bewerkingssessie ontvangen. |
link.deleted | Een 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
| Veld | Beschrijving |
|---|---|
event | click, link.created, link.updated, of link.deleted |
timestamp | ISO 8601-tijdstempel van de klik |
Link-object
| Veld | Beschrijving |
|---|---|
id | Unieke link-identifier |
name | Link-bijnaam |
url | Originele doel-URL |
full_url | De korte link-URL |
domain | Aangepast domein (indien geconfigureerd) |
slug | URL-pad/slug |
metadata | Uw 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 |
destination | Werkelijk doel voor deze klik (kan verschillen van url als regels werden toegepast) |
workspace_id | Workspace-identifier |
enabled | Of link actief is |
rules | Array van omleidingsregels (geo, apparaat, rotator) |
utm_* | UTM-parameters indien geconfigureerd |
og_* | Open Graph-instellingen indien geconfigureerd |
Click-object
| Veld | Beschrijving |
|---|---|
id | Unieke identifier voor deze klik, een 26-teken ULID. De voorloopkarakters coderen de klijktijd, dus id's worden chronologisch gesorteerd als gewone tekenreeksen |
country | Landcode met twee letters (bijv. "US", "GB") |
is_eu_country | Of klik afkomstig is uit EU |
platform | Apparaatplatform (desktop, ios, android, enz.) |
browser_name | Browsernaam (Chrome, Safari, Firefox, enz.) |
referer | Verwijzings-URL (indien beschikbaar) |
isp | Internet Service Provider |
bot_name | Bot-identifier (null voor menselijke klikken) |
destination | Uiteindelijke doel-URL voor deze klik |
params | Query-parameters doorgegeven aan de link |
Privacyopmerking: IP-adressen zijn nooit opgenomen in webhook-payloads.
Link lifecycle-payload
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:
- Make-integratie - Visueel automatiseringsplatform met directe klik-triggers
- Zapier-integratie - Verbind Linkly met duizenden apps zonder code
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
- 1Stel een webhook-URL in met behulp van een service als webhook.site of RequestBin
- 2Klik op uw link
- 3Inspecteer de ontvangen payload
- 4Schakel 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.
Kan ik webhooks op zowel een link als de workspace hebben?
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
Track 500 maandelijkse klikken gratis.