Automatic Reconnection If the Connection Drops Mid-Session
If the real-time link drops during Co-browse, Omnifox retries on its own before giving up on the session.
A Co-browse session depends on a live real-time link between the customer's browser and the agent's. If that link drops for a moment — flaky wifi, a network switch — the system doesn't give up on the session immediately: it retries the connection on its own.
How it works
- When an unexpected drop is detected, the widget switches to a "reconnecting" state and shows it on screen (the agent sees "Session interrupted — retrying in a few seconds"; the visitor's session pill changes color).
- It retries with growing delays: 0.5s, 1s, 2s, 4s, and 8s (up to 5 attempts, about 15 seconds total).
- If any attempt succeeds, the session picks up exactly where it left off — no need to ask the customer for consent again, and the 10-minute countdown keeps running from where it was.
- In parallel, the system expects an activity signal (heartbeat) every few seconds. If none arrives for 30 seconds straight, the session is closed with reason "disconnect" — even if the socket manages to reconnect afterward.
Example
Mid-session, the customer's device switches from wifi to mobile data and loses signal for 6 seconds. The agent briefly sees "Reconnecting…" and the session restores itself — no cutoff, no new consent prompt.
Tips
- The first retries are nearly instant (half a second); a brief signal drop almost never actually ends a session.
- If the drop lasts more than 30 seconds, the session has already ended with reason "disconnect" even if the visitor comes right back — in that case, start a new one.
Troubleshooting
If sessions keep ending with reason "disconnect," check the stability of the customer's (or agent's) network before suspecting an Omnifox issue — the system already retries automatically before giving up.
Related articles
-
What Co-browse is and how to enable it
Co-browse lets you see the customer's screen in real time to guide them better. Learn how to enable it.
-
How to start a Co-browse session with a customer
Step by step to invite the customer to share their screen and guide them in real time.
-
Prerequisites for using Co-browse
Before you start your first Co-browse session, check the add-on, your permissions and the Webchat channel conditions.
-
The visitor consent modal
What the customer sees when you start Co-browse: the screen-sharing request, what happens if they accept or decline, and the active-session bar.
-
Visitor RADAR: access it, read it and search
The RADAR is a live list of the people browsing your webchat right now and whom you can start co-browsing in one click.