Руководство пользователя

Получение согласий

В личном кабинете Согласиус можно выгрузить сохраненные согласия пользователей: все сразу по выбранному проекту или одно конкретное согласие по hash-ключу. Эта возможность доступна для проектов Cookie и для проектов по персональным данным.

Где находится выгрузка

Откройте личный кабинет, перейдите в нужный проект Cookie или Персональные данные. В верхней части страницы проекта отображаются две карточки:

Запросить согласие — получает одно согласие по hash пользователя.
Выгрузить все согласия — скачивает JSON-файл со всеми согласиями выбранного проекта.

Как согласия попадают в сервис

Перед выгрузкой согласия должны быть зафиксированы в проекте. Это настраивается в личном кабинете на страницах настроек Cookie-баннера и согласий на обработку персональных данных.

Cookie-проект

В настройках баннера вы копируете код подключения CMP, выбираете категории Cookie, внешний вид баннера, поведение кнопок и версии соглашений. Когда пользователь принимает, отклоняет или частично настраивает Cookie, баннер отправляет согласие в Согласиус и получает в ответ hash. Этот hash сохраняется в cookie soglasius_hash на сайте пользователя.

Проект персональных данных

В настройках персональных данных вы выбираете цели обработки, категории данных и действия с данными. Личный кабинет формирует тело API-запроса для фиксации согласия. При успешной отправке сервис возвращает hash записи согласия и user_hash для проверки введенных персональных данных без хранения исходных значений.

Версии соглашений

Если для проекта загружена актуальная версия соглашения, при фиксации согласия в запись добавляются UF_AGREEMENT_VERSION и UF_AGREEMENT_HASH. Эти поля помогают подтвердить, с каким текстом соглашения пользователь согласился.

Одно согласие

Используйте этот сценарий, когда нужно проверить согласие конкретного пользователя: например, по обращению в поддержку, юридическому запросу или внутренней проверке.

Откройте проект в личном кабинете и нажмите Отправить запрос в карточке Запросить согласие.
В поле Hash пользователя вставьте hash, который был выдан при фиксации согласия.
Нажмите Отправить. Если согласие найдено, браузер скачает JSON-файл с данными этого согласия.

Откуда брать hash

Hash появляется в ответе сервиса в момент фиксации согласия. Это основной идентификатор записи согласия, по которому ее можно получить позже.

Для Cookie-согласия баннер получает в ответе поле hash и сохраняет его в cookie soglasius_hash в браузере пользователя.
Для согласия на обработку персональных данных API возвращает поле hash. Именно его нужно вводить в поле Hash пользователя.
Если вы фиксируете согласие через собственную форму или интеграцию, сохраните полученный hash у себя в CRM, заявке, профиле пользователя или журнале событий.

Где найти cookie `soglasius_hash` в браузере

Если нужно найти hash Cookie-согласия прямо на сайте пользователя, откройте сайт, на котором установлен баннер, и посмотрите cookie этого сайта в инструментах разработчика браузера.

Google Chrome, Яндекс Браузер, Microsoft Edge: нажмите F12 или Ctrl+Shift+I, откройте вкладку Application, слева выберите Cookies, затем домен сайта. В таблице найдите cookie с именем soglasius_hash и скопируйте значение из колонки Value.
Firefox: нажмите F12 или Ctrl+Shift+I, откройте вкладку Storage, выберите Cookies и домен сайта. Найдите строку soglasius_hash и скопируйте ее значение.
Safari: включите меню разработчика в настройках Safari, затем откройте Develop → Show Web Inspector, перейдите в раздел Storage или Cookies и выберите домен сайта.

Нужное значение находится именно в поле Value. Его можно вставить в личном кабинете в поле Hash пользователя при запросе конкретного согласия.

Важно про персональные данные

Для персональных данных сервис также возвращает user_hash. Это не hash записи согласия, а контрольный hash введенных персональных данных. Он нужен для последующей проверки, что введенные пользователем данные совпадают с теми, по которым было выдано согласие. В поле Hash пользователя в личном кабинете вводится не user_hash, а обычный hash записи согласия.

Все согласия

Выгрузка всех согласий подходит для аудита, передачи ответственному специалисту, подготовки отчета или резервного сохранения данных по проекту.

Откройте нужный проект Cookie или Персональные данные.
Нажмите Выгрузить согласия в карточке Выгрузить все согласия.
Дождитесь завершения выгрузки. Если записей много, операция может занять время. В модальном окне можно отменить выгрузку кнопкой Отмена.
После успешного завершения браузер скачает JSON-файл с согласиями выбранного проекта.

Что попадает в файл

Файл содержит ответ сервиса. Для полной выгрузки внутри будет поле count с количеством найденных записей и массив data, где каждый элемент является отдельным согласием.

Структура результата

Результат сохраняется в формате JSON. Ниже показаны основные варианты ответа и значение каждого поля.

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

{
  "status": "success",
  "data": {
    "UF_DATE": "2026-05-06 12:30:45",
    "UF_IP": "192.168.0.0",
    "UF_USER_AGENT": "Mozilla/5.0 ...",
    "UF_HASH": "b7f4...",
    "UF_CONSENT": {
      "necessary": true,
      "statistic": true,
      "marketing": false
    },
    "UF_TYPE": "cookie",
    "UF_URL": "https://example.ru/page/",
    "UF_AGREEMENT_VERSION": "1.0",
    "UF_AGREEMENT_HASH": "a91c..."
  }
}

Ответ при выгрузке всех согласий

{
  "status": "success",
  "count": 2,
  "data": [
    {
      "UF_DATE": "2026-05-06 12:30:45",
      "UF_IP": "192.168.0.0",
      "UF_USER_AGENT": "Mozilla/5.0 ...",
      "UF_HASH": "b7f4...",
      "UF_CONSENT": {
        "necessary": true,
        "statistic": true,
        "marketing": false
      },
      "UF_TYPE": "cookie",
      "UF_URL": "https://example.ru/page/",
      "UF_AGREEMENT_VERSION": "1.0",
      "UF_AGREEMENT_HASH": "a91c..."
    }
  ]
}

Поле	Что означает
status	Статус выполнения запроса. Значение `success` означает, что данные успешно получены.
count	Количество согласий в полной выгрузке. Для запроса одного согласия это поле не используется.
data	Одно согласие или массив согласий. Формат зависит от выбранного действия в личном кабинете.
UF_DATE	Дата и время фиксации согласия.
UF_IP	IP-адрес пользователя в маскированном виде. Он помогает подтвердить технический контекст события, но не хранится в полном виде.
UF_USER_AGENT	Информация о браузере и устройстве пользователя на момент выдачи согласия.
UF_HASH	Уникальный hash записи согласия. Именно его используют для запроса конкретного согласия через поле `Hash пользователя`.
UF_CONSENT	Содержимое согласия: выбранные категории Cookie или параметры обработки персональных данных.
UF_TYPE	Тип согласия: `cookie` или `personal_data`.
UF_URL	Страница, с которой было отправлено согласие, если браузер передал referer.
UF_AGREEMENT_VERSION	Версия соглашения, которая была актуальна в момент выдачи согласия.
UF_AGREEMENT_HASH	Hash версии соглашения. Помогает доказать, какой именно текст соглашения был принят пользователем.

Cookie-согласия

В Cookie-проектах поле UF_CONSENT показывает, какие категории пользователь разрешил или отклонил.

Параметр	Значение
necessary	Обязательные Cookie и скрипты. Обычно всегда `true`, потому что они нужны для работы сайта.
statistic	Согласие на статистику и аналитику, например счетчики посещаемости.
marketing	Согласие на маркетинговые инструменты, рекламные пиксели и похожие технологии.

Как читать значения

true означает, что пользователь согласился на категорию. false означает отказ. Если обязательная категория necessary есть в согласии, но дополнительные категории выключены, такое согласие считается отказом от необязательных Cookie.

Персональные данные

Для проектов по персональным данным результат показывает, на какие цели, категории данных и действия пользователь дал согласие. Исходные персональные данные в выгрузке не отображаются.

{
  "UF_CONSENT": {
    "purposes": ["registration", "feedback"],
    "categories": ["email", "full_name", "phone"],
    "categories_hash": "84c2...",
    "processing_actions": ["collection", "storage", "use"]
  }
}

Параметр	Что означает
purposes	Цели обработки персональных данных: регистрация, обратная связь, поддержка, маркетинг, аналитика и другие выбранные цели.
categories	Категории персональных данных, по которым было выдано согласие: email, телефон, ФИО, IP-адрес, платежные данные и другие категории.
categories_hash	Контрольный hash значений персональных данных. Он позволяет проверить совпадение данных без хранения самих значений в исходном виде.
processing_actions	Разрешенные действия с персональными данными: сбор, запись, хранение, использование, передача и другие операции.

Проверка данных пользователя

После получения согласия по hash в проекте персональных данных личный кабинет может показать блок проверки. Введите значения тех категорий данных, которые участвовали в согласии. Сервис снова сформирует hash и сравнит его с categories_hash. Если hash совпал, значит введенные данные относятся к найденному согласию.

Если согласие не найдено

Если выгрузка не выполняется или конкретное согласие не найдено, проверьте несколько базовых условий.

Hash введен полностью, без пробелов в начале и в конце.
Вы открыли тот проект, в котором было зафиксировано согласие.
Тип проекта совпадает с типом согласия: Cookie-согласия ищутся в Cookie-проекте, согласия на персональные данные — в проекте персональных данных.
Согласие действительно было успешно сохранено после действия пользователя.

Если в ответе указано Consent file not found, запись с таким hash не найдена в выбранном проекте. В этом случае проверьте источник hash и проект, из которого выполняется запрос.