ChatBreez Docs

Appearance

Disconnect Alerts ​

ChatBreez monitors the connection state of every WhatsApp instance on your account. When an instance that was active drops unexpectedly, ChatBreez sends an email alert to the address on your account — no configuration required.

How It Works ​

  1. Your WhatsApp instance is connected and receiving messages normally.
  2. The connection drops — for example the WhatsApp session expires, or the device is logged out remotely.
  3. ChatBreez detects the drop instantly via a server-side event.
  4. An alert email is sent to your account email address within seconds.
  5. The email includes the name of the affected instance and a direct link to reconnect it from the dashboard.

This happens entirely on the server. You do not need to have the ChatBreez dashboard open to receive the alert.

What the Email Looks Like ​

The email subject is:

Your WhatsApp instance "<instance-name>" disconnected

It includes:

  • The name of the disconnected instance
  • A clear explanation that messages will not be received until the instance is reconnected
  • A Reconnect Now button that takes you directly to the instances page in the dashboard

When Alerts Fire ​

SituationAlert sent?
Instance drops from an active connection✅ Yes
Instance fails to connect on first setup❌ No — it was never connected
You manually log out from the dashboard❌ No — intentional action
Instance reconnects after a drop❌ No — only disconnects trigger an alert
Same instance drops again after reconnecting✅ Yes — every unexpected drop alerts

The guard is strict: an alert only fires when the previous confirmed state was connected and the new state is disconnected. Startup events, QR scanning, and reconnects do not trigger emails.

Reconnecting After a Drop ​

When you receive an alert:

  1. Click Reconnect Now in the email, or open the ChatBreez dashboard directly.
  2. Navigate to Instances.
  3. Find the disconnected instance and click Connect.
  4. Scan the QR code with the WhatsApp app on your phone.

If the session was only briefly interrupted (not fully logged out), the instance may reconnect automatically. In that case you will receive the alert email but the instance will already show as connected by the time you open the dashboard.

No Setup Required ​

Disconnect alerts are automatic for all accounts. There is nothing to enable or configure. As long as your account has a verified email address, you will receive alerts.

If you are not receiving alerts:

  • Check your spam or junk folder — filter rules sometimes catch automated emails.
  • Confirm your account email is verified in the dashboard under Account Settings.
  • Make sure the instance was actually in a connected state before the drop. Alerts only fire on transitions from connected.