Group Troubleshooting

Diagnose and resolve common employer group issues and configuration problems efficiently. This guide provides systematic troubleshooting approaches for member access issues, engagement discrepancies, configuration conflicts, and integration problems.

This guide provides systematic troubleshooting approaches for resolving employer group issues, from member access problems to engagement discrepancies and configuration conflicts.

Before You Begin

Always verify your access level and permissions before making changes to employer group settings. Document all troubleshooting steps and resolutions for future reference and team knowledge sharing.

Common Group Issues

Common Group Problems

Member Access Issues

Members from an employer group are receiving "access denied" errors or unable to log into the platform.

Example:

Diagnosis Steps: Check group status → Verify group is enabled → Check member eligibility → Review access permissions → Test with sample member account

Engagement Discrepancies

Engagement reports show unexpected numbers or don't match client expectations for participation rates.

Example:

Verification Process: Compare report dates → Check eligibility data sync → Verify member import completion → Review engagement definitions → Regenerate with correct parameters

Configuration Conflicts

Group settings appear incorrect, features aren't working as expected, or customizations aren't displaying properly.

Example:

Resolution Steps: Review group configuration → Check feature toggles → Verify customizations → Test in member view → Apply corrections

Rewards Integration

MyMedicalRewards points aren't being awarded correctly or reward system integration is malfunctioning.

Example:

Troubleshooting Steps: Check reward configuration → Verify point rules → Test reward scenarios → Review integration logs → Sync reward data

Systematic Troubleshooting Approach

General Troubleshooting Process
1
Gather Information
Collect specific error messages, affected user details, and reproduction steps from the reporting party.
2
Identify Scope
Determine if the issue affects one member, multiple members, or the entire employer group.
3
Check Group Status
Navigate to Employers tab and verify the group's enabled/disabled status and configuration.
4
Review Recent Changes
Check for any recent modifications to group settings, user permissions, or platform updates.
5
Test and Verify
Use impersonation or test accounts to reproduce the issue and confirm the problem.
6
Apply Solution
Implement the appropriate fix based on your diagnosis and test the resolution.
7
Document Resolution
Record the issue, steps taken, and final resolution for future reference.

Member Access Troubleshooting

When members cannot access the platform, follow this systematic approach:

Access Issue Checklist

  • Group Status: Verify the employer group is enabled in the system
  • Member Eligibility: Confirm the member appears in the eligibility data
  • Account Creation: Check if the member has successfully created their account
  • Password Issues: Verify the member isn't experiencing password-related problems
  • Browser/Technical: Rule out browser compatibility or technical issues

Step-by-Step Access Diagnosis

  1. Navigate to Employers: Go to the Employers tab and locate the affected group
  2. Check Group Status: Ensure the group status shows as "Enabled"
  3. Search for Member: Use the Members search to locate the specific member
  4. Review Member Profile: Check eligibility status, account creation date, and recent activity
  5. Test Access: Use impersonation (if available) or have the member attempt login while you observe
  6. Apply Fix: Enable the group, update member eligibility, or guide member through account recovery

Engagement Report Issues

Engagement discrepancies often stem from data synchronization, reporting period mismatches, or definition misunderstandings:

Engagement Verification Process
1
Verify Report Parameters
Confirm the date range, group selection, and engagement metrics match expectations.
2
Check Data Sync Status
Ensure eligibility data and member imports have completed successfully.
3
Compare Definitions
Review how engagement is defined (logins, searches, actions) versus client expectations.
4
Cross-Reference Data
Compare engagement numbers with member activity logs and usage patterns.
5
Regenerate Reports
Create fresh reports with corrected parameters to verify accuracy.

Configuration Troubleshooting

Configuration problems can affect member experience, feature availability, and platform customizations:

Configuration Best Practices

Always test configuration changes in a member view before confirming they're working correctly. Use impersonation to see exactly what members will experience with your settings.

Common Configuration Problems

  • Missing Features: Features expected by the client aren't visible or accessible
  • Incorrect Branding: Group-specific branding or customizations aren't displaying
  • Wrong Network Data: Incorrect provider networks or pricing information
  • Integration Issues: Third-party integrations not functioning properly

Quick Reference Guide

Issue TypeFirst CheckCommon CauseQuick Fix
Access DeniedGroup enabled statusGroup disabledEnable group
Low EngagementDate range settingsWrong reporting periodAdjust date range
Missing FeaturesGroup configurationFeature not enabledEnable feature toggle
Rewards Not WorkingReward configurationIntegration disabledEnable rewards

When to Escalate

Some issues require escalation to higher support tiers or technical teams:

Escalation Triggers

  • System-wide Issues: Problems affecting multiple employer groups simultaneously
  • Data Corruption: Eligibility or member data appears corrupted or inconsistent
  • Integration Failures: Third-party system integrations are completely non-functional
  • Security Concerns: Potential security vulnerabilities or breach indicators
  • Platform Bugs: Suspected software defects requiring development attention
  • Network Issues: Network assignment issues requiring updated network mapping