Документация

Когда капча не появилась или не пропускает

Капчи на форме нет

Что проверить Как убедиться
Активность для этого сайта флажок «Активность» на вкладке «Настройки сайтов», у нужного сайта
Правила показа режим и списки путей: страница должна попадать в показ
Форма пользуется капчей Битрикса в исходном коде страницы без модуля есть /bitrix/tools/captcha.php
Класс капчи не занят другим кодом уведомление в админке со ссылкой на файл
Версия PHP 8.0 и выше
Срок демонстрационного режима сообщение об окончании демонстрационного режима на странице настроек

Самая частая причина — третья строка. Модуль подменяет капчу Битрикса, и форма, которая её не выводит, остаётся без проверки. Решение — подключить форму вручную, как описано в главе «Свои и нештатные формы».

Капча есть, но отправка не проходит

Причина Признак в журнале
Ключи перепутаны местами Яндекс отвечает отказом на каждую отправку
Ключи от капчи с другим доменом отказ только на этом домене, на другом всё работает
Ответ отправлен повторно первая отправка проходит, повторная — нет
Яндекс недоступен ошибка запроса

Ключи стоит проверять первыми: ключ клиента начинается с ysc1_, ключ сервера — с ysc2_. Если в поле «Ключ сервера» лежит значение на ysc1_, проверка не пройдёт никогда.

Служба недоступна

Когда запрос к Яндексу не удался — сеть, блокировка исходящих соединений, сбой у самой службы, — проверка отвечает отказом, и отправка не проходит.

Это осознанное поведение: пропускать отправки без подтверждения означало бы, что защита отключается ровно тогда, когда её проще всего обойти — достаточно сделать проверку недоступной.

Что делать, если сбой затянулся:

  1. Убедиться, что дело в связи: с сервера сайта запросить https://smartcaptcha.cloud.yandex.ru и посмотреть ответ.
  2. На время снять флажок «Активность» — формы вернутся к штатной капче Битрикса и продолжат работать.
  3. После восстановления связи вернуть флажок.

Второй шаг — обычный порядок на время сбоя, а не аварийная мера: штатная капча остаётся рабочей защитой, пока SmartCaptcha недоступна.