Guía de integración

Inicio rápido

BotFlush se integra en tres pasos: cargar el widget, renderizarlo y verificar los tokens en el servidor.

1. Cargar widget

Añada el script del widget a la página. Carga de forma asíncrona y no bloquea el renderizado.

<script src="https://challenge.botflush.com/widget.js" async defer></script>

2. Añadir contenedor

Coloque un contenedor donde quiera mostrar el CAPTCHA.

<div id="bf-captcha" data-sitekey="YOUR_SITE_KEY"></div>

3. Verificar en servidor

Al completar el reto se genera un token. Envíelo al servidor y verifíquelo por API.

POST https://challenge.botflush.com/api/siteverify
Content-Type: application/json

{
  "secret": "YOUR_SECRET_KEY",
  "token": "TOKEN_FROM_CLIENT"
}

JavaScript API

BotFlush.render()

BotFlush.render('bf-captcha', {
  siteKey: 'YOUR_SITE_KEY',
  callback: function(token) {
    console.log('Verified:', token);
  }
});

BotFlush.reset()

BotFlush.reset();

BotFlush.getResponse()

var token = BotFlush.getResponse();

Notas de migración

BotFlush admite patrones familiares de widget y siteverify. Empiece por cambiar URL del script, claves y endpoint; pruebe callbacks y manejo de errores antes del despliegue.

<!-- Before -->
<script src="https://www.google.com/recaptcha/api.js"></script>
<div class="g-recaptcha" data-sitekey="GOOGLE_KEY"></div>

<!-- After -->
<script src="https://challenge.botflush.com/widget.js"></script>
<div class="g-recaptcha" data-sitekey="BOTFLUSH_KEY"></div>

Controles de privacidad

BotFlush is designed around minimized data use, account-level controls, and enterprise review workflows. The console remains the source of truth for currently available privacy and data controls.

Modos de verificación

BotFlush ofrece varios motores de reto. Configure los motores permitidos por sitio en la consola.

Verificación del servidor

Node.js

const res = await fetch('https://challenge.botflush.com/api/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ secret, token })
});

Python

resp = requests.post('https://challenge.botflush.com/api/siteverify', json={
    'secret': BOTFLUSH_SECRET,
    'token': token
})

Go

resp, _ := http.Post("https://challenge.botflush.com/api/siteverify",
    "application/json", bytes.NewBuffer(payload))

Descargas

Node Inspector — extensión de Chrome

Instalación: Descargue y descomprima, abra las extensiones de Chrome, active el modo de desarrollador y cargue la carpeta descomprimida.