Setting up the ticket bot

The ticket bot is a dedicated Backlog user. Chronigami uses that user's API key to create issues when someone submits a form. You set it once per workspace.

#Why a bot user

Time tracking already connects people to Backlog with OAuth. Portal submissions do not use those connections. They always create issues as the ticket bot.

Use a user that exists only for this purpose, for example "Chronigami Portal". Do not reuse a person's account. If that person leaves, or you change their role to Viewer, forms stop creating issues.

One ticket bot maps to one connected Backlog space. Forms can target projects in that space only.

#Create the bot in Backlog

Do this in Backlog, signed in as a space administrator.

1. Create a Backlog user for the portal, for example "Chronigami Portal".
2. Add that user to each project that will receive requests. See Preparing Backlog.
3. Give that user a role that can add issues. Viewer cannot be used.
4. Sign in as that user and create an API key in personal settings. Copy the key. Backlog shows it once.

#Connect the bot to Chronigami

1. In the Chronigami web app, open the account menu and select Workspace settings.
2. Select the Portal tab.
3. Under Ticket bot, follow Set up a dedicated Backlog user if you have not created the Backlog user yet.
4. Choose the Backlog space. The list is the spaces already on Workspace settings → General under Connected spaces.
5. Paste the key into Backlog API key.
6. Select Save bot.

After a successful save you see Connected as the Backlog name and user id, the space URL, Role, and API key as •••• plus the last four characters. Chronigami never shows the full key again.

To use a different key, select Replace. To disconnect the bot, select Remove. Removing it does not delete forms, but they cannot create issues until you save a bot again.