Webhooks

Automatiseer je workflow door realtime meldingen te ontvangen wanneer gebeurtenissen plaatsvinden in penr.ai.

Overzicht

Webhooks stellen je in staat om penr.ai te integreren met externe services door HTTP POST-verzoeken te versturen wanneer specifieke gebeurtenissen plaatsvinden.

Ondersteunde gebeurtenissen

Gebeurtenis	Beschrijving
Content aangemaakt	Wanneer nieuwe content wordt gegenereerd of geïmporteerd
Content bijgewerkt	Wanneer content wordt bewerkt en opgeslagen
Content gepubliceerd	Wanneer content naar een site wordt gepubliceerd
Content gepland	Wanneer content wordt gepland voor toekomstige publicatie
Zoekwoord aangemaakt	Wanneer een nieuw zoekwoord wordt ontdekt of toegevoegd
Zoekwoord goedgekeurd	Wanneer een zoekwoord naar goedgekeurde status wordt verplaatst
Site verbonden	Wanneer een nieuwe site wordt verbonden

Een webhook maken

1. Navigeer naar Instellingen > Webhooks
2. Klik op Webhook maken
3. Configureer je webhook:
   • Naam: Een beschrijvende naam voor deze webhook
   • URL: Het eindpunt dat de POST-verzoeken zal ontvangen
   • Gebeurtenissen: Selecteer welke gebeurtenissen deze webhook moeten activeren
4. Klik op Opslaan

Er wordt automatisch een ondertekeningsgeheim gegenereerd voor beveiliging.

Webhook configuratie

Ondertekeningsgeheim

Elke webhook heeft een uniek ondertekeningsgeheim dat wordt gebruikt om te verifiëren dat verzoeken authentiek zijn. Het geheim wordt gebruikt om een HMAC-SHA256 handtekening te genereren die in de request headers wordt opgenomen.

Om een geheim te regenereren:

1. Open de webhook-instellingen
2. Klik op Geheim regenereren
3. Werk je ontvangende eindpunt bij met het nieuwe geheim

Actief/Inactief schakelaar

Je kunt een webhook tijdelijk uitschakelen zonder deze te verwijderen. Inactieve webhooks versturen geen verzoeken.

Webhooks testen

Klik op Testen bij elke webhook om een testpayload naar je eindpunt te versturen. Dit helpt verifiëren dat je integratie correct werkt.

Webhook logs

Bekijk de aflevergeschiedenis voor elke webhook:

• Laatste 10 afleveringen weergegeven
• Statusindicator: Groen (succes) of Rood (mislukt)
• Gebeurtenistype: Welke gebeurtenis de aflevering heeft geactiveerd
• HTTP-status: Responscode van je eindpunt
• Duur: Hoe lang het verzoek duurde (in milliseconden)
• Tijdstip: Wanneer de aflevering plaatsvond

Webhook handtekeningen verifiëren

Om te verifiëren dat een webhook-verzoek authentiek is:

1. Haal de handtekening uit de X-Webhook-Signature header
2. Bereken de HMAC-SHA256 hash van de request body met je ondertekeningsgeheim
3. Vergelijk de berekende hash met de handtekening

Voorbeeld (Node.js):

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const hash = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return hash === signature;
}

Best practices

• Verifieer altijd handtekeningen om te verzekeren dat verzoeken van penr.ai komen
• Reageer snel (binnen 5 seconden) om timeouts te vermijden
• Retourneer een 2xx status om succesvolle ontvangst aan te geven
• Behandel duplicaten graceful - dezelfde gebeurtenis kan meerdere keren worden verstuurd
• Gebruik HTTPS-eindpunten voor beveiliging