Back to Subscriby

recovery.resource_failed_over

Automatic failover swapped a banned channel or group for its standby without the creator: the failover you sleep through.

Ability to subscribeproject-recovery:view

When this fires

A probe finds a channel gone or the bot removed from it, the project has Automatic Failover switched on, a healthy standby is linked, and the allowance permits: the platform points the resource at its standby, revokes the old links and queues every active member's re-admission, all without the creator. This event fires the moment the resource points at the standby; it sits under a recovery whose recovery.operation_started carries automatic: true.

Members the bot cannot reach. A failover emails the members the bot can no longer message, at a per-email fee the creator accepted when switching failover on. The roll call's emailed counter says how many.

Caveats

  • The standby that was consumed fires recovery.standby_removed with reason: used beside this event.
  • project.resource.updated also fires for the same resource with changes.space_id, as it does for any swap.

Related events

  • recovery.resource_replaced: the same swap made by the creator.
  • recovery.operation_reverted: the creator put the old chat back.

Header Parameters

SB-Signature*string

t=<unix seconds>,v1=<hex>: the HMAC-SHA256 of "<t>.<raw body>" under the endpoint's secret. Verify it before acting, and refuse a t more than 300 seconds from now. During a secret rotation a v0= signature under the previous secret may precede v1=.

SB-Event-Id*string

The event's ULID, bare. The envelope's id is the same ULID prefixed evt_, so strip the prefix before comparing. Deduplicate on it: a retry carries the same id.

SB-Event-Name*string

The event name, the same as the envelope's type.

Content-Type*string

Always application/json.

User-Agent*string

Always Subscriby-Webhooks/1.0.

Request Body

application/json

The signed JSON envelope posted to your endpoint.

TypeScript Definitions

Use the request body type in TypeScript.

The envelope every event is delivered in.

Response Body

Example Requests

POST/recovery.resource_failed_over

How is this guide?

recovery.installation_failed_over Webhook

Automatic failover switched a project onto its standby bot without the creator, because the platform refused the live one: the bot-side twin of recovery.resourcefailedover.

recovery.resource_replaced Webhook

The creator pointed a resource at a replacement channel or group: in a recovery after a ban, or on demand for a healthy resource.