Contents
Back to Dashboard

Standup Mate User Guide

Complete guide to using Standup Mate for automated team standups

StandUp Mate - User Troubleshooting Guide

When Users Can't Open Standup Modals

If a user reports they cannot open their standup when clicking the "Start Standup" button, here are the steps to diagnose and fix the issue:

Immediate Diagnosis

Run the diagnostics tool to check the user's status:

``bash

python slack_diagnostics.py diagnose

`

This will show:

  • Whether the user is included in active standups
  • If they've already submitted responses
  • Slack workspace permissions
  • Recommendations for fixing the issue

Common Issues and Solutions

1. User Already Submitted

Symptom: User sees "Already Submitted ✅" button Solution: This is normal - user has already completed their standup for today

2. Slack Modal Not Opening

Symptoms:
  • Button clicks but nothing happens
  • Modal doesn't appear
Solutions:
  1. Refresh Slack: Ask user to refresh their Slack client
  2. Resend Standup: Use the resend command:

`bash

python slack_diagnostics.py resend

`

  1. Check App Permissions: Verify StandUp Mate has proper workspace permissions
  2. Reinstall App: If persistent, remove and re-add the Slack app

3. Network/Connectivity Issues

Symptom: Intermittent failures Solution: These usually resolve automatically. Try resending the standup.

4. User Not Found in Workspace

Symptom: Diagnostics shows "User not found in workspace user list" Possible Causes:
  • User has restricted permissions
  • User is in private channels not visible to bot
  • Rate limiting from Slack API
Solutions:
  • Check if user is actually in the workspace
  • Verify bot has access to channels where user is a member
  • Wait and try again if rate limited

Step-by-Step Resolution Process

  1. Run Diagnostics:

`bash

python slack_diagnostics.py diagnose

`

  1. If user hasn't responded, try resending:

`bash

python slack_diagnostics.py resend

`

  1. If still failing:

- Ask user to refresh Slack

- Check if user can see the StandUp Mate app in their workspace

- Verify app permissions in Slack admin settings

  1. Last resort:

- Remove and reinstall the StandUp Mate app in the workspace

- This will require re-authentication

Prevention Tips

  • Monitor the application logs for interaction errors
  • Set up alerts for failed standup deliveries
  • Regular health checks on Slack API connectivity
  • Keep the app permissions up to date

Getting User IDs

To find a user's Slack ID:

  1. Go to the user's Slack profile
  2. Click "More" → "Copy member ID"
  3. Or check the standup logs for their ID when standups are sent

5. "Unknown User" Display Issues

Symptom: Standup responses show "Unknown User" or "User-XXXX" instead of real names Causes:
  • Slack API rate limiting during high usage
  • Bot token missing user read permissions
  • Network connectivity issues
Solutions:
  1. Wait for rate limits to clear (usually resolves in 1-2 minutes)
  2. Refresh user cache:

`bash

python fix_user_display.py

`

  1. Check bot permissions in Slack app settings
  2. Update OAuth scopes to include users:read

6. Non-Clickable Standup Buttons

Symptom: Users can see standup message but "Start Standup" button doesn't work Root Cause: Slack app Interactive Components not configured Solutions:
  1. Configure Interactive Components:

- Go to https://api.slack.com/apps

- Select your StandUp Mate app

- Go to "Interactivity & Shortcuts"

- Turn ON "Interactivity"

- Set Request URL: https://your-domain.replit.app/slack/interactive

- Save changes

  1. Verify OAuth scopes include:

- chat:write

- im:write

- channels:read

- users:read

  1. Reinstall app if needed after scope changes

Example Workflow for Joseph's Issue

`bash

1. Diagnose the problem

python slack_diagnostics.py U016XUR9PAQ diagnose

2. Try resending if needed

python slack_diagnostics.py U016XUR9PAQ resend

3. Check logs for any errors

grep -i "U016XUR9PAQ" logs/*.log

4. Fix user display issues

python fix_user_display.py

``

This should resolve most standup modal issues users encounter.