Zum Hauptinhalt springen

Einwilligung über Webhooks mit Ihrem CRM synchronisieren

Halten Sie die E-Mail-Marketing-Opt-ins Ihres CRM automatisch mit den ConsentForge-Einwilligungsentscheidungen synchronisiert.

Architektur​

Nutzer akzeptiert/lehnt Marketing ab → ConsentForge-Webhook → Ihr Backend → CRM-API

Schritt 1: Einen Webhook-Endpunkt erstellen​

Richten Sie auf Ihrem Backend einen Endpunkt ein, der die ConsentForge-Nutzlast verarbeitet:

// Express-Beispiel
app.post('/webhooks/consentforge', express.raw({ type: '*/*' }), async (req, res) => {
  // 1. Signatur überprüfen
  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. Nutzlast parsen
  const payload = JSON.parse(req.body);

  // 3. Nur Marketing-Einwilligungsereignisse verarbeiten
  if (['consent.created', 'consent.updated'].includes(payload.event)) {
    const hasMarketingConsent = payload.data.choices.marketing === true;

    // 4. CRM aktualisieren
    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 });
});

Schritt 2: Den Webhook in ConsentForge registrieren​

Eigenschaft → Webhooks → Endpunkt hinzufügen

  • URL: https://yourapp.com/webhooks/consentforge
  • Ereignisse: consent.created, consent.updated
  • Webhook-Secret kopieren

Schritt 3: CRM-Kontakt zuordnen​

Da ConsentForge gehashte Identifikatoren speichert (keine E-Mail-Adressen), benötigen Sie eine Möglichkeit, den Beleg mit einem CRM-Kontakt zu verknüpfen. Optionen:

  1. Eingeloggte Nutzer: Speichern Sie die ConsentForge-Beleg-ID beim Login im Nutzerdatensatz
  2. E-Mail-Formulare: Rufen Sie nach einer Formularübermittlung ConsentForge.getReceiptId() auf und speichern Sie die ID zusammen mit der E-Mail-Adresse

Siehe auch: Webhooks · Webhook-Sicherheit