Виды, коды и текст ошибок Bot API

Unauthorized

Описание: Неверный токен бота.

Код ошибки: 401.

Как исправить: Проверить правильно ли указан токен бота, если верно, то попробовать сгенерировать новый токен в боте @BotFather

Метод: Любой.

{
  "ok": false,
  "error_code": 401,
  "description": "Unauthorized"
}

Bad Request: chat not found

Описание: Данный чат боту неизвестен.

Код ошибки: 400.

Как исправить: Проверьте правильно ли указан чат в запросе. Либо ошибка, либо данный чат/канал/группа не существует.

Метод: Любой.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: chat not found"
}

Bad request: user not found

Описание: Не верно указан user_id.

Код ошибки: 400.

Как исправить: Проверить "user_id".

Метод: Любой.

{
  "ok": false,
  "error_code": 400,
  "description": "[Error]: Bad Request: user not found"
}

Forbidden: user is deactivated

Описание: Вы пытаетесь выполнить действие с учетной записью пользователя, которая была деактивирована или удалена.

Код ошибки: 403.

Как исправить: Проверить "user_id".

Метод: sendMessage.

{
  "ok": false,
  "error_code": 403,
  "description": "Forbidden: user is deactivated"
}

Forbidden: bot was kicked

Описание: Вашего бота заблокировали.

Код ошибки: 403.

Как исправить: Не пытаться отправить сообщение в данном чате, группе.

Метод: sendMessage.

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

Forbidden: bot blocked by user

Описание: Пользователь заблокировал бота.

Код ошибки: 403.

Как исправить: Не писать пользователю.

Метод: Любой.

{
  "ok": false,
  "error_code": 403,
  "description": "Forbidden: bot was blocked by the user"
}

Forbidden: bot can't send messages to bots

Описание: Вы пытались отправить сообщение другому боту. Это невозможно сделать.

Код ошибки: 403.

Как исправить: Не писать боту, проверить chat_id, проверять в данных "from" поле "is_bot".

Метод: sendMessage.

{  "ok": false,  "error_code": 403,  "description": "Forbidden: bot can't send messages to bots"}

Too many requests

Описание: Слишком много запросов от бота.

Код ошибки: 429.

Как исправить: Бот достигает лимитов, как этого избежать? При отправке сообщений в чате старайтесь не отправлять более одного сообщения в секунду. Также учтите, что вашему боту не удастся отправить более 20 сообщений в минуту в одну группу. Официальное FAQ. На стороне обработки API можно при получении ошибки "выключать" бота на время указанное в поле "retry_after". Время указано в секундах.

Метод: sendMessage.

{
  "ok": false,
  "error_code": 429,
  "description": "Too Many Requests: retry after X",
  "parameters": { "retry_after": 123 }
}

Bot is not a member of the channel chat

Описание: Бот не является участником группы обсуждения на канале.

Код ошибки: 403.

Как исправить: Вы пытаетесь опубликовать пост на канале, у которой есть прикрепленная группа для обсуждения. Что бы опубликовать пост через бота, необходимо что бы бот тоже был участником группы. Иногда нужно подождать пару минут после добавления бота в группу, что бы перестала появляться ошибка.

Метод: sendMessage.

{
	"ok":false,
	"error_code":403,
	"description":"Forbidden: bot is not a member of the channel chat"
}

Bad request: Group migrated to supergroup

Описание: Происходит, когда групповой чат конвертируется/переносится в супергруппу.

Код ошибки: 400.

Как исправить: Проверьте chat_id и убедитесь, что используете новый идентификатор супергруппы.

Метод: sendMessage.

{
	"ok": false,
	"error_code": 400,
	"description": "Bad Request: group chat was migrated to a supergroup chat",
	"parameters": {
		"migrate_to_chat_id": -123456789
	}
}

Bad request: Invalid file id

Описание: Идентификатора файла, который вы пытаетесь получить, не существует.

Код ошибки: 400.

Как исправить: Проверьте отправленный file_id.

Метод: getFile.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: invalid file id"
}

Bad request: Message not modified

Описание: Текст текущего и нового сообщения, а также разметка ответа совпадают.

Код ошибки: 400.

Как исправить: Измените текст или разметку ответа сообщения, которое нужно отредактировать.

Метод: editMessageText.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: message is not modified"
}

Conflict: Terminated by other long poll

Описание: Вы уже настроили вебхук и пытаетесь получать обновления через getUpdates.

Код ошибки: 409.

Как исправить: Не используйте метод getUpdates, пока настроен webHook, либо удалите webHook.

Метод: getUpdates.

{
  "ok": false,
  "error_code": 409,
  "description": "Conflict: terminated by other long poll or webhook"
}

Bad request: Wrong parameter action in request

Описание: Появляется ошибка, когда значение свойства действия недопустимо.

Код ошибки: 400.

Как исправить: Укажите правильное свойство: typing, upload_photo, record_video, upload_video, record_voice, upload_voice, upload_document, choose_sticker, find_location, record_video_note, upload_video_note.

Метод: sendChatAction.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: wrong parameter action in request"
}

Bad Request: message text is empty

Описание: Текст сообщения пуст или не указан.

Код ошибки: 400.

Как исправить: Добавьте сообщение или проверьте отправляется оно или нет.

Метод: sendMessage, editMessageText.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: message text is empty"
}

use deleteWebhook to delete the webhook first

Conflict: can't use getUpdates method while webhook is active

Описание: Вы пытаетесь использовать getUpdates, когда вебхук активен.

Код ошибки: 409.

Как исправить: Используйте метод deleteWebhook, чтобы сначала удалить вебхук.

Метод: getUpdates.

{
  "ok": false,
  "error_code": 409,
  "description": "Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first"
}