Docs

Reference

bot.token_rotated — Bot token rotated

A bot's token was revoked and replaced; the old token no longer works. Reading the same token again does not count.

View MarkdownThis page is generated from the source code on every release.

A bot's token was revoked and replaced; the old token no longer works. Reading the same token again does not count.

Since web 2.1.0, worker —.

Name Value
Code bot.token_rotated
Group Bots
Status Subscribable
Scope needed to receive it accounts.read
Tied to one account Yes
Only the connection that caused it receives it No
Filters that apply —
Fields dropped in thin content mode bot.name
Fields written by outside people (untrusted) bot.name

JSON Schema

https://tlg.builera.app/schemas/events/bot.token_rotated/2.json

Sample payload (exactly what webhooks.test sends)

{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "bot.token_rotated",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/bot.token_rotated/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "account": {
      "id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "label": "Sale 1",
      "username": "sale_demo_1",
      "tg_user_id": "100200300"
    },
    "bot": {
      "id": "8e0a2c4e-6a8c-4e0a-9c2e-4a6c8e0a2c4e",
      "tg_bot_id": "7012345678",
      "username": "shop_demo_bot",
      "name": "Shop Demo"
    },
    "job_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "token_revision": 2,
    "untrusted_fields": [
      "bot.name"
    ]
  }
}
Was this page helpful?

Last checked: 10/24/2026 · build 2.0