Skip to main content

Agent Won’t Connect

Symptom

Agent fails to connect to the platform

Common Causes

  1. Invalid Credentials
  2. Network Issues
  3. Firewall Blocking
  4. Platform Unavailable

Solutions

1. Verify Credentials

2. Test Platform Connectivity

3. Check WebSocket URL

Connection Drops

Symptom

Agent connects but disconnects frequently

Solutions

Enable Auto-Reconnect

Monitor Connection

Timeout Errors

Symptom

Connection attempts timeout

Solutions

Increase Timeout

Check Network

Firewall Issues

Symptom

Connection blocked by firewall

Solutions

Allow WebSocket Connections

Quick Fixes

IssueQuick Fix
Invalid API keyVerify key in dashboard
Wrong URLUse wss://app.conversimple.com/sdk/websocket
TimeoutIncrease timeout to 30s
FirewallAllow port 443 outbound
Platform downCheck status page

Still Having Issues?

If problems persist:
  1. Enable debug logging
  2. Check platform status page
  3. Contact support with logs

Debugging

Debug your agent

Error Handling

Handle errors gracefully