Guia de integração

Início rápido

O BotFlush é integrado em três etapas: carregar o widget, renderizá-lo e verificar os tokens no servidor.

1. Carregar widget

Adicione o script do widget à página. Ele carrega de forma assíncrona e não bloqueia a renderização.

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

2. Adicionar contêiner

Coloque um elemento contêiner onde o CAPTCHA deve aparecer.

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

3. Verificar no servidor

Quando o usuário completa o desafio, um token é gerado. Envie ao servidor e verifique via API.

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

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

API JavaScript

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 migração

BotFlush suporta padrões familiares de widget e siteverify. Comece alterando URL do script, chaves e endpoint; teste callbacks e erros antes do rollout.

<!-- 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 privacidade

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 verificação

BotFlush oferece vários motores de desafio. Configure os permitidos por site no console.

Verificação no 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))

Downloads

Node Inspector — extensão Chrome

Instalação: Baixe e descompacte, abra as extensões do Chrome, ative o modo de desenvolvedor e carregue a pasta descompactada.