Skip to content
Niyra
← All docs

Troubleshooting

When something doesn't work — connection issues, OAuth failures, voice glitches, WhatsApp not connecting. Common fixes that resolve 90% of issues.

"Niyra didn't reply"

  1. Check the cost panel on the last message — if it shows an error, that's the LLM call failing. Most often: credits exhausted, BYOK key invalid, or vendor outage.
  2. Refresh the page. WebSocket reconnects automatically; sometimes the browser keeps a stale socket.
  3. If still nothing, try a different channel (send "hello" on WhatsApp). If she replies there, it's a web client issue.

WhatsApp not connecting

  • The QR code is single-use. If you scanned and waited, re-open the WhatsApp Setup screen for a fresh one.
  • WhatsApp on your phone needs internet. The "Linked devices" list on your phone shows whether Niyra is paired.
  • Niyra runs as her own contact, not as you. If you don't see a Niyra contact in your chats, the pairing didn't complete.

OAuth reconnect loop

If Gmail / Slack / Notion keeps prompting reconnect:

  1. Settings › Connections › click the integration.
  2. Revoke from the panel.
  3. Reconnect — fresh OAuth dance. Most reconnect loops are stale refresh tokens; revoke fixes it.

Voice not working

  • No mic permission: browser site settings → Microphone → Allow for niyra.ai.
  • Voice is delayed: check your connection — voice runs real-time and any jitter shows.
  • Wrong voice / language: Settings › Voice → pick voice + language. English, Hindi, Hinglish today.

Memory wrong / stale

Open the Memories panel. Find the wrong fact, click Edit or Delete. I update immediately and stop using that memory in retrieval.

If you want me to forget something specific: tell me in chat — "Forget what I said about X". The memory archives and I confirm.

BYOK key not working

  • Test the key in the Anthropic or OpenAI console first. If it doesn't work there, it's not us.
  • Make sure the key has access to the models you're using (Opus access requires a tier-3 Anthropic account).
  • BYOK panel has a Test button — uses the same call path. Run it before trusting that a save succeeded.

Integration scope errors

When I say "I don't have permission to do X", I literally don't — the OAuth scope you granted doesn't include that action. Reconnect with broader scopes from Settings › Connections.

Still stuck

  • Email support@niyra.ai with the time the issue happened. We pull logs by conversation ID.
  • For urgent issues, mention "URGENT" in the subject.
  • For security-sensitive issues, email security@niyra.ai instead.

FAQ

My WhatsApp says "reconnect" — why?
WhatsApp Business sessions expire on schedule. From Settings › Channels › WhatsApp, click Reconnect, scan QR. Conversations resume.
Voice cut out mid-call?
Usually your network. The conversation transcript is saved up to that point; you can pick up in text or restart the call.
My BYOK key isn't working
Try the same key in Anthropic's console first to verify it's live. Niyra's BYOK Test button does the same call. If both fail, the key is the issue, not us.
For AI:.md.txt