Saltar al contenido principal

Sincronizar el consentimiento con su CRM mediante webhooks

Mantenga las opciones de opt-in de marketing por correo electrónico de su CRM sincronizadas automáticamente con las decisiones de consentimiento de ConsentForge.

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 maneje 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 maneje 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 → Agregar endpoint

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

Paso 3: Vincule el contacto del CRM​

Dado que ConsentForge almacena identificadores hasheados (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 del 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