Troubleshooting Guide

If you're experiencing issues with Zenfl Job Alerts, this guide will help you identify and resolve the most common problems. If your issue isn't covered here, please contact our support team for personalized assistance.

Not Receiving Job Alerts

Problem: No Alerts From a New Feed

If you've created a new feed but aren't receiving any alerts:

1. Check the Jobs Tab:

   • Open the mini-app and go to the "Jobs" tab
   • If no jobs appear, your filters may be too restrictive

2. Verify Feed Status:

   • Send /feeds command to see if your feed is paused
   • Look for the pause/play icon and ensure it's set to "active"

3. Review Strict Mode Setting:

   • Check if strict mode is enabled
   • Disable it to receive jobs that might be missing some filter data

4. Check Keyword Filters:

   • Make sure you're using the ALL/ANY/NONE conditions appropriately
   • Using "ALL" with multiple keywords may be too restrictive

5. Wait for New Jobs:

   • Alerts only come from new jobs posted after your feed is created
   • It may take some time for matching jobs to appear on Upwork

Problem: Alerts Suddenly Stopped

If you were receiving alerts but they suddenly stopped:

1. Check Telegram Settings:

   • Ensure you haven't blocked or muted the bot
   • Verify Telegram notifications are enabled for the bot

2. Verify Feed Status:

   • Send /feeds command to check if your feed was accidentally paused
   • Check if your subscription is still active

3. Ensure Bot is Working:

   • Send a simple message to the bot to see if it responds
   • Check our Status Page for any system outages

4. Check for Feed Changes:

   • If you recently edited your feed, it may have become too restrictive
   • Use the "Jobs" tab to verify jobs are matching your criteria

Feed Configuration Issues

Problem: Too Many Irrelevant Jobs

If you're receiving too many irrelevant job alerts:

1. Use Exclusion Filters:

   • Add keywords to the "NONE" section to exclude irrelevant jobs
   • Example: Add "wordpress", "php" to NONE if you don't work with those technologies

2. Enable Strict Mode:

   • This ensures you only receive jobs with complete information matching your criteria

3. Refine Client Filters:

   • Add minimum client rating requirements (e.g., 4.5+)
   • Filter for payment verified clients only
   • Set minimum client spending thresholds

4. Use Title-Specific Searches:

   • Set keyword filters to search only in job titles for more relevant matches
   • Job titles generally reflect the core skills required

5. Use the Fix Feed Feature:

   • After refining your feed, use the "Fix Feed" button for AI-powered optimization

Problem: Too Few Job Alerts

If you're not receiving enough job alerts:

1. Broaden Your Filters:

   • Remove or reduce minimum budget/rate requirements
   • Expand the range of client countries
   • Disable strict mode to include jobs with incomplete information

2. Adjust Keyword Settings:

   • Switch from "ALL" to "ANY" for keyword searches
   • Add more variations of keywords (e.g., "react", "reactjs", "react.js")
   • Remove some required skills

3. Add More Categories:

   • Include related categories where your skills might apply
   • Example: Add "Web Development" if you're only looking in "Frontend Development"

4. Check the Jobs Tab:

   • Use the Jobs tab to see what's available and adjust filters accordingly

Mini-App Issues

Problem: Mini-App Not Loading

If the mini-app fails to load:

1. Update Telegram:

   • Ensure you're using the latest version of Telegram
   • Mini-apps require an up-to-date Telegram app

2. Try Different Device:

   • If it doesn't work on desktop, try mobile or vice versa
   • The mini-app works best on mobile devices

3. Clear Cache:

   • In Telegram, go to Settings > Advanced > Clear Cache
   • Restart Telegram and try again

4. Network Issues:

   • Check your internet connection
   • Try connecting through a different network

Problem: Changes Not Saving

If your feed changes aren't saving:

1. Check Connection:

   • Ensure you have a stable internet connection
   • Poor connectivity can prevent changes from being saved

2. Try Refreshing:

   • Close and reopen the mini-app
   • Try using the /start command to reset the bot connection

3. Use Desktop Client:

   • Try making changes through the Telegram desktop client if mobile isn't working

Webhook Integration Issues

Problem: Webhook Not Receiving Data

If your webhook isn't receiving job alerts:

1. Verify Subscription Status:

   • Webhooks are only available for paid subscribers
   • Check that your subscription is active

2. Check URL Format:

   • Ensure your webhook URL is correctly formatted
   • It must start with https:// for security reasons

3. Test Webhook Endpoint:

   • Verify your endpoint is publicly accessible
   • Test it with a tool like RequestBin or Webhook.site

4. Check Server Response:

   • Your server must respond with a 200 OK status within 10 seconds
   • Review your server logs for any errors

5. Firewall Settings:

   • Ensure your firewall allows incoming requests from Zenfl's IP addresses

Problem: Webhook Rate Limits

If you're concerned about webhook usage:

1. Monitor Usage:

   • Remember that 1,000 requests per month are included in your subscription
   • Additional requests are billed at $0.01 per request

2. Implement Filtering:

   • Make your feeds more specific to reduce the number of matching jobs
   • Use client quality filters to focus on higher-quality opportunities

Account and Billing Issues

Problem: Subscription Payment Failed

If your payment didn't go through:

1. Check Card Details:

   • Verify your card information is correct
   • Ensure your card hasn't expired

2. Contact Your Bank:

   • Some banks may block international transactions
   • Ask your bank if they blocked the payment

3. Try Another Payment Method:

   • If available, try using a different card or payment method

4. Contact Support:

   • Use the /help command to contact our support team

Problem: Account Limitation

If your account has limitations:

1. Verify Subscription Status:

   • Check if your subscription is active using the /status command
   • Resubscribe if your subscription has expired

2. Check for Violations:

   • Review our Terms of Service to ensure compliance
   • Contact support if you believe there's been a mistake

System Status and Performance

Problem: Slow Job Alert Delivery

If job alerts are coming in slower than usual:

1. Check System Status:

   • Visit our Status Page for any announced issues
   • Follow our Changelog Channel for updates

2. Consider Peak Times:

   • Job processing may be slower during high-traffic periods
   • Upwork job postings tend to cluster at certain times of day

Problem: Bot Not Responding

If the bot is unresponsive:

1. Check System and Telegram Status:

   • Visit our Status Page to check for any service issues
   • Visit Telegram Status to check for Telegram outages

2. Contact Support:

   • Send a message to our Support Chat reporting the issue
   • Provide details about when the problem started and what you were trying to do

3. Restart the Conversation:

   • Send /start to reset the bot connection
   • Try accessing the bot from a different device

4. Wait and Retry:

   • The bot may be experiencing temporary high load
   • Wait a few minutes and try again

Getting Advanced Help

If you've tried the solutions above and still have issues:

1. Use the Help Command:

   • Use the /help command in the bot to contact our support team
   • This is the preferred method for getting assistance with all issues

2. Describe Your Issue Clearly:

   • Include what you were doing when the issue occurred
   • Note any error messages you received
   • List any troubleshooting steps you've already tried

3. Additional Support Options:

   • Join our Telegram Support Chat
   • Email us at support@zenfl.pro