Troubleshooting

Yeh guide un common issues ko cover karta hai jo aapko Neotask use karte waqt mil sakte hain aur unhe kaise resolve karein.

License aur Activation

"Invalid license key"

• Key format check karein: SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• Extra spaces ya missing characters check karein
• Sunishtchit karein ki aapke paas active internet connection hai
• Key ko dhyan se dobara enter karein

"License revoked"

• Aapki license server dwara revoke kar di gayi hai
• neotask.ai par apna billing status check karein
• Agar aapko lagta hai yeh galti hai toh support se sampark karein

"License expired"

• Aapki subscription ki samay seema samapt ho gayi hai
• Billing portal se apna plan renew karein
• Expire hone par app read-only mode mein aa jaata hai

"Offline grace period expired"

• Aap 72 ghante se zyada offline rahe hain
• Automatic revalidation ke liye internet se connect karein
• Connect hone par app normal operation resume karega

"Version blocked"

• Aapke app ka version security reasons se block kar diya gaya hai
• Turant latest version mein update karein
• Auto-update aapko prompt karega; anya tha website se download karein

Gateway Issues

"Gateway start hone mein fail hua"

1. Check karein ki port 18789 uplabdh hai (kisi aur app dwara use nahi ho raha)
2. App restart karne ki koshish karein
3. Dashboard se gateway health check karein
4. macOS par, sunishtchit karein ki app ke paas System Preferences -> Privacy & Security mein zaroori permissions hain

"3-strike lockout"

• 3 consecutive gateway failures ke baad, operations block ho jaate hain
• Lock counter reset karne ke liye app restart karein
• Agar persist kare, toh underlying error ke liye logs check karein

"Gateway disconnected"

• Local runtime ne connection kho diya
• Gateway panel mein "Reconnect" par click karein
• Agar disconnect hota rahe, app restart karein
• Check karein ki koi firewall localhost connections block nahi kar raha

Voice Issues

"Koi audio input detect nahi hua"

• Microphone permission grant karein:
  • macOS: System Preferences -> Privacy & Security -> Microphone -> Neotask ke liye enable karein
  • Windows: Settings -> Privacy -> Microphone -> Apps ko access allow karein
• Check karein ki aapka microphone mute nahi hai
• System settings mein sahi input device select hua hai check karein

"Wake word trigger nahi ho raha"

1. Sunishtchit karein ki Settings mein voice activation enabled hai
2. Check karein ki activation mode "Porcupine" par set hai ("Shortcut" ya "Off" nahi)
3. Wake phrase saaf bolein: "Hey Neotask"
4. Iske bajay keyboard shortcut try karein (Cmd+Shift+Space / Ctrl+Shift+Space)
5. Check karein ki koi aur app microphone use nahi kar raha

"TTS audio choppy ya delayed"

• Apni internet connection check karein (TTS ke liye ElevenLabs API zaroori hai)
• ElevenLabs rate limiting experience kar raha ho sakta hai
• Settings mein alag voice try karein
• Background network activity kam karein

"Voice shortcut kaam nahi kar raha"

• Koi aur app same shortcut claim kar sakta hai
• Settings -> Activation -> Keyboard Shortcut mein shortcut badlein
• macOS par, conflicts ke liye System Preferences -> Keyboard -> Shortcuts check karein

Connection aur Network

"Server se connect nahi ho pa raha"

• Apni internet connection check karein
• Verify karein ki neotask.ai aapke browser mein accessible hai
• Corporate firewall ke peeche hain toh HTTPS traffic allowed hai sunishtchit karein
• Temporarily VPN disable karne ki koshish karein

"API request fail hua"

• Apni internet connection check karein
• Verify karein ki aapki license active hai
• BYOK use kar rahe hain toh check karein ki aapki API key valid hai aur credits hain
• Dashboard refresh karne ki koshish karein

Agents aur Sessions

"Agent nahi ban pa raha: limit poori ho gayi"

• Agent count kisi bhi plan par capped nahi hai; custom agent banane ke liye paid plan chahiye
• Agar Free plan par yeh dikhe, to custom agents banane ke liye kisi paid plan mein upgrade karein
• Apna workspace tidy rakhne ke liye unused agents delete karein

"Agent respond nahi kar raha"

• Gateway health check karein (chalte rehna chahiye)
• Check karein ki agent ka model accessible hai (valid API key, provider uplabdh)
• Daily budget check karein -- exceed hone par, agents midnight UTC tak pause hote hain
• Session reset karne ki koshish karein

"Session messages load nahi ho rahe"

• Page/app refresh karein
• Gateway connection status check karein
• Agar session bahut lambi hai, naya session banane ki koshish karein

Billing aur Payments

"Payment fail hua"

• Apne card details sahi hain check karein
• Apne bank se international transaction blocks check karein
• Alag payment method try karein
• Problem persist hone par support se sampark karein

"Usage allocation exceed ho gayi"

• Aapke agent ke token consumption ne aapki subscription mein shamil allocation ko exceed kar diya hai
• Additional usage usage rates par charge hota hai. Details ke liye apne dashboard mein Usage page check karein.
• Token costs seedha apne provider ko route karne ke liye BYOK mode (apni API keys use karein) par switch karein
• Unexpected overages rokne ke liye daily budget limits set karein

"Payment ke baad plan update nahi hua"

• Stripe webhooks mein thoda delay ho sakta hai (aamtaur par 1 minute se kam)
• Dashboard refresh karein
• 5 minutes ke baad bhi update nahi hua toh apne payment confirmation ke saath support se sampark karein

Performance

"App startup par slow hai"

• License validation aur gateway initialization launch par hoti hai -- yeh normal hai
• Sunishtchit karein ki aapka system minimum requirements poora karta hai
• Background mein unnecessary apps band karein

"High CPU usage"

• Always-listening wake word (Porcupine) use kar rahe hain toh yeh minimal CPU use karta hai lekin disable kiya ja sakta hai
• Use na karte waqt voice sessions pause karein
• Activity Monitor / Task Manager mein stuck gateway processes check karein

"High memory usage"

• Lambi chat sessions memory accumulate karti hain
• Periodically naye sessions banayein
• Accumulated state clear karne ke liye app restart karein

Madad Lena

• Documentation: Aap yahan hain -- knowledge base browse karein
• Support: neotask.ai/support par Support page par jayein
• Contact: Website par contact form use karein
• Status: neotask.ai par service status check karein