Qntrl WebSocket Troubleshooting Guide: Connection, Routing & Message Issues

Troubleshooting FAQ

 1. Why is my WebSocket not connecting?   

  • Check if the endpoint URL is correct

  • Verify the Authentication Type(OAuth/API Key)

  • Ensure the connection is not blocked by network/firewall

  

2. Why are messages not being processed?   

  • Verify the Resource Selection Path is correct (e.g., $.module)

  • Ensure the incoming JSON matches the configured Route Value

  • Check if a Default Route is configured

  

3. Why is my route not getting triggered?   

  • The route value may not match the incoming message

  • JSON path may be incorrect

  • Case sensitivity issues in route values

 

4. Why am I receiving rate limit errors?   

  • The number of messages exceeds the configured policy

  • Update the rate limit in Policy or reduce message frequency

 

5. Why are messages not delivered to a session?   

  • The session might be disconnected

  • Check session status in Session Details

  • Ensure correct session ID or session name is used

 

6. Why is the Connect/Disconnect action not executing?   

  • Ensure Resource Type and Resource are configured

  • Verify the selected function/resource is valid