Как решить Cloudflare Turnstile на сайте copilot.microsoft.com

Введение

Если вы интегрируете автоматическое решение капчи Cloudflare Turnstile для copilot.microsoft.com и получаете токены, которые сайт отклоняет, это руководство для вас.

Сервис RuCaptcha поддерживает решение Turnstile через API v2 с минимальным набором параметров. Для стандартной реализации на copilot.microsoft.com достаточно передать websiteKey и websiteURL, но критически важно синхронизировать User-Agent между запросами.

Материал содержит общие рекомендации по настройке задачи, анализу страницы и отладке интеграции.

Общие сведения

Cloudflare Turnstile — токенизированная система защиты, которая заменяет традиционные капчи на невидимые или интерактивные виджеты. Виджет генерирует токен после проверки поведения пользователя и окружения браузера.

Особенности Turnstile на copilot.microsoft.com

Почему токен может не приниматься сайтом

Даже при корректно полученном токене сайт может отклонить запрос. Основные причины:

Подготовка окружения

Перед началом работы убедитесь, что у вас есть:

• Доступ к API RuCaptcha — API-ключ из личного кабинета
• Инструменты для автоматизации браузера — Playwright, Puppeteer или Selenium
• Актуальный User-Agent — строка из реального браузера, от имени которого идёт запрос
• Прокси (опционально) — резидентный, с геолокацией, соответствующей целевому сайту

Требования к прокси (если используется)

Анализ страницы и извлечение параметров

Определение наличия капчи

На copilot.microsoft.com капча Turnstile отображается при отправке сообщения в чат. Визуально — это виджет с логотипом Cloudflare или невидимая проверка.

Поиск websiteKey

1. Откройте DevTools (F12) на целевой странице
2. Перейдите во вкладку "Elements"
3. Найдите элемент с классом cf-turnstile или атрибутом data-sitekey

Пример тега:

<div class="cf-turnstile" data-sitekey="0x4AAAAAAAg146IpY3lPNWte"></div>

Значение атрибута data-sitekey — это ваш websiteKey.

Проверка типа виджета

Убедитесь, что используется стандартный виджет, а не Challenge-страница:

• Стандартный режим: элемент .cf-turnstile присутствует, iframe с challenges.cloudflare.com отсутствует
• Challenge-режим: присутствует iframe с эндпоинтом Cloudflare Challenges

Для copilot.microsoft.com в большинстве случаев используется стандартный режим, для которого не требуются дополнительные параметры.

Реализация

Структура задачи TurnstileTask

Задача отправляется методом createTask на эндпоинт https://api.rucaptcha.com/createTask.

Обязательные поля задачи:

Рекомендуемые поля:

Пример тела запроса (JSON)

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://copilot.microsoft.com/chats/example",
    "websiteKey": "0x4AAAAAAAg146IpY3lPNWte",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
  }
}

Получение результата

После создания задачи используйте метод getTaskResult для опроса статуса:

{
  "clientKey": "YOUR_API_KEY",
  "taskId": 123456789
}

Возможные значения поля status:

Инъекция токена в страницу

После получения токена:

1. Дождитесь появления поля input[name="cf-turnstile-response"]
2. Установите значение токена в это поле
3. Вызовите события change и input для активации триггеров сайта
4. При необходимости обновите User-Agent в сессии, если API вернул другое значение

Пример логики (псевдокод):

дождаться поля cf-turnstile-response
установить значение токена
вызвать события change и input
если API вернул userAgent:
    обновить заголовок User-Agent в сессии
отправить форму или продолжить взаимодействие

Пояснения к параметрам

Минимальный набор параметров

• Для стандартного Turnstile на copilot.microsoft.com достаточно websiteKey и websiteURL
• Параметр userAgent рекомендуется передавать для синхронизации сессии
• pagedata, action, data можно не указывать, если сайт не требует их явно

Синхронизация User-Agent

• API RuCaptcha может вернуть поле solution.userAgent с актуальной строкой агента
• Используйте это значение в последующих запросах к целевому сайту
• Несоответствие User-Agent — частая причина отклонения валидных токенов

Инъекция токена

• Токен передаётся в поле cf-turnstile-response
• После установки значения важно вызвать события change и input для триггеров сайта
• Если сайт использует колбэк-функцию, её нужно вызвать отдельно (редко для стандартного режима)

Обратная связь по результатам решения

После проверки токена на целевом сайте рекомендуется отправить обратную связь.

Если сайт отклонил решение

Отправьте POST-запрос на эндпоинт reportIncorrect:

Эндпоинт: https://api.rucaptcha.com/reportIncorrect

Метод: POST

Content-Type: application/json

Пример запроса:

{
   "clientKey": "YOUR_API_KEY",
   "taskId": 74455221488
}

Пример ответа:

{
    "errorId": 0,
    "status": "success"
}

Важно: не используйте этот метод, если ваш процент успеха близок к 0%. Это может указывать на ошибку в вашем коде, а не в решениях капчи.

Если сайт принял решение

Отправьте POST-запрос на эндпоинт reportCorrect:

Эндпоинт: https://api.rucaptcha.com/reportCorrect

Метод: POST

Content-Type: application/json

Пример запроса:

{
   "clientKey": "YOUR_API_KEY",
   "taskId": 74455221488
}

Пример ответа:

{
    "errorId": 0,
    "status": "success"
}

Политика возвратов

• Каждый случай рассматривается индивидуально
• Для стандартных капч проверяется корректность ответа
• Для капч с токеном анализируется статистика исполнителя
• Возврат средств не гарантируется по каждой жалобе
• Итоговая сумма возвратов может отличаться от количества обращений

Отправляйте отчёты честно и только после реальной проверки на целевом сайте.

Типичные ошибки и способы их устранения

Рекомендации по отладке

• Включите детальное логирование запросов и ответов
• Сохраняйте taskId для каждого запроса — это упростит обращение в поддержку
• Тестируйте интеграцию в не-headless режиме перед запуском в продакшене
• Проверяйте ответ целевого сайта после отправки токена
• Сравнивайте User-Agent в запросе к API и в браузере

Дополнительные ресурсы

• Документация по Cloudflare Turnstile API v2
• Метод reportIncorrect — отчёт о неверном решении
• Метод reportCorrect — отчёт о верном решении
• Примеры кода на GitHub
• Обратиться в поддержку
• Гайд по обходу Turnstile

Контрольный список

• websiteKey извлечён из атрибута data-sitekey
• websiteURL содержит полную ссылку на страницу с капчей
• userAgent в запросе совпадает с реальным браузером
• В ответе API используется возвращённый userAgent для последующих запросов
• Токен инжектируется в поле cf-turnstile-response с триггерами событий
• Прокси (если используется) резидентный и соответствует гео целевого сайта
• Включено логирование для отладки параметров и ответов API
• Реализована отправка отчётов reportIncorrect / reportCorrect

Заключение

Для стандартной реализации Cloudflare Turnstile на copilot.microsoft.com достаточно передать два обязательных параметра: websiteKey и websiteURL. Дополнительные параметры в данном случае не требуются.

Основная причина, по которой токен может не приниматься сайтом — несоответствие User-Agent между запросом к API и последующими запросами от браузера. Всегда используйте значение userAgent из ответа RuCaptcha для синхронизации сессии.

Корректная инъекция токена требует установки значения в поле cf-turnstile-response и вызова событий change и input для активации триггеров сайта.

Не забывайте отправлять обратную связь через reportIncorrect и reportCorrect — это помогает улучшать качество сервиса и возвращать средства за ошибочные решения.

Автоматизируйте любые капчи с помощью API RuCaptcha.