Skip to content

Support

Jump to bottom
Rob Lazzurs edited this page Jan 15, 2026 · 2 revisions

Support for OnCall Notify

Need help with OnCall Notify? We're here to assist you!

📋 Getting Support

GitHub Issues (Recommended)

For bug reports, feature requests, or technical issues, please use GitHub Issues:

Open a GitHub Issue

This is the fastest way to get help because:

  • ✅ The development team monitors issues daily
  • ✅ Other users can benefit from solutions
  • ✅ You can track progress on fixes
  • ✅ Community members can help troubleshoot

Before Opening an Issue

Please check if your question has already been answered:

🐛 Reporting Bugs

When reporting a bug, please include:

  1. macOS Version: (e.g., macOS 14.2 Sonnet)
  2. App Version: (found in Settings or About)
  3. Distribution Method: (Mac App Store or Direct Download)
  4. Steps to Reproduce: What you did before the bug occurred
  5. Expected Behavior: What should have happened
  6. Actual Behavior: What actually happened
  7. Screenshots: If applicable

Example Bug Report:

**Bug**: App crashes when clicking Settings

**Environment:**
- macOS: 14.2 (Sonnet)
- OnCall Notify: v0.16.0
- Distribution: Direct Download from GitHub

**Steps to Reproduce:**
1. Click the menu bar icon
2. Click the gear icon (Settings)
3. App crashes immediately

**Expected**: Settings window should open
**Actual**: App crashes

**Screenshot**: [attached]

Create Bug Report

💡 Feature Requests

Have an idea to improve OnCall Notify?

  1. Check if it's already requested in existing issues
  2. If not, open a new feature request
  3. Describe the feature and why it would be useful

We love hearing from users about what features would help them most!

🔐 Security Issues

Do NOT open public GitHub issues for security vulnerabilities.

If you discover a security issue:

  1. Email: rob@unicornops.ie
  2. Subject: "Security: OnCall Notify"
  3. Include detailed description of the vulnerability
  4. We will respond within 48 hours

Or use GitHub Security Advisories for private reporting.

📚 Documentation

Comprehensive documentation is available:

🆘 Common Issues

App doesn't show any data

  1. Verify you've entered a valid API token in Settings
  2. Click "Test Connection" to verify the token works
  3. Check your internet connection
  4. Ensure your service account has active incidents or schedules

Connection test fails

  • Verify the API token is correct and hasn't been revoked
  • Check network access to the service API
  • Review firewall or VPN settings
  • Ensure the token has proper permissions

Menu bar icon doesn't appear

  • Verify the app is running (check Activity Monitor)
  • Try quitting and restarting the app
  • Check macOS menu bar icon settings

📞 Direct Contact

For non-technical inquiries, privacy questions, or other matters:

Email: rob@unicornops.ie

Response Time: We aim to respond within 3-5 business days

Note: For technical issues, GitHub Issues will get you a faster response.

🌟 Community Support

OnCall Notify is open source! The community can help:

  • GitHub Discussions: Ask questions and share knowledge
  • Issue Comments: Help others with similar problems
  • Pull Requests: Contribute fixes and features

📱 App Store Reviews

If you downloaded from the Mac App Store:

  • ⭐ Please leave reviews in the App Store
  • 💬 We respond to App Store reviews, but can't troubleshoot there
  • 🐛 For detailed support, please use GitHub Issues

🔄 Response Times

Channel Typical Response Time
GitHub Issues 1-2 business days
GitHub Discussions 2-3 business days
Security Email Within 48 hours
General Email 3-5 business days
App Store Reviews 5-7 business days

🛠️ Self-Service Resources

API Token Setup

PagerDuty:

  1. Log in to PagerDuty
  2. User Settings → API Access Keys
  3. Create API User Token
  4. Copy and paste into OnCall Notify Settings

Resetting the App

To start fresh:

  1. Open Settings in OnCall Notify
  2. Click "Delete Token" for all services
  3. Quit and relaunch the app

Checking App Version

  1. Click menu bar icon
  2. Look at the top of the menu (shows version)
  3. Or check "About" in Settings

🚀 Contributing

Want to help improve OnCall Notify?

  • Report Bugs: Help us fix issues faster
  • Suggest Features: Share your ideas
  • Contribute Code: Submit pull requests
  • Improve Docs: Help make documentation clearer
  • Answer Questions: Help other users in Discussions

📖 Additional Resources

💬 Feedback

We value your feedback! Let us know:

  • What features you love
  • What could be improved
  • What services you'd like to see supported
  • Any other thoughts

Quick Links

Thank you for using OnCall Notify! We're committed to making your on-call experience better.

Clone this wiki locally