Skip to content

How to Sync 4Geeks Perks Data with Slack or Microsoft Teams

🤖 Explain with AI

Integrating 4Geeks Perks with your organization’s communication platforms—Slack or Microsoft Teams—keeps your workforce engaged by bringing perk notifications, balance updates, and recognition directly into their daily workflow. Instead of requiring employees to log in to a separate portal to check their status, you can push relevant data to where they already collaborate.

This article explains how to configure these integrations using the 4Geeks Console to automate notifications and streamline perk visibility.

Prerequisites

Before setting up the sync, ensure you meet the following requirements:

  • Active Admin Account: You need administrative access to the 4Geeks Console.
  • 4Geeks Perks Subscription: The 4Geeks Perks module must be active on your account.
  • Platform Permissions: You must have “Admin” or “App Manager” permissions in your Slack Workspace or Microsoft Teams Tenant to install third-party applications.
  • Standard or Premium Plan: Integrations with Slack and MS Teams are standard features available in most plans.

Step-by-Step Configuration

Follow these steps to connect your 4Geeks Perks account with your preferred communication tool.

Step 1: Access the Integrations Hub

  1. Log in to the 4Geeks Console.
  2. Navigate to the Perks module from the main dashboard.
  3. Click on Settings and select the Integrations tab. This section lists all available connectors, including HRIS systems, Payroll Software, and communication tools.

Step 2: Connect to Slack or Microsoft Teams

  1. Locate the Communication section within the Integrations tab.
  2. Click Connect next to either “Slack” or “MS Teams”.
  3. You will be redirected to the respective platform’s authorization page (e.g., “Allow 4Geeks to access your Slack workspace”).
  4. Review the requested permissions (typically for posting messages and reading user emails for mapping) and click Allow or Authorize.

Step 3: Configure Notification Events

Once connected, you must define what data triggers a notification.

  1. Return to the Integrations configuration page in the 4Geeks Console.
  2. Select the Events you wish to sync. Common options include:
    • Wallet Funded: Notify employees when monthly points are allocated.
    • Perk Redeemed: Trigger an update when a perk is successfully claimed.
    • Low Balance Warning: Alert users when their wallet runs low.
  3. Choose the Destination:
    • Direct Message (DM): Best for private alerts like wallet balances.
    • Public Channel: Best for “New Perk Added” announcements or celebrating team rewards.

To ensure messages reach the correct employees, the system matches users based on email addresses.

  1. In the User Mapping section, click Sync Users.
  2. The system will compare email addresses in 4Geeks Perks with those in your Slack/Teams workspace.
  3. Review any unmatched users and manually map them if necessary (e.g., if an employee uses a different alias).

Common Use Cases

Scenario 1: Automating “New Perk” Announcements

  • Situation: You added a new “Self-serve market” or “Electric car charging” benefit to your catalog.
  • Configuration: You set up a rule to post to the #general or #company-announcements channel whenever a new item is added to the catalog.
  • Result: Employees are instantly aware of the new benefit without needing an email blast, driving immediate adoption and engagement.

Scenario 2: Real-Time Balance Checks via AI Agents

  • Situation: An employee wants to know if they have enough points for a lunch voucher but doesn’t want to log in to the web portal.
  • Configuration: By integrating 4Geeks AI Agents with Slack/Teams, employees can simply type /4geeks balance or ask the bot “How many points do I have?”.
  • Result: The bot retrieves the real-time balance from the 4Geeks Perks wallet and responds privately in the chat.

Troubleshooting

Issue 1: Notifications are not appearing in the channel

  • Cause: The 4Geeks bot may not have been invited to the specific private channel.
  • Solution: In Slack or Teams, go to the channel settings and “Add App” or “Invite” the 4Geeks bot. Public channels usually work without manual invitation if global permissions were granted.

Issue 2: “User Not Found” errors for Direct Messages

  • Cause: The employee’s email address in 4Geeks Perks does not match their email in Slack/Teams.
  • Solution: Go to User Mapping in the integration settings. Ensure the email addresses match exactly. If they differ, update the profile in 4Geeks Perks to match the communication platform.

Issue 3: Integration disconnects frequently

  • Cause: The admin user who authorized the integration may have lost permissions or had their password changed.
  • Solution: Re-authorize the connection in the Integrations tab using a service account or an admin account with permanent privileges.

Conclusion

Syncing 4Geeks Perks with your communication tools transforms benefits from a passive “portal” into an active part of your company culture. By automating updates and enabling chat-based interactions, you ensure your investment in employee well-being is visible, accessible, and utilized.

Need deeper customization? Explore our Custom API documentation to build bespoke integrations for your unique workflows.