Saltar al contenido principal

Sincronizar el consentimiento con su CRM mediante webhooks

Mantenga las suscripciones de email marketing de su CRM sincronizadas con las decisiones de consentimiento de ConsentForge automáticamente.

Arquitectura​

El usuario acepta/rechaza marketing → Webhook de ConsentForge → Su backend → API del CRM

Paso 1: Cree un endpoint de webhook​

Configure un endpoint en su backend que gestione el payload de ConsentForge:

// Ejemplo con Express
app.post('/webhooks/consentforge', express.raw({ type: '*/*' }), async (req, res) => {
  // 1. Verifique la firma
  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. Analice el payload
  const payload = JSON.parse(req.body);

  // 3. Solo gestione los eventos de consentimiento de marketing
  if (['consent.created', 'consent.updated'].includes(payload.event)) {
    const hasMarketingConsent = payload.data.choices.marketing === true;

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

Paso 2: Registre el webhook en ConsentForge​

Propiedad → Webhooks → Añadir endpoint

  • URL: https://suapp.com/webhooks/consentforge
  • Eventos: consent.created, consent.updated
  • Copie el secreto del webhook

Paso 3: Mapee el contacto del CRM​

Dado que ConsentForge almacena identificadores con hash (no correos electrónicos), necesita una forma de vincular el recibo a un contacto del CRM. Opciones:

  1. Usuarios con sesión iniciada: Almacene el ID de recibo de ConsentForge en el registro del usuario al iniciar sesión
  2. Formularios de correo electrónico: Después del envío de un formulario, llame a ConsentForge.getReceiptId() y almacénelo junto al correo electrónico

Véase también: Webhooks · Seguridad de webhooks