🥷

Ninja Chatter
Help

Troubleshooting & FAQ

Common issues and how to fix them.

Connection Issues

Chat shows "Connecting..." but never connects

This usually indicates a WebSocket connection issue. Check the following:

  • Ensure the room ID is correct
  • Check if you're behind a corporate firewall that blocks WebSockets
  • Try refreshing the page
  • Check browser console for specific error messages
If using a custom domain, ensure your server properly proxies WebSocket connections to the API.
"Auth failed" or "Invalid token" error

This means your authentication token is expired or invalid.

  • Guest tokens expire after 10 minutes
  • OAuth tokens expire after 1 hour
  • Try signing out and signing back in
Clear your browser's local storage for the site and re-authenticate.
Messages not appearing for other users

If you can send messages but others don't see them, you may be stealth-banned.

  • Stealth bans let you see your own messages but hide them from others
  • Contact the room moderator to check your status
Ask the room owner to check the moderation logs and remove any stealth ban.

OBS Overlay Issues

Overlay shows blank/empty in OBS

Common causes for a blank overlay:

  • Missing room ID in the URL
  • Browser source not refreshed after URL change
  • OBS browser cache needs clearing
Right-click the browser source, select "Refresh cache of current page", then check the URL includes ?room=YOUR_ROOM_ID.
Chat text is too small/large in overlay

Use the size URL parameter to adjust font size:

https://chat.ninjachatter.com/overlay.html?room=abc123&size=18

Default size is 14px. Increase for larger text, decrease for smaller.

API & Webhook Issues

Webhook ingress returns 401 Unauthorized

Check your authentication:

  • Ensure the API key is correct and hasn't been rotated
  • If using HMAC, verify the signature is calculated correctly
  • Check that the X-Api-Key header is included
curl -X POST https://api.ninjachatter.com/rooms/abc123/ingress \
  -H "X-Api-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"chat","content":"Hello"}'
Rate limit errors (429)

You're sending requests too quickly. Rate limits:

  • API: 60 requests/minute per IP
  • WebSocket: 20 messages/10 seconds per user
  • Ingress: 10 messages/second per room
Implement exponential backoff in your code. Check X-RateLimit-Reset header for when limits reset.

Account & Authentication

Discord login not working

Discord OAuth issues can occur if:

  • Pop-ups are blocked in your browser
  • You have Discord's "Authorized Apps" permissions revoked
  • Your Discord account has 2FA issues
Allow pop-ups for ninjachatter.com, then try logging in again. If it still fails, go to Discord Settings > Authorized Apps and re-authorize.
Lost access to my room

Room ownership is tied to your OAuth identity. If you've lost access:

  • Log in with the same Discord/Patreon account you used to create the room
  • If you signed in as a guest originally, you cannot recover ownership
Always create rooms while logged in with OAuth to maintain ownership.

Still Need Help?

If you're still experiencing issues: