Google Chat
Install the SigSentry Google Chat bot using a service account
Install the SigSentry bot in Google Chat to run analyses with /sigsentry
in a space.
Prerequisites
| Need | Notes |
|---|---|
| Google Workspace | Google Chat enabled |
| Permission to add apps | Workspace admin or space admin |
| At least one project in SigSentry | Logs and (optionally) repos connected |
Setup walkthrough
Click "Install Google Chat" in SigSentry
Go to Settings → Integrations → Google Chat → Install. You'll be redirected to Google's OAuth flow.
Authorize on Google's side
Google asks you to authorize the SigSentry bot for your domain. This adds the bot as available to all spaces in the workspace; individual spaces still need to add it explicitly.
Click Allow.
Add the bot to a space
In Google Chat, open the space you want the bot in. Click the space name → Apps & integrations → Add apps → SigSentry → Add.
Return to SigSentry
The connected workspace appears under Settings → Integrations → Connected workspaces.
Run a test command
In a space where the bot is added, type:
@SigSentry analyze test smoke last 1 hourThe diagnosis posts as a card response within 30–60 seconds.
Command syntax
@SigSentry analyze <description> <time-expression> [--project=<slug>]
@SigSentry help
@SigSentry projectsSee Command grammar.
Threading
Google Chat threads work like Slack threads — follow-up messages in the same thread continue the analysis context.
Identity mapping
Google Chat exposes user emails by default, so SigSentry can map them to your tenant's users. Users with matching emails get full attribution; non-matched users see analyses attributed to the installer identity.
Revoking access
| For | Action |
|---|---|
| Whole workspace | Google Workspace admin → Apps → Google Chat apps → SigSentry → Disable |
| Specific space | Space → Apps & integrations → SigSentry → Remove |
| SigSentry-side | Settings → Integrations → Connected workspaces → Disconnect |
Troubleshooting
| Symptom | Likely cause |
|---|---|
| Bot not responding | Not added to that space, or workspace policies blocking apps |
| Bot intermittently fails to respond | Transient — try again in a minute. If persistent, contact support |
| Workspace admin restrictions | Some workspaces restrict third-party apps; ask your admin to allow SigSentry |