Privacidad de leads y verificación de correo

Qué puedes hacer

Cuando un flipbook captura leads, puedes moldear dos partes de esa experiencia mediante la API:

• Privacidad / consentimiento — configura el texto y las opciones de privacidad/consentimiento de la captura de leads (por ejemplo, la casilla de consentimiento del RGPD), incluido un enlace a tu política de privacidad.
• Verificación de correo — activa o desactiva la verificación de correo del lead, exigiendo que los visitantes confirmen su correo antes de acceder.

Antes de empezar

Necesitarás:

• Una clave de API — se envía como el encabezado X-Api-Key o como Authorization: Bearer YOUR_API_KEY en cada solicitud.
• El {flipbookId} — el ID numérico del flipbook/documento. Lo devuelve create-by-file / create-by-url (como ID) o list. Ambos endpoints lo toman como un parámetro de ruta.
• Todas las solicitudes van a la URL base https://go.fliplink.me.

El cuerpo de la solicitud de ambos endpoints es form-urlencoded (no JSON).

Configura la privacidad y el consentimiento

PUT /api/set-lead-privacy/{flipbookId} configura el texto y las opciones de privacidad/consentimiento de la captura de leads (p. ej. la casilla de consentimiento del RGPD).

curl -X PUT 'https://go.fliplink.me/api/set-lead-privacy/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadPrivacyPolicy=false' \
  --data-urlencode 'PrivacyPolicyURL=' \
  --data-urlencode 'PrivacyPolicyText='

Respuesta:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Configura la verificación de correo

PUT /api/set-lead-verification/{flipbookId} activa o desactiva la verificación de correo del lead, exigiendo que los visitantes confirmen su correo antes de acceder.

curl -X PUT 'https://go.fliplink.me/api/set-lead-verification/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVerifyEmail=false' \
  --data-urlencode 'IsVerifyMobile=false' \
  --data-urlencode 'TwillioAPIKey=' \
  --data-urlencode 'EmailVerifyTitleText=' \
  --data-urlencode 'EmailVerifyButtonText='

Respuesta:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Errores posibles

• Clave de API ausente o no válida → HTTP 401. Esto devuelve una página HTML de "Unauthorized" sin formato — no hay cuerpo JSON. Comprueba que el encabezado X-Api-Key esté presente y sea correcto.
• ID del elemento no encontrado o no perteneciente a tu clave → HTTP 200 con Message Item not found.
• Campo del cuerpo desconocido o mal escrito → HTTP 200 con Message Unknown field(s) '…'. Expected: ….

Notas

• El campo TwillioAPIKey conserva la ortografía original Twillio — envíalo con ese nombre exacto.