With the Google Chat integration, you can use the Backlog app to add an issue in Backlog and receive real-time notifications about Backlog issues.
Did you know?
- You need permission from your Google Workspace administrator to install apps.
- This feature is available for all user roles in Backlog. Some functions may not work for a particular user if any restrictions are applied to them in Backlog.
Connect Google Chat with Backlog
There’re a few ways to add the Backlog app to your Google Chat.
- Add via inputting “@backlog“ within the chat.
- Add via Find apps function.
A message will indicate that the Backlog app has been added to the chat/space.
Useful tip!
There are also other ways to add apps to Google Chat. For more details, see the Google Chat help article.Backlog app commands
After adding the Backlog app to your Google chat or space, you can perform certain Backlog actions using commands in Google Chat.
The commands you can use with the Backlog app are:
|
Command |
Action |
|
/login |
Log in to your Backlog account |
|
/logout |
Log out from the current Backlog account |
|
/settings |
Manage notification settings |
|
/addissue |
Add an issue to Backlog |
|
/help |
Show help list |
|
/language |
To change the language of the bot |
Useful tip!
Some return messages will indicate “Only visible to you.” This happens when executing a slash command (e.g.,/login) in Google Chat. It helps reduce noise to other members when you perform your command within the chat/space.
Did you know?
- You can only log in to a single Backlog space at a time.
- To add an issue, add or delete notification settings, you will need to log in to your Backlog account first via the app.
Login command
To use the Backlog app in Google Chat, you will first need to authenticate and login to your Backlog space. Log in to Backlog using the “login” command.
- Enter “/login” in the chat/space, and a configuration dialog will prompt. Click Configure access button.
- A new window will prompt. Enter your space ID and select the correct domain. Click the Continue button to proceed.
- On the access confirmation page, select the Allow button. A successful login message will display in Google Chat if you have logged in successfully.
Please refer to the Space ID support article to learn more about Space ID.
Logout command
You can log out of the Backlog app using the “logout” command.
- Enter “/logout” in the chat/space.
- A successful logout message will display when the logout is complete.
Did you know?
If the Backlog project notifications setting has been set, notifications will not be reset or turned off when you’ve logged out using the command. To remove the notifications, refer to this section.Settings command
With the settings command, you can add project notifications to your Google Chat or delete the notifications there.
Add notifications in Google Chat
You can receive real-time notifications from Backlog projects in Google Chat by adding notifications for Backlog projects using the “settings” command.
- Enter “/settings” in the chat/space.
- Add notification window will pop-up. Select the project from the drop-down list and click the Add notification settings button.
Useful tip!
If a project’s notification settings have been added within the chat/space, it will pop-up a notification settings window. To add another new project notification, click Add notification settings button > select a project > click Add notification settings button.
Did you know?
Only the administrator or project administrator can add the notification settings for projects that they have access to. Unauthorized projects will not appear in the project selection dialog.Delete notification in Google Chat
You can delete a Google chat/space notification settings for Backlog projects using the “setting” command.
- Enter “/settings” in the chat/space.
- Notification settings window will pop up. Select Delete to remove the respective project notification within the chat/space.
Did you know?
Only the administrator or project administrator can delete the notification settings for projects they have access to. Unauthorized projects will not appear in the project selection dialog.Update notification settings on Backlog project settings
If you have added Google chat/space notification settings for a project, you can update them at the respective project settings page on Backlog.
- Go to the Backlog project, select Project Settings > Integrations > click Settings at the Google Chat option.
- On the integration settings page, click the Edit button.
- Edit the language and description, and select the checkboxes for events you wish to receive notifications for on Google Chat. Click the Save button to apply the changes.
Useful tip!
“Language” setting refers to the language of the notifications sent to the Google Chat. “Description” setting can be used for describing the integration.Did you know?
You cannot change the notification destination (chat/space) using the integration settings page here. If you wish to change the notification destination, please delete the current notification settings and re-add the notification settings in another Google chat/space.Delete notification settings from Backlog project settings
Besides deleting the project notifications via Google Chat, you can delete them from the project settings page on Backlog.
- Go to the Backlog project, select Project Settings > Integrations > click Settings from the Google Chat integration.
- On the integration settings page, click the Edit button.
- Click the Delete button to remove the notification settings.
Add issue command
You can quickly add an issue to your Backlog project using the “/addissue” command.
- Enter “/addissue” in the chat/space.
- Add issue window will pop up. Select the project from the drop-down list and click the SELECT PROJECT button.
- Enter your issue details and click the ADD ISSUE button.
- When the issue is added, an issue-added message will display in the chat.
Useful tip!
Clicking “View (issue) in Backlog” will navigate you to the registered issue page in Backlog in a new window.
Did you know?
- If a member or guest role has been set to “view only” restriction, they are unable to use the add issue function.
- You can’t add issues via Google Chat to projects that have custom field(s) set as mandatory. Projects that have set customs field(s) as mandatory will not appear in the project selection dialog.
Help command
You can view the list of supported app commands in Google Chat by entering “/help” in the chat/space.
Language command
You can change the Backlog app command language in Google Chat by entering “/language” in the chat/space. A language settings dialog will prompt. Select a language and click the SET LANGUAGE button.
Did you know?
- Backlog only supports English and Japanese language settings.
- This setting only affects the Backlog app commands in Google Chat. The language settings will not affect the Google Chat language settings.
- To change the language of the project notifications, please update the language settings from the Project Settings, Integration page.