Integrations
Google Chat
How to set up a Google Chat service account and connect it to Nova Admin.
Create a Google Cloud project, enable the Google Chat API, create a Chat app, configure its HTTP endpoint to /api/v1/webhooks/google_chat, and connect a service account with chat.bot scope. Once connected, Nova can receive messages and send replies, cards, and threaded messages.
Prerequisites
- A Google Chat project and appropriate IAM permissions.
- See Google Chat API docs for the specific roles and APIs required.
Steps
- Create or select a Google Cloud project and enable the Google Chat API.
- Create a Chat app (via Google Cloud Console → APIs & Services → Google Chat API → Configuration). Set the HTTP endpoint to https://your-host/api/v1/webhooks/google_chat.
- Create a service account in the same project, grant it access, and download its JSON key (project_id, client_email, private_key). Enable Domain-Wide Delegation if needed.
- Add the scope https://www.googleapis.com/auth/chat.bot to the service account / OAuth consent.
- In Nova Admin, open /agents/integrations, select Google Chat, and paste the service account JSON fields (Project ID, Service Account Email, Private Key, Project Number for JWT audience).
Credential fields
| Field | Required | Notes |
|---|---|---|
| GCP Project ID | No | my-project-123 |
| Project Number (Audience) | No | 123456789012 |
| Service Account Email | Yes | my-bot@my-project.iam.gserviceaccount.com |
| Private Key | Yes | Secret — stored encrypted. |
Troubleshooting
PERMISSION_DENIED: the service account is missing a required IAM role — review the steps above.invalid_grant: Invalid JWT: the private key was pasted with newlines stripped — re-paste from the original JSON.- Need help?: refer to the Google Chat documentation.