Skip to content
Errorgram

Bot kicked · bot.kicked

Stable ID: bot.kicked · Evidence: source derived

The bot was removed or banned from the chat.

The response does not identify who removed the bot or guarantee that rejoining is currently allowed.

When it matches

Section titled “When it matches”

Every field in a rule must match. Alternative rules are joined with OR. Codes below are JSON response fields, not inferred HTTP statuses.

Rule 1

Section titled “Rule 1”
  • JSON error_code: 403.

Exact description:

Forbidden: bot was kicked from the group chat

Rule 2

Section titled “Rule 2”
  • JSON error_code: 403.

Exact description:

Forbidden: bot was kicked from the supergroup chat

Rule 3

Section titled “Rule 3”
  • JSON error_code: 403.

Exact description:

Forbidden: bot was kicked from the channel chat

See matching rules for parameter precedence and unknown or ambiguous results.

Illustrative methods: sendMessage, deleteMessage.

Possible causes

Section titled “Possible causes”
  • An active group records the bot as kicked.
  • The supergroup or channel membership status is banned.

Before deciding what to do

Section titled “Before deciding what to do”

Application decision: restore bot membership. Repeat request: after access change.

  • An authorized chat administrator must restore the bot’s access before the application resumes the operation.

These are application choices. Errorgram does not retry, suppress the error, or change bot state.

Facts

Section titled “Facts”

This condition adds no extracted facts; result.facts is empty.

Example

Section titled “Example”

Synthetic examples derived from the cited source.

API method: sendMessage.

{
  "ok": false,
  "error_code": 403,
  "description": "Forbidden: bot was kicked from the group chat"
}

Python

Section titled “Python”
from errorgram import classify


response = {
    "ok": False,
    "error_code": 403,
    "description": "Forbidden: bot was kicked from the group chat",
}
result = classify(response, method='sendMessage')


assert result.id == 'bot.kicked'
print(result.entry["summary"])

JavaScript and TypeScript

Section titled “JavaScript and TypeScript”
import { classify } from "errorgram";


const response = {
  "ok": false,
  "error_code": 403,
  "description": "Forbidden: bot was kicked from the group chat"
};
const result = classify(response, { method: "sendMessage" });


if (result.status === "matched" && result.id === "bot.kicked") {
  console.log(result.entry.summary);
}

Framework names

Section titled “Framework names”
Integration Type or ID
Python errorgram.BotKicked
aiogram errorgram.aiogram.BotKicked extends TelegramForbiddenError
grammY EnrichedGrammyError with classification.id equal to bot.kicked

Enrichment is explicit and keeps framework catch compatibility. Follow the Python and aiogram guide or JavaScript, TypeScript, and grammY guide.

Evidence

Section titled “Evidence”

Source references identify the reviewed revision, not the first release that introduced this response.

Data and versions

Section titled “Data and versions”

Catalogue 0.1.0 · schema 1.0.0 · reviewed 2026-09-16.

Markdown · Condition JSON · Full catalogue and sources · JSON Schema