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

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

Огляд

Процес масової видачі сертифікатів складається з чотирьох кроків:

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

Крок 1: Налаштування

1. Відкрийте сторінку Масові сертифікати на бічній панелі (це окремий маршрут, відмінний від сторінки «Сертифікати»).
2. Оберіть значок, який хочете видати, за допомогою засобу вибору значків.
3. За потреби налаштуйте:
   • Дата видачі — дата для всіх сертифікатів (за замовчуванням — сьогодні)
   • Дійсний до — необов'язкова дата завершення дії всіх сертифікатів
   • Надіслати лист — чи автоматично надсилати кожному одержувачу лист після створення його сертифіката
4. Натисніть Далі.

Крок 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

Завантаження шаблону

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

Завантаження

1. Натисніть Завантажити CSV або перетягніть файл.
2. Перед початком обробки файл перевіряється.

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

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

• Ім'я має містити щонайменше 5 символів
• Email має бути дійсною адресою електронної пошти
• Порожні рядки пропускаються

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

3. Натисніть Далі, щоб розпочати обробку.

Крок 3: Обробка

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

• Індикатор прогресу — відсоток оброблених рядків
• Створено — скільки сертифікатів створено
• Помилки — у скількох рядках сталася помилка
• Залишилось — скільки рядків досі в черзі

Таблиці Створено, Помилки та Очікують заповнюються під індикатором у ході обробки пакета.

Пауза та відновлення

• Натисніть Пауза, щоб тимчасово зупинити обробку. Під час паузи нові сертифікати не створюються.
• Натисніть Відновити, щоб продовжити з місця зупинки.

Скасування

• Натисніть Скасувати, щоб повністю зупинити обробку. Уже створені сертифікати зберігаються.

Обробка помилок

Коли рядок не вдається обробити з причини, пов'язаної саме з ним (наприклад, недійсне значення, яке відхиляє бекенд):

• Помилка записується для цього рядка
• Обробка автоматично переходить до наступного рядка
• Рядки з помилками збираються для кроку результатів, а текст помилки показано в таблиці помилок на екрані

Рядки, до яких застосовано обмеження частоти запитів, автоматично повторюються з короткою затримкою. Помилка кредитів або квоти — це інше: замість того щоб іти далі, пакет призупиняється, щоб ви не витратили решту файлу даремно. З'являється червоне повідомлення «Недостатньо кредитів»; поповніть баланс або перейдіть на вищий тариф, а потім натисніть Відновити, щоб продовжити з місця зупинки.

Відновлення після оновлення сторінки

Якщо ви випадково закриєте браузер або оновите сторінку під час обробки, сеанс масової видачі сертифікатів буде відновлено, коли ви повернетеся. Прогрес продовжиться з місця зупинки.

Крок 4: Результати

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

• Усього — кількість одержувачів у пакеті
• Створено — кількість створених сертифікатів
• Помилки — кількість рядків із помилками
• Пропущено — одержувачі, яких не було оброблено (наприклад, решта рядків після скасування)

Під картками таблиця Створено містить кожен новий сертифікат із посиланням для його перегляду, а таблиця Помилки — рядки з помилками та текстом помилок.

Завантаження звітів

• Завантажити CSV результатів — усі рядки пакета зі стовпцями row, name, email, status, award_url (URL сертифіката заповнюється для створених рядків).
• Завантажити CSV помилок — лише рядки з помилками зі стовпцями name, email, error.

Повторна обробка помилок

Якщо деякі рядки завершилися помилкою, натисніть Повторити невдалі. Це запускає новий прохід лише для одержувачів, що не вдалися, — повторно завантажувати CSV не потрібно. Це зручно після усунення тимчасової проблеми, наприклад після поповнення кредитів у разі призупиненого пакета.