Docs

Reference

bot.updated — Bot profile changed

A bot's name, about, description, command menu or photo changed; `fields` names what.

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

A bot's name, about, description, command menu or photo changed; fields names what.

Since web 2.1.0, worker —.

Name Value
Code bot.updated
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.updated/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.updated",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/bot.updated/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",
    "fields": [
      "name",
      "commands"
    ],
    "untrusted_fields": [
      "bot.name"
    ]
  }
}
Was this page helpful?

Last checked: 10/24/2026 · build 2.0