Trigger: Channel Disconnected

Set up a workflow that alerts you the moment a channel disconnects from Omnifox.

Jul 11, 2026

Watch this step in the video · WhatsApp templates and the 24-hour window

What it is

Fires when a channel of any type loses its connection to Omnifox: WhatsApp (API or QR), Instagram, Messenger and the rest. For example: the health check finds the channel isn't responding, Meta reports the account changed, a WhatsApp or Instagram token is no longer valid or couldn't be renewed, the WhatsApp QR session was closed or blocked, or the number moved to another account.

For the same channel it fires only once per hour, even if the outage is detected through several paths.

When to use it

  • Alert the team as soon as a channel goes down, before a customer notices.
  • Create an internal alert with the reason for the disconnection.
  • Pause other automations that depend on that channel until it's reconnected.

Requirements

  • At least one channel connected to the workspace.
  • Workflows module enabled.

Available variables

  • $channel.id, $channel.name, $channel.type
  • $disconnect.reason: reason for the disconnection

Configuration (filters)

  • Specific channel: limits the trigger to one channel.
  • Channel type: limits the trigger to one type (for example, only Instagram).

How to set it up

  1. Go to Workflows and create a new workflow.
  2. In the trigger palette, open the System category.
  3. Choose Channel disconnected.
  4. (Optional) Filter by channel or by channel type.
  5. Connect an action, such as posting in Team or emailing the admin.
  6. Save and turn the workflow on.

Example

The Instagram channel disconnects because its token couldn't be renewed. The workflow immediately posts in the “Tech support” Team space, with $channel.name and $disconnect.reason, so someone reconnects it before messages are lost.

Tips

  • Reconnect the channel from Settings → Channels. This trigger only alerts; it doesn't reconnect by itself.
  • Since it doesn't repeat within an hour for the same channel, you don't need to build your own guard against repeated alerts.

Troubleshooting

  • It didn't fire: check that the workflow is on and that its channel or type filters don't exclude the channel that went down.
  • Only one alert arrived although the channel dropped twice in a row: expected if it was within the same hour.
Was this helpful?

Related articles

Message us on WhatsApp