Setup guide
Google Chat Notifications for Jira takes about five minutes to set up. You need to be a Jira admin, and a member of the Google Chat space you want to post to.
1. Create a webhook in Google Chat
- Open the Chat space that should receive notifications.
- Click the space name, then Apps & integrations.
- Under Webhooks, click Add webhooks, give it a name such as "Jira", and save.
- Copy the webhook URL from the webhook's menu.
Webhooks are available in Google Workspace accounts, not personal Gmail accounts. If the Webhooks option is missing, your Workspace admin may have turned it off.
2. Create a rule in Jira
- In Jira, go to Settings → Apps → Google Chat notifications.
- Click Add rule and give it a name.
- Paste the webhook URL.
- Choose the events to send and any filters, then save.
- Click Send test. A sample message should appear in the space.
Rule options
| Option | What it does |
|---|---|
| Projects | Only issues in these projects. Empty means all projects. |
| Notify when | Issue created, status changed, assignee changed, priority changed, comment added, any other field changed, issue deleted. |
| Only when the status changes to | Limits status notifications to chosen statuses, for example Done. |
| Issue types | Only these issue types. Empty means all types. |
| Extra filter (JQL) | Only issues matching this JQL query, for example priority in (High, Highest). |
| Fields in the message | Status, assignee, priority, issue type, reporter, labels, due date. |
| Message style | A card with an "Open in Jira" button, or compact text. |
| Thread per issue | Keeps all updates to one issue in a single thread. |
Good to know
- Edited comments are not announced, only new ones.
- A rule with a JQL filter does not announce deleted issues, because a deleted issue can no longer be checked against the filter.
- Google Chat accepts about one message per second per space. During bulk changes the app retries, but some messages can be dropped.
- Each rule shows whether its last delivery worked. "Failing" with a "webhook rejected" message usually means the webhook was deleted in Chat; create a new one and paste it into the rule.
- Notifications go to spaces. Personal direct messages are not supported.
Permissions
| Permission | Why |
|---|---|
| Read Jira issue data | To build the message and to check filters. |
| Read Jira user profiles | To show the name of the person who made a change. |
| App storage | To save your rules and webhook URLs inside Atlassian's platform. |
| Connect to chat.googleapis.com | To deliver messages to Google Chat. This is the only outside address the app contacts. |
Help
Email support@tidelightlabs.com with your rule's settings and the error shown in its status.