Skip to main content

Script — bulk create Qontak One users

Jira: BIF-8298 · Epic: BIF-8695

Overview

Provide a supported way to bulk-create Qontak One users when an onboarding requires adding more than ~100 users at once, so Tech Support / onboarding doesn't have to invite them one by one through the UI.

Scope Changes

  • Backend — a bulk user-creation script/utility that ingests a list of users and creates them under a Qontak One CID.

8. User Stories + Acceptance Criteria

User StoryImportanceMockup / Technical NotesAcceptance Criteria
[BULKUSER-S01] — Bulk create users via script

As an onboarding / Tech Support operator, I want to bulk-create Qontak One users from a supplied list, so that I can onboard large teams (>100 users) without inviting each user individually.
Could HaveTriggered when a CID needs to add >100 users. Operator-run script, not an end-user UI.— Happy Path —
• AC-1: Given a valid input list of users for a target Qontak One CID, when the script runs, then each user is created under that CID.
• AC-2: Given the script completes, when it finishes, then it reports a per-user result (created / skipped / failed) so the operator can verify the outcome.
— Error / Unhappy Path —
• ERR-1: Given an input row that is invalid or already exists, when the script processes it, then that row is skipped with a reason and the run continues for the remaining rows.

Open questions

  1. Input format — CSV upload, spreadsheet, or a defined schema?
  2. What user attributes are required per row (email, name, role/team)?
  3. Does bulk creation send invitation emails, or create users in a pending state?
  4. Should the same email-uniqueness validation apply (see launchpad-email-validation-one-cid)?