ChatBridge documentation

Everything you need to connect Jira Cloud to Google Chat.

Requirements

1. Create a webhook in Google Chat

  1. Open the Google Chat space that should receive Jira updates.
  2. Click the space name at the top → Apps & integrations → Webhooks.
  3. Click Add webhook, name it (for example "Jira") and save.
  4. Copy the webhook URL. It starts with https://chat.googleapis.com/v1/spaces/.

Treat the URL like a password. Anyone who has it can post to the space. ChatBridge stores it encrypted and never displays it again.

2. Add a rule in Jira

  1. In Jira, go to Settings (⚙) → Apps → ChatBridge for Google Chat.
  2. Enter a name, paste the webhook URL and choose the events:
    EventPosted when
    Issue createdA new issue is created.
    Status changedThe issue moves to another status, e.g. To Do → In Progress.
    Assignee changedThe issue is assigned or unassigned.
    Comment addedSomeone comments. The message includes the first 300 characters. Comments restricted to a role or group are announced without their text, and Jira Service Management internal notes are labelled "Internal note".
  3. Optionally add a JQL filter. Only issues matching it are posted. Leave it empty to post every issue.
  4. Click Save rule, then Send test to confirm the space receives messages.

JQL examples

GoalJQL
One projectproject = PAY
Urgent work onlypriority in (Highest, High)
Bugs in two projectsproject in (WEB, MOBILE) AND type = Bug
Exclude a confidential projectproject != LEGAL

You can create up to 50 rules, for example one per team space.

How messages behave

Troubleshooting

"Send test" says…What to do
Google Chat rejected the webhookCopy the full URL again from the space, including key= and token=. Delete the rule and add it again.
Webhook was removed or webhooks are disabledCheck the webhook still exists in the space, or ask your Workspace admin to allow incoming webhooks.
The Chat space no longer existsCreate a new webhook in an existing space.
Rate limitingWait a minute and try again.

Test works but no messages arrive? Check that the issue matches the rule's JQL and that the right events are selected.

Migrating from another Google Chat integration

Atlassian ends support for the older Connect app framework on January 31, 2027. If you use a Connect-based Google Chat integration, plan the switch before then.

  1. List the spaces your current integration posts to and what each one receives.
  2. Install ChatBridge and create one rule per space, translating your project or filter choices into JQL.
  3. Run both integrations for a few days and compare what each space receives.
  4. Remove the old integration's webhooks from your spaces, then uninstall it from Jira.

Uninstalling

Uninstall from Settings → Apps → Manage apps. Remove the webhooks from your Google Chat spaces as well. What happens to stored rules is described in our privacy policy.

Still stuck? Contact support.