Channels

Channel banned

channel.banned

Fires when a channel is banned by the upstream provider (e.g. Meta blocks the WhatsApp number, Telegram revokes the bot). This state is terminal: the channel cannot be resumed or reconnected (`reconnect`/`resume` return 422 with code `channel_banned`) and no further `message.created` events are emitted — a new channel with a different account must be created.

HTTP request

AISAR sends a signed POST request to your webhook_url:

http

POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "channel.banned",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "channel": {
      "id": 2,
      "type": "whatsapp",
      "name": "Main WhatsApp",
      "status": "banned",
      "account_name": "+77001234567",
      "connected_at": "2026-03-26T10:00:00.000000Z",
      "disconnected_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

The X-AISAR-Signature header carries an HMAC-SHA256 signature of the request body — use it to verify the request came from AISAR.

Example payload

json

{
  "event": "channel.banned",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "channel": {
      "id": 2,
      "type": "whatsapp",
      "name": "Main WhatsApp",
      "status": "banned",
      "account_name": "+77001234567",
      "connected_at": "2026-03-26T10:00:00.000000Z",
      "disconnected_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

Payload fields

Field	Type	Description
`channel.id`	`integer`	Channel ID
`channel.type`	`string`	Channel type: `whatsapp`, `whatsapp_business`, `instagram`, `instagram_business`, `telegram_bot`, `live_chat`
`channel.name`	`string`	Channel name
`channel.status`	`string`	Always `banned`
`channel.account_name`	`string\|null`	Platform account name or phone number
`channel.connected_at`	`string\|null`	ISO 8601 timestamp of last successful connection
`channel.disconnected_at`	`string\|null`	ISO 8601 timestamp when the ban was detected