Ga naar hoofdinhoud

Toestemming synchroniseren naar uw CRM via webhooks

Houd de opt-ins voor e-mailmarketing in uw CRM automatisch gesynchroniseerd met ConsentForge-toestemmingsbeslissingen.

Architectuur​

Gebruiker accepteert/weigert marketing → ConsentForge-webhook → Uw backend → CRM API

Stap 1: Maak een webhook-eindpunt aan​

Stel een eindpunt op uw backend in dat de ConsentForge-payload verwerkt:

// Express-voorbeeld
app.post('/webhooks/consentforge', express.raw({ type: '*/*' }), async (req, res) => {
  // 1. Handtekening verifiëren
  const valid = verifyConsentForgeWebhook(
    req.body.toString(),
    req.headers['x-consentforge-signature'],
    req.headers['x-consentforge-timestamp'],
    process.env.CONSENTFORGE_WEBHOOK_SECRET
  );
  if (!valid) return res.status(401).send('Unauthorized');

  // 2. Payload verwerken
  const payload = JSON.parse(req.body);

  // 3. Alleen marketingtoestemmingsgebeurtenissen verwerken
  if (['consent.created', 'consent.updated'].includes(payload.event)) {
    const hasMarketingConsent = payload.data.choices.marketing === true;

    // 4. CRM bijwerken
    await updateCRMContact({
      ip_hash: payload.data.ip_hash,
      marketing_opt_in: hasMarketingConsent,
      consent_timestamp: payload.timestamp,
      receipt_id: payload.data.receipt_id,
    });
  }

  res.json({ received: true });
});

Stap 2: Registreer de webhook in ConsentForge​

Property → Webhooks → Eindpunt toevoegen

  • URL: https://uwapp.com/webhooks/consentforge
  • Gebeurtenissen: consent.created, consent.updated
  • Kopieer het webhookgeheim

Stap 3: CRM-contact koppelen​

Omdat ConsentForge gehashte identificatoren opslaat (geen e-mails), heeft u een manier nodig om de ontvangstbevestiging te koppelen aan een CRM-contact. Opties:

  1. Ingelogde gebruikers: Sla de ConsentForge-ontvangstbevestiging-ID op in het gebruikersrecord bij het inloggen
  2. E-mailformulieren: Roep na het indienen van een formulier ConsentForge.getReceiptId() aan en sla dit op naast het e-mailadres

Zie ook: Webhooks · Webhookbeveiliging