Channel Lifecycle
A connected Telegram group or Discord server (a channel) is always in one of the states below. The state depends on whether the agent is reachable and on verified admin coverage.
Channel states at a glance
| State | What it means |
|---|---|
| 🟢 Active | Everything is working normally. The agent is reachable and your workspace has at least one team member with verified admin access to this channel. |
| 🔴 Needs attention | The agent has been unreachable for a while, or it was removed from the group. Your settings are preserved and no timer starts. It resolves as soon as the agent can confirm it's back. |
| 🔴 Recovery window | No one anywhere on the platform is currently verified as an admin of this channel. A 14-day countdown has started. If an admin re-verifies within that window, the channel returns to Active. If not, the channel enters a grace period before permanent deletion. |
| 🔴 Detached | The channel is no longer connected to any workspace. It can be claimed by a verified admin at any time. Your agent continues running with its existing configuration. |
| ⬛ Deleted | Permanently removed from the platform. This can happen if a recovery window expires without an admin re-verifying, or if the workspace Owner permanently deletes it. |
State diagram
The diagram below shows every valid transition and what triggers it.
The "Needs attention" state does not start any countdown. It only tracks that the agent couldn't be reached. Timers only start when there are zero verified admins for a channel.
The two timers
Two independent countdowns can affect a channel. They start for different reasons and end differently.
Timer 1: Recovery window (14 days)
Starts when there are zero verified admins for this channel anywhere on the platform, not just on your workspace.
- An email and inbox alert go to the workspace owner immediately.
- Any admin can stop the clock by re-verifying.
- If nobody does within 14 days, a grace period of another 14 days starts. If the channel isn't claimed by then, it's permanently deleted.
Timer 2: Coverage countdown (30 days)
Starts when your workspace has no team member with verified admin access to the channel, but verified admins exist elsewhere on the platform. For example, the group's own admins let go of the agency whose workspace holds it.
- Day 0: A warning alert appears in your Inbox and the workspace Owner gets an email. Any workspace member can re-verify to stop the clock.
- Day 23: A final warning is sent.
- Day 30: The channel is automatically detached from your workspace. Every verified admin of that channel (wherever they are on the platform) is notified that it's available to claim.
The coverage countdown is paused during agent outages. It only advances when the platform can confirm who does or doesn't have admin access, so an unreachable agent never causes an automatic detach.
What stays when a channel changes state
| What | Needs Attention | Detached | Recovery window / Deleted |
|---|---|---|---|
| Agent configuration | Preserved | Preserved (agent keeps running) | Preserved until deletion |
| Member activity & analytics history | Accessible | Hidden from old workspace; visible to a new claiming workspace | Lost on deletion |
| Your workspace's reports & audit log | Unaffected | Stays with your workspace | Stays with your workspace |
| Premium features | Unaffected | Drops to free immediately | n/a |
See Detaching Channels for the full breakdown.
Next steps
- Detaching Channels: Unlink, the automatic detach, and what happens to the data
- Ownership & Teams: transferring ownership, leaving a workspace
- FAQ: edge cases like "the agent was removed. Does the 30-day countdown start?"