Overview
This guide walks you through connecting Empuls with Google Workspace (Google Chat), so your employees can access recognition, rewards, and engagement features directly from their existing chat environment.
Once connected, the Empuls app becomes available in Google Chat spaces and direct messages, bringing recognition and engagement into the flow of everyday work.
What You Can Do with This Integration
Send appreciations and recognitions directly from Google Chat
Check notifications without leaving the conversation
Redeem rewards from within Google Chat
Use slash commands and bot interactions for quick actions
Keep recognition visible in team spaces so celebrations are shared where work happens
Who Should Use This Guide
This guide is intended for Empuls Administrators who have access to the Reports & Admin section of the Empuls platform.
Prerequisites
Before starting, ensure the following:
You have Admin access to Empuls (Reports & Admin section)
You have a Google Workspace account with admin privileges
Your organisation uses Google Chat
📝 Note: The Google Workspace integration is set up at the organization level. Only one admin needs to complete this setup for all employees.
Setting Up the Integration
Step 1: Navigate to integrations
Log in to Empuls and go to Reports & Admin from the left navigation panel.
In the admin panel, click Integrations from the left sidebar.
On the Integrations page, locate and click the Google Workspace tile to open its detail page.
Click the START SETUP button in the top-right corner of the page.
Step 2: Connect to Google Workspace
The Add Google Workspace screen will open with a two-step flow:
Step 1: Connect to Google Workspace
Step 2: Integration Complete
📝 Note: You will be redirected to Google to sign in and authorise Empuls for your organisation. After you allow access, you can add the Empuls app to chat spaces.
Click the Proceed button to be redirected to Google's sign-in page.
Step 3: Sign in with Google
You will be taken to Google's sign-in page. Enter the password for your Google Workspace admin account and click Next.
📝 Note: Use the Google Workspace admin account associated with your organization, not a personal Gmail account.
Step 4: Verify your identity
Google may prompt you to verify your identity. This is a standard account security step.
If prompted, Google will send a notification to your registered device. Tap Yes on the notification, then enter the verification code displayed on screen to confirm it is you.
If you do not have access to your device, tap Try another way to choose an alternative verification method.
Step 5: Install the Empuls app
After successful identity verification, Google will prompt you to install Empuls by Xoxoday from the Google Workspace Marketplace.
Click Install to add the app to your Google Workspace.
Review the permissions requested by the Empuls app.
Once installation is complete, you will be automatically redirected back to Empuls, and the setup will be marked as done.
Step 6: Complete the connection using the authorisation code
After the OAuth flow is complete, Empuls will display an authorisation code on the Google Workspace integration page.
Copy the authorisation code shown on the Empuls integrations page.
Open Google Chat and start a direct message with the Empuls bot.
Super admin needs to use the command /connect command to finish the integration
Your Google Workspace is now linked to Empuls. All users in your workspace will start receiving notifications and can use Empuls features directly from Google Chat.
📝 Note: Only a Super Admin in Empuls can run the /connect command. The authorisation code is unique to your setup — do not share it externally.
Step 7: Activate Empuls in Google Chat
Once the integration is active, employees can start using Empuls directly within Google Chat.
Open Google Chat and navigate to any space or start a direct message.
Click the + icon or use the Apps menu to find and add the Empuls app to the space.
Alternatively, use the slash command /empuls in any Google Chat message box to trigger the Empuls bot.
Employees can also start a direct message with the Empuls bot to send recognitions, check notifications, or redeem rewards.
📝 Note: Employees do not need to set up anything individually. Once the admin completes the integration, the Empuls app is available across the organisation's Google Workspace.
Confirming the Integration is Active
Once setup is complete, navigate back to the Google Workspace integration page in Empuls (Reports & Admin → Integrations → Google Workspace).
The integration status indicators will update to reflect a successful connection:
OAuth Status | Completed |
Marketplace Status | Installed |
Connection Status | Connected |
The page header will also show Active in green. A confirmation message will read: Setup completed. The Empuls app is installed from the Marketplace and ready to use in Google Chat.
Managing the Integration
Redo OAuth
If you need to re-authorise the Google connection (for example, after a password change or permission update), click the Redo OAuth button on the integration detail page. This will restart the Google sign-in flow without removing the integration.
View in Marketplace
To verify or manage the Empuls app installation in the Google Workspace Marketplace, click View in Marketplace. This opens the Marketplace listing for the Empuls app in a new tab.
Stop the Integration
To disconnect Empuls from Google Workspace, click the Stop Integration button in the top-right corner of the integration detail page. The status will revert to Inactive, and employees will no longer be able to use Empuls features from Google Chat.
📝 Note: Stopping the integration does not delete any Empuls data. It only removes the Google Chat connection. You can reconnect at any time by clicking START SETUP again.
Troubleshooting
Issue | Recommended Action |
OAuth Status shows as Incomplete | Click Redo OAuth and re-authorise with your Google admin account. |
Marketplace Status shows as Not Installed | Click View in Marketplace and use Admin Install to add the Empuls app to your Google Workspace. |
Integration is Active but employees cannot see the app in Google Chat | Invite the Empuls bot to a space, or start a DM with the bot to activate it for employees. |
Google sign-in redirects or fails | Ensure you are signed in with a Google Workspace admin account, not a personal Gmail. Clear browser cookies and try again. |
Learn more: How to use Google Chat
Need Help?
If you encounter any issues not covered in this guide, reach out to the Empuls support team: Email: [email protected]