InnerWeb
Skip to main content

Mass guest invitations: four checkpoints before the launch

Sending invitations to several dozen people at once looks like routine, yet it often causes the largest number of reports in the first week. The system has no bulk import, and the link can lead to a dead end. Four checkpoints the administrator should verify before the launch.

2 s
approximate time per account in the onboarding loop
Source: dokumentacja funkcji systemu
7 dni
validity of the activation link
Source: dokumentacja funkcji systemu

Stage: launch and the first wave of invitations

At the start of a rollout the administrator usually has a list of several dozen people from contractor companies who need access. They want to invite them all in one move. The system works differently than intuition suggests, so a few things need checking beforehand.

An invited person needs exactly one email. After the link is clicked, the system checks the state of the account: an overdue training first, then possibly joining the work, and finally setting a password. If any of these steps fails, the person gets stuck halfway.

Checkpoint 1: no bulk import

Mass invitations have no bulk import. Onboarding is a loop that creates an account and sends an invitation, roughly 2 seconds per account. For 60 people this is about 2 minutes of loop time, but preparing the list and checking the results takes considerably longer.

Practical conclusion: prepare the list in a single format, check for duplicates and send in batches, for example 20 people at a time, so that after each batch you can verify how many invitees actually received the link.

Onboarding loop time as the group grows

Onboarding loop time as the group growsLine chart: 40 seconds for 20 accounts, 80 for 40, 120 for 60 and 200 for 100 accounts.050100150200s20 accounts40 accounts60 accounts100 accounts20 accounts: 40 s4040 accounts: 80 s8060 accounts: 120 s120100 accounts: 200 s200
Source: Illustrative calculation: about 2 seconds per account

Checkpoint 2: no introductory training in the account language

When there is no active introductory training in the account language, the person goes straight to setting a password. It looks like a success, but in fact the guest skipped the training that the plant requires. Check the set of trainings in every account language before inviting the group.

Example: a group of contractors with Ukrainian-language accounts requires an active training in Ukrainian. The introductory training on the kiosk supports Polish, English, Ukrainian and Russian, but the invitations depend on the account language, so check both layers.

Checkpoint 3: the invitation depends on a third-party host

Training material fetched from an external video service can hang behind the plant firewall: loading lasts forever and never ends with an error. The invitation should not depend on a third-party host. The details of this mechanism are described on a separate page about introductory training behind the firewall.

Test before sending invitations: open the invitation link from a computer and a phone on the plant network and from a mobile network, and make sure the training loads in both cases.

Checkpoint 4: link expiry

The activation link is valid for 7 days. An expired or used link does not end with a 404 error, but with a redirect to the login page and a message. The invitee can request a new password link, but not everyone will: some people will assume something is broken and call the administrator.

Make sure invitations do not go out earlier than the guests will be on site, and that the group receives the link a few days before the first visit. Tell people whose link has expired that they will get a new link by email once they indicate they forgot the password.

Order of actions before the launch

First check the trainings in all account languages, then test the link on the plant network, next send the first batch of a few people, and only after confirming that it arrived and works, launch the rest. This rhythm costs a day, but saves a week of reports.

Checklist

Video

Frequently asked questions

Can 100 people be invited from one file?

There is no bulk import. Invitations are created by a loop that creates an account and sends an invitation, roughly 2 seconds per account.

What if training in the account language is missing?

The person goes straight to setting a password, skipping the training. That is why the set of trainings must be checked before inviting.

What does a person see after the link expires?

A redirect to the login page with a message, not a 404 error. They can request a new password link.

Plan the start of invitations with us

We will go through your list of people, the account languages and the link test on the plant network before the first wave.

Let's talk