Массовые сертификаты

Массовые сертификаты позволяют выдавать значки сотням или тысячам получателей за раз через загрузку CSV-файла. Процесс состоит из четырёх шагов со встроенным отслеживанием прогресса, паузой/возобновлением и обработкой ошибок.

Обзор

Процесс массовой выдачи проходит в четыре шага:

1. Настройка — выберите значок и параметры
2. Загрузка — подготовьте и загрузите CSV-файл
3. Обработка — отслеживайте прогресс по мере создания сертификатов
4. Результаты — посмотрите итоги и скачайте отчёты

Шаг 1: Настройка

1. Откройте страницу Bulk Credentials в боковом меню (у неё собственный маршрут, отдельный от страницы Credentials).
2. Выберите значок, который хотите выдать, с помощью селектора значков.
3. При необходимости настройте:
   • Issued On — дата для всех сертификатов (по умолчанию сегодняшняя)
   • Expires — необязательная дата истечения срока для всех сертификатов
   • Send Email — отправлять ли каждому получателю письмо автоматически после создания его сертификата
4. Нажмите Next.

Шаг 2: Загрузка CSV

Формат CSV

В CSV-файле должны быть столбец name и столбец email, а также строка заголовков. Названия заголовков не чувствительны к регистру, а recipient_name / recipient_email принимаются как псевдонимы для name / email.

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Скачивание шаблона

Нажмите Download Template, чтобы получить пустой CSV-файл с правильными заголовками. Заполните его данными получателей и загрузите.

Загрузка

1. Нажмите Upload CSV или перетащите файл.
2. Перед началом обработки файл проверяется.

Правила проверки

Каждая строка проверяется сразу после разбора файла:

• Имя должно содержать не менее 5 символов
• Email должен быть корректным адресом электронной почты
• Пустые строки пропускаются

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

3. Нажмите Next, чтобы начать обработку.

Шаг 3: Обработка

После запуска обработки вы видите индикатор прогресса и счётчики в реальном времени:

• Индикатор прогресса — процент обработанных строк
• Created — сколько сертификатов создано
• Failed — сколько строк завершилось ошибкой
• Remaining — сколько строк ещё в очереди

Таблицы Created, Failed и Pending заполняются под индикатором по мере выполнения пакета.

Пауза и возобновление

• Нажмите Pause, чтобы временно остановить обработку. Пока она на паузе, новые сертификаты не создаются.
• Нажмите Resume, чтобы продолжить с того места, где остановились.

Отмена

• Нажмите Cancel, чтобы полностью остановить обработку. Уже созданные сертификаты сохраняются.

Обработка ошибок

Когда строка завершается ошибкой по причине, связанной именно с ней (например, бэкенд отклонил недопустимое значение):

• Ошибка записывается для этой строки
• Обработка автоматически продолжается со следующей строки
• Строки с ошибками собираются для шага результатов, а текст ошибки показывается в таблице сбоев на экране

Строки, отклонённые из-за ограничения частоты запросов, автоматически повторяются с небольшой задержкой. Ошибка кредитов или квоты — особый случай: вместо того чтобы пропускать строки, пакет приостанавливается, чтобы не израсходовать остаток файла впустую. Появляется красное уведомление «Insufficient credits»; пополните баланс или повысьте план, затем нажмите Resume, чтобы продолжить с места остановки.

Восстановление после обновления страницы

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

Шаг 4: Результаты

После завершения обработки (или отмены) на экране результатов отображаются четыре сводные карточки:

• Total — количество получателей в пакете
• Created — количество созданных сертификатов
• Failed — количество строк с ошибками
• Skipped — необработанные получатели (например, оставшиеся строки после отмены)

Под карточками таблица Created перечисляет каждый новый сертификат со ссылкой для просмотра, а таблица Failed — сбои с текстом ошибки.

Скачивание отчётов

• Download Results CSV — все строки пакета со столбцами row, name, email, status, award_url (URL сертификата заполняется для созданных строк).
• Download Failures CSV — только строки с ошибками, со столбцами name, email, error.

Повтор для неудачных строк

Если некоторые строки завершились ошибкой, нажмите Retry Failures. Это запустит новый проход только по неудачным получателям — загружать CSV заново не нужно. Это удобно после устранения временной проблемы, например пополнения кредитов после приостановленного пакета.