thanhen / errors

A list of errorcodes and their meaning

Telegram Bot API errors

Introduction

This is a non-official list of actual errors you can encounter while developing your bot using the Telegram Bot API.

The meaning, explanations, codes and other stuff in these errors may change at any given time, so don't trust too much on this list and use your common sense.

If you want to contribute, ensure to include:

• The actual json output
• Optional textual description
• Whether there is interaction needed from the developer
• What method did create the error

The error list

This is the actual list that has been composed so far. Feel free to add more.

JSON	Human Description	Action needed?	Methods raising
Unauthorized	Bot token is incorrect	Correct your bot token and try again	any
Bad Request: chat not found			any
Bad request: user not found	User_id is incorrect	Correct user_id	any
Forbidden: user is deactivated			SendMessage
Forbidden: bot was kicked	Bot was kicked	Delete chat_id on your side	SendMessage
Forbidden: bot blocked by user			any
Forbidden: bot can't send messages to bots	You tried to send a message to another bot. This is not possible		sendMessage
Too many requests	You are hitting the API limit, more information here		SendMessage
Bad request: Group migrated to supergroup		SendMessage
Bad request: Invalid file id	The file id you are trying to retrieve doesn't exist	Try to call getFile before downloading	GetFile
Bad request: Message not modified			EditMessageText
Conflict: Terminated by other long poll	You have already set up a webhook and are trying to get the updates via getUpdates	Do not use getUpdates	getUpdates
Bad request: Wrong parameter action in request			sendChatAction