SIM Offline

A SIM shows offline when Connecfy hasn't heard a heartbeat from it in more than 45 seconds. It's an inference from silence, not a push notification of a disconnect event — see SIM Status for the full mechanism.

What to check

From the API side, an offline SIM isn't something your integration fixes directly — it's a connectivity issue on the gateway itself. If a SIM you expect to be online is showing offline:

• Confirm on the device page that a heartbeat has actually stopped, rather than assuming from a single stale read.
• If it's been offline for more than a few minutes, that's worth flagging to whoever manages that SIM — a connectivity issue on their end, not something recoverable from the API.

How fast it recovers

Nothing to re-pair or reset from your side. The moment the gateway can reach the network again, its next heartbeat (within ~15 seconds) reports in and the SIM flips back to online on its next read — no action needed once connectivity is restored.

What happens to messages queued while it's offline

They wait. Nothing is dropped or reassigned just because a SIM missed some heartbeats — see SMS Stuck in Queue if a message stays unclaimed longer than expected after the SIM comes back.