The setup checklist
Member·3 minutes to read
When something you set up needs a few more pieces before it works — a bot you installed from a template that uses a plugin, a secret or a file you have not provided yet — Botseon shows a setup checklist above the conversation. It lists every piece as one step, in order, and tells you which one to do next.
The four states
Every step is always in exactly one of four states, shown as an icon and a word:
| State | What it means |
|---|---|
| Not started | Nothing has been checked for this step yet. |
| Checking | Botseon is checking the step right now. A "Checking…" line shows under it until the check answers. |
| Done | The step's live check passed: the thing it names works. |
| Failed | The step's check did not pass. The step says why, and what to do about it. |
A failed step always carries both a reason (for example "gmail is not installed yet." or "The check timed out") and a fix — one sentence, and sometimes a button that takes you straight to it.
Why a step ticks itself
There is no box to tick. A step turns Done by itself, and only when its live check passes on Botseon's side: the plugin is installed, the secret holds a value, the file is attached. Marking a step done by hand would only make the checklist look finished; a checklist that ticks itself tells you the setup actually works before you walk away.
The checks run when the checklist opens, again when you come back to the window after fixing something elsewhere, and every few seconds while a step is still not done. A check that errors or does not answer in time leaves its step Failed with that reason — never Done.
One button at a time
The checklist offers exactly one action button, on the first step that is not done yet. On a failed step the button is the fix's own action when it has one. Do that step, come back, and the next step's button appears once the check has passed.
On your phone
The Botseon app shows the same checklist, with the same four states, the same "Checking…" line and the same single button. If your phone talks to an older Botseon server that does not report step states yet, the app shows the plain list of what is missing instead.
Read next
Last verified against build 15cebcd.