feat(notifications): add Google Chat/Spaces as notification provider #3278
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add Google Chat/Spaces webhook integration for receiving deployment and system notifications. Users can configure a Google Chat incoming webhook URL to receive formatted notifications for all Dokploy events. Changes include: - Database schema with googleChat table and notificationType enum - Service layer with create/update functions - API routes for create, update, and test connection - Event handlers for all notification types (build success/error, database/volume backup, docker cleanup, dokploy restart, server threshold) - Frontend icon and form handling Closes Dokploy#3153
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds Google Chat (Spaces) as a new notification provider to Dokploy, following the webhook-only Lark implementation pattern. Users can now configure Google Chat incoming webhooks to receive formatted notifications for all supported Dokploy events including deployments, backups, and system alerts.
Key Changes:
- Added complete Google Chat notification provider support with database schema, service layer, API endpoints, and utility functions
- Integrated Google Chat notifications across all 7 notification event handlers (build success/error, database/volume backup, Docker cleanup, Dokploy restart, server threshold alerts)
- Added frontend UI components including GoogleChatIcon and full form support in notification settings
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| packages/server/src/db/schema/notification.ts | Added googleChat table schema, enum value, and API validation schemas (apiCreateGoogleChat, apiUpdateGoogleChat, apiTestGoogleChatConnection) |
| packages/server/src/services/notification.ts | Implemented createGoogleChatNotification and updateGoogleChatNotification functions with transaction-based database operations; added googleChat to findNotificationById relations |
| apps/dokploy/server/api/routers/notification.ts | Added createGoogleChat, updateGoogleChat, and testGoogleChatConnection tRPC endpoints with proper authorization checks; included googleChat in notification listing |
| packages/server/src/utils/notifications/utils.ts | Implemented sendGoogleChatNotification function following the Lark pattern with basic error handling |
| packages/server/src/utils/notifications/build-success.ts | Added Google Chat support for build success notifications with formatted message including project, application, environment details and build link |
| packages/server/src/utils/notifications/build-error.ts | Added Google Chat support for build error notifications with truncated error messages (500 char limit) |
| packages/server/src/utils/notifications/database-backup.ts | Added Google Chat support for database backup notifications (success/error) with status emojis and error message handling |
| packages/server/src/utils/notifications/volume-backup.ts | Added Google Chat support for volume backup notifications including backup size and error information |
| packages/server/src/utils/notifications/dokploy-restart.ts | Added Google Chat support for Dokploy server restart notifications |
| packages/server/src/utils/notifications/docker-cleanup.ts | Added Google Chat support for Docker cleanup notifications with cleanup message details |
| packages/server/src/utils/notifications/server-threshold.ts | Added Google Chat support for server threshold alerts (CPU/Memory) with current values and thresholds |
| apps/dokploy/components/icons/notification-icons.tsx | Added GoogleChatIcon component with official Google Chat branding colors |
| apps/dokploy/components/dashboard/settings/notifications/handle-notifications.tsx | Added full Google Chat UI support including schema validation, mutation hooks, form fields, connection testing, and notification type mapping |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Changes
Backend
googleChattable, enum value, and API schemascreateGoogleChatNotificationandupdateGoogleChatNotificationfunctionscreateGoogleChat,updateGoogleChat,testGoogleChatConnectionendpointssendGoogleChatNotificationfunctionEvent Handlers
Updated all 7 notification event files to support Google Chat:
Frontend
GoogleChatIconcomponentTest plan
pnpm --filter dokploy run migration:generateRelated Issue
Closes #3153