Сертификаты за прохождение

Участник проходит опрос — и получает именной PDF прямо в чат с ботом: кто прошёл, какой опрос, с каким результатом и когда. Это единственная интеграция, которая создаёт файл, а не отправляет данные во внешний сервис.

Когда выдаётся

Есть два способа, и они дополняют друг друга.

Автоматически — на событие «респондент завершил опрос». Так сертификат получает каждый, кто прошёл, без чьего-либо участия.

Вручную — запуском из кабинета, когда сертификат нужен задним числом: человек потерял ссылку, или опрос проходил до подключения интеграции.

Порог по баллам

В настройках есть минимальный балл. По умолчанию он равен нулю — сертификат получают все, кто дошёл до конца. Это сделано намеренно: у опроса без правильных ответов (а таких большинство) осмысленного порога нет, и требовать его значило бы усложнять обычный случай ради редкого.

Если порог задан и участник его не набрал, в журнале появится запись «результат ниже порога» — как решение, а не как ошибка.

Код проверки

На каждом сертификате внизу справа есть код вида PG-4F3B-9E7A. Он получается из идентификатора прохождения, поэтому по нему выданный документ сверяется с записью в системе. Это то, что отличает сертификат от картинки, которую можно нарисовать самому.

Что должно быть у прохождения

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

Название компании — необязательно, но если задать, оно печатается под датой.

Как участник получает сертификат

Готовый PDF приходит прямо в чат с ботом, файлом, сразу после прохождения. Ничего пересылать вручную не нужно.

К файлу прикладывается сообщение. По умолчанию это «Ваш сертификат за прохождение «название опроса»», но текст можно заменить своим в настройках интеграции — поле «Текст сообщения участнику». В нём работают подстановки:

Подстановка	Что подставится
{quiz}	Название опроса
{name}	Имя участника
{score}	Результат в виде «3/10»

Например, {name}, ваш сертификат за «{quiz}» — результат {score} превратится в «Иван Петров, ваш сертификат за «Основы кибербезопасности» — результат 3/10».

Если участник заблокировал бота, доставки не будет — но сертификат всё равно создаётся, и ссылка на него остаётся в журнале запусков. В журнале это видно: у запуска будет пометка, что файл выдан, но не доставлен.

Где лежит файл

Сертификат сохраняется в хранилище, а ссылка на него возвращается в результате запуска и попадает в журнал интеграций. Оттуда её можно скопировать и передать любым другим способом — например, приложить к письму.

Ручная выдача участнику не пишет

Когда вы выдаёте сертификат кнопкой из кабинета, сообщение участнику не уходит — вы получаете файл себе. Так и задумано: кнопку обычно жмут, чтобы приложить документ к отчёту, а не чтобы потревожить человека, прошедшего опрос неделю назад.

Выдать вручную

Автоматически сертификат выдаётся при завершении опроса. Выдать его ещё раз можно из кабинета: «Отчёты» → раскрыть карточку прохождения → кнопка «Выдать сертификат». В окне будет список участников этой сессии, у каждого — своя кнопка.

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

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

Кнопки нет, пока не подключена интеграция сертификатов: она появляется сама, когда появляется чем выдавать.

Порог баллов

В настройках можно задать минимум, ниже которого сертификат не выдаётся. Это не ошибка и не сбой: в журнале такой случай так и записывается — «результат ниже порога», без красных отметок.

Имя на сертификате

Берётся из профиля участника: полное имя, затем короткое, затем логин. Если имени нет вообще, сертификат не выдаётся — документ без имени показать некому.

Эмодзи и редкие символы из имени убираются: шрифт сертификата их не содержит, и в PDF они превратились бы в пустые квадраты.