Neste artigo, procuramos responder a todas as principais dúvidas. Para começar a resolver o problema, o primeiro passo é identificar qual sistema de proteção está sendo utilizado. Para isso, você pode consultar a lista de captchas e sistemas de proteção antibot mais populares, onde há exemplos visuais e sinais principais que ajudam a identificar rapidamente com o que você está lidando.
Se você notar que o seu site utiliza DataDome CAPTCHA, o passo seguinte é estudar com mais detalhes as suas características e o seu funcionamento. Neste mesmo artigo, você também pode conferir o guia de integração do DataDome CAPTCHA, para entender por completo como o sistema opera no seu site. Isso permitirá não apenas compreender a proteção atual, mas também planejar adequadamente a sua manutenção.
Como resolver o CAPTCHA DataDome via CapMonster Cloud
Trabalhar com o CapMonster Cloud via API normalmente envolve as etapas abaixo:
Criação da tarefa
Envio da requisição APItype - CustomTask
class - DataDome
websiteURL - Endereço da página principal onde o CAPTCHA será resolvido.
captchaUrl (dentro do metadata) - "captchaUrl" - link para o CAPTCHA. Normalmente no formato: "https://geo.captcha-delivery.com/captcha/?initialCid=..."
datadomeCookie (dentro do metadata) - Seus cookies do DataDome. Podem ser obtidos na página via document.cookie (se não forem HttpOnly), no cabeçalho Set-Cookie: "datadome=..." ou diretamente no código HTML da página initialCid.
userAgent - User-Agent do navegador. Use apenas o UA atual do Windows.
Para esta tarefa, também é necessário usar seus proxies:
proxyType :
- http - proxy HTTP/HTTPS padrão;
- https - use se o 'http' não funcionar (necessário para alguns proxies personalizados);
- socks4 - proxy SOCKS4;
- socks5 - proxy SOCKS5.
proxyAddress - Endereço IP do proxy IPv4/IPv6.
proxyPort - Porta do proxy.
proxyLogin - Login do proxy.
proxyPassword - Senha do proxy.
https://api.capmonster.cloud/createTask
{
"clientKey": "API_KEY",
"task": {
"type": "CustomTask",
"class": "DataDome",
"websiteURL": "https://example.com",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36",
"metadata": {
"captchaUrl": "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA9UvsL58YLqIAXNLFPg%3D%3D&hash=C0705ACD75EBF650A07FF8291D3528&cid=7sfa5xUfDrR4bQTp1c2mhtiD7jj9TXExcQypjdNAxKVFyIi1S9tE0~_mqLa2EFpOuzxKcZloPllsNHjNnqzD9HmBA4hEv7SsEyPYEidCBvjZEaDyfRyzefFfolv0lAHM&referer=https%3A%2F%2Fwww.example.com.au%2F&s=6522&b=978936&dm=cm",
"datadomeCookie": "datadome=VYUWrgJ9ap4zmXq8Mgbp...64emvUPeON45z"
},
"proxyType": "http",
"proxyAddress": "123.45.67.89",
"proxyPort": 8080,
"proxyLogin": "proxyUsername",
"proxyPassword": "proxyPassword"
}
}
{
"errorId":0,
"taskId":407533072
}
Recebimento do resultadohttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"domains": {
"www.example.com": {
"cookies": {
"datadome": "P1w0VnjFcTFslfps0J4FaPpY_QPbPBW4MeYxj4LW~pztIfJiSSuBPr8oQTUHzdrfgv137FbOBd3kCUOOgny7LhIkhm5e1qdtzYM4s2e46U_qfERK4KiCy22MOSIDsDyh"
},
"localStorage": null
}
},
"url": null,
"fingerprint": null,
"headers": null,
"data": null
}
}
Aplicação do token na página
// npx playwright install chromium
import { chromium } from 'playwright';
import { CapMonsterCloudClientFactory, ClientOptions, DataDomeRequest } from '@zennolab_com/capmonstercloud-client';
// Insira sua chave API do CapMonster Cloud
const API_KEY = 'YOUR_API_KEY';
// Seu site está protegido pelo DataDome
const TARGET_URL = 'https://example.com/';
const USER_AGENT = Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36
// Configuração de proxy
const proxy = {
proxyType: "http",
proxyAddress: '8.8.8.8',
proxyPort: 8080,
proxyLogin: 'proxyLogin',
proxyPassword: 'proxyPassword'
};
async function main() {
// Iniciando navegador
const browser = await chromium.launch({ headless: true });
const context = await browser.newContext({ userAgent: USER_AGENT });
const page = await context.newPage();
// Acessando site
await page.goto(TARGET_URL, { waitUntil: 'networkidle' });
// Procurando cookie datadome existente (se houver)
const existingDd = (await context.cookies()).find(c => /datadome|dd_/i.test(c.name));
// Procurando iframe DataDome -> URL do CAPTCHA
const captchaUrl = await page.evaluate(() =>
Array.from(document.querySelectorAll('iframe[src]'))
.find(i => /captcha-delivery\.com\/captcha/i.test(i.src))
?.src || null
);
console.log(`=== Parâmetros extraídos do DataDome ===`);
console.log(`captchaUrl:`, captchaUrl || 'não encontrado');
console.log(`cookie datadome atual::`, existingDd ? ${existingDd.name}=${existingDd.value}` : 'nenhum');
const cm = CapMonsterCloudClientFactory.Create(
new ClientOptions({ clientKey: API_KEY })
);
// Enviando tarefa para CapMonster
console.log(`Enviando tarefa DataDome para CapMonster......`);
// Enviando tarefa para resolução DataDome
const solve = await cm.Solve(new DataDomeRequest({
_class: "DataDome",
websiteURL: TARGET_URL,
userAgent: USER_AGENT,
proxy,
metadata: {
captchaUrl: captchaUrl || undefined,
datadomeCookie: existingDd
? `${existingDd.name}=${existingDd.value}`
: undefined
}
}));
const sol = solve?.solution;
// Obtendo domínio e cookies necessários da solução
const host = new URL(TARGET_URL).hostname;
const domainKey =
Object.keys(sol.domains).find(d => d.includes(host))
|| Object.keys(sol.domains)[0];
const cookiesArr = sol.domains[domainKey]?.cookies || [];
console.log(`\n=== Cookies do CapMonster ===`);
cookiesArr.forEach(c => console.log(`${c.name}=${c.value}`));
const ddSolved =
cookiesArr.find(c => c.name?.toLowerCase() === 'datadome')
|| cookiesArr.find(c => /datadome/i.test(c.name));
// Definindo cookie datadome no navegador
await context.addCookies([{
name: 'datadome',
value: ddSolved.value,
domain: '.' + host,
path: '/',
httpOnly: ddSolved.httpOnly ?? true,
secure: ddSolved.secure ?? true,
sameSite: ddSolved.sameSite ?? 'Lax'
}]);
console.log(`cookie datadome definido:`, ddSolved.value);
// Reabrindo site após inserir cookie
const page2 = await context.newPage();
const resp2 = await page2.goto(TARGET_URL, { waitUntil: 'domcontentloaded', timeout: 60000 });
console.log(`Status após definir cookie:: ${resp2?.status()}`);
await browser.close();
}
main();
1. Faça login na sua conta ou registre-se no DataDome e obtenha as chaves (client-side e server-side).
Importante: use um e-mail corporativo para registro.
Após o registro, você terá acesso ao painel administrativo.
2. Adicione o site (domínio) no painel DataDome.
Adicione seu domínio no sistema e escolha os parâmetros de proteção:
- Proteção Web (proteção de tráfego HTTP)
- Bot detection & mitigation
- Frequency & behavior analysis
- Páginas de challenge (verificação DataDome)
- JS tag configuration
3. Instale a integração no lado do servidor.
Use Protection API ou escolha um módulo pronto para sua stack (Node.js / Express, Nginx, Cloudflare, Java (Tomcat/Jetty/Vert.x), Go etc.).
Instale o SDK/middleware oficial DataDome, configure a server-side key.
Exemplo de integração DataDome em Node.js:
DataDome protege o servidor contra bots e solicitações suspeitas, exibindo automaticamente challenge quando necessário. O módulo pode ser usado com Express ou servidor HTTP integrado Node.js.
Instalação
Para Express:
npm install @datadome/module-expressPara módulo HTTP Node.js:
npm install @datadome/module-httpSuporta Node.js 18+. Chave server-side necessária do painel DataDome.
Integração com Express
const { DatadomeExpress } = require('@datadome/module-express');
const express = require('express');
const app = express();
// Inicializando cliente DataDome
const datadomeClient = new DatadomeExpress('YOUR_SERVER_KEY');
// Conectando middleware
app.use(datadomeClient.middleware());
// Suas rotas
app.get('/', (req, res) => {
res.send('Hello World');
});
// Iniciando servidor
app.listen(3000, () => {
console.log('Server running on port 3000');
})
const { DatadomeHttp } = require('@datadome/module-http');
const http = require('http');
const datadomeClient = new DatadomeHttp('YOUR_SERVER_KEY');
const hostname = '127.0.0.1';
const port = 3000;
const server = http.createServer(async (req, res) => {
const { result, error } = await datadomeClient.handleRequest(req, res);
if (result === 'ALLOW') {
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
res.end('Hello World\n');
} else {
console.log('Request challenged');
if (error) console.error(error);
}
});
server.listen(port, hostname, () => {
console.log(`Server running at http://${hostname}:${port}/`);
});Configurações do módulo
Você pode passar a configuração ao criar o cliente:
const datadomeClient = new DatadomeExpress('YOUR_SERVER_KEY', {
timeout: 150, // timeout em ms após o qual a solicitação é permitida
urlPatternInclusion: null, // quais URLs verificar
urlPatternExclusion: /\.(avi|flv|mka|mkv|mov|mp4|mpeg|mpg|mp3|flac|ogg|ogm|opus|wav|webm|webp|bmp|gif|ico|jpeg|jpg|png|svg|svgz|swf|eot|otf|ttf|woff|woff2|css|less|js|map|json|avif|xml|gz|zip)$/i,
endpointHost: 'api.datadome.co',
});Opções avançadas:
- Registro de headers DataDome (enrichedHeaders)
- CSP nonce: app.use(datadomeClient.middleware({ nonce: 'VALUE' }))
- Sobrescrever metadados da requisição via handlers
Mais detalhes sobre integração do lado do servidor em documentação oficial.
4. Conecte a parte cliente.
Insira a JS Tag no <head> do seu site:
<head>
<script>
window.ddjskey = 'YOUR_DATADOME_JS_KEY';
window.ddoptions = {
// Adicione suas configurações aqui (opcional)
};
</script>
<script src="https://js.datadome.co/tags.js" async></script>
<!-- Outros elementos do head -->
</head>
YOUR_DATADOME_JS_KEY → Substitua pela sua Client-Side Key.
O script deve ser carregado no início do <head> para que o DataDome capture solicitações e acompanhe corretamente o comportamento do usuário.
Se o site usa CSP, adicione as seguintes diretivas:
Para script inline
<script nonce="DYNAMIC_NONCE">
window.ddjskey = 'YOUR_DATADOME_JS_KEY';
window.ddoptions = {};
</script>
script-src js.datadome.co ct.captcha-delivery.com 'nonce-DYNAMIC_NONCE';
connect-src api-js.datadome.co; /* para enviar dados da JS Tag */
frame-src *.captcha-delivery.com; /* para páginas challenge */
worker-src blob:; /* para web workers */
Mais detalhes sobre integração cliente em documentação oficial DataDome CAPTCHA.
Verificação de resultado
O DataDome cria o cookie datadome= após a verificação bem-sucedida. Esse cookie é enviado automaticamente pelo usuário — e o servidor aceita a requisição. Se o cookie não existir ou for inválido, o DataDome mostrará o desafio novamente.
Captchas suportados
reCAPTCHA v2reCAPTCHA v3reCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
FriendlySe você herdou um site que já tem um captcha ou outro sistema de proteção instalado e não tem acesso ao código, não tem problema! É bem fácil identificar qual tecnologia está sendo usada. Para verificar se tudo está funcionando corretamente, você pode usar o serviço de reconhecimento CapMonster Cloud em um ambiente de testes isolado, para garantir que o mecanismo de processamento de tokens e a lógica de verificação estejam funcionando corretamente.
No caso de DataDome CAPTCHA, basta identificar o sistema, analisar o comportamento dele e se certificar de que a proteção está funcionando corretamente. No artigo, mostramos como identificar DataDome CAPTCHA e onde encontrar instruções para a integração ou reconfiguração, para que você consiga manter a proteção com segurança e controlar o funcionamento dela.
Perguntas frequentes sobre o DataDome
