Running it

Telegram bot not responding? Work through these in order

By the Botable team

A silent Telegram bot almost always has one of six causes: the process is not running, a webhook conflict, privacy mode in a group, a missing admin permission, a crashed handler, or rate limiting. Check them in that order — it is roughly the order of probability.

The short version

A Telegram bot that has stopped responding is rarely a mystery, because the failure surface is small and the causes have a stable order of probability. Most often the process simply is not running — it crashed, the host restarted, or a deploy failed and nobody noticed, since a dead bot produces no error anywhere a user can see. Next most common is a webhook conflict: setting a webhook disables long polling, and running both leaves the bot appearing to receive nothing. In groups, privacy mode explains a bot that answers commands but ignores conversation, while a missing admin permission explains one whose moderation commands silently do nothing. Further down are a handler throwing on a specific input, so the bot answers everything except one thing, and rate limiting, which makes it slow rather than silent. Checking in that order resolves most cases in minutes.

Step by step

Is the process actually running?

Check first, always. A crashed or un-deployed bot is the single most common cause and it is invisible from Telegram — the bot still appears in your chat list and still shows a profile. Look at your logs or your platform's status rather than at the chat.

Is there a webhook conflict?

A bot can use a webhook or long polling, not both. Setting a webhook silently disables getUpdates, so a bot that was polling stops receiving anything the moment a webhook is registered — often by a second deployment or an old test script. Check what the webhook is currently set to and clear it if you intend to poll.

Does it answer commands but ignore everything else in a group?

That is privacy mode, on by default, and it is a setting rather than a fault. Disable it in @BotFather with /setprivacy, then remove the bot from the group and add it back — the change does not apply to groups it is already in.

Do moderation actions do nothing at all?

Missing admin permissions. Deleting messages, restricting and banning each need the bot promoted with that specific right, and Telegram rejects the action silently rather than returning something visible. Open the group's administrator list and read what the bot actually has.

Does it answer some things and not others?

A handler is throwing on a specific input, which takes down that path and leaves the rest working. Reproduce with the exact message that fails and read the log for that request — this pattern is almost never infrastructure and almost always one unhandled case.

Is it slow rather than silent?

Rate limiting. Telegram applies documented soft limits per chat and overall, and a bot that bursts past them is throttled rather than blocked, so messages arrive late in an order that looks random. Batch and space your sends.

What catches people out

  • A dead bot looks identical to a working one from the chat list — never diagnose from Telegram alone
  • Setting a webhook disables polling silently; this catches people who deploy twice
  • Permission failures are silent by design, so "nothing happened" is a permissions symptom, not a null result

Questions

The bot works in private chat but not in the group. Why?

Privacy mode if it ignores conversation, missing admin rights if its actions fail. Those two account for almost every private-works-group-does-not report, and both are settings rather than code problems.

It worked yesterday and stopped overnight. What changed?

Usually the host restarted and the process did not come back, or a token was revoked or rotated. Check the process first and the token second — both fail exactly this way, and neither surfaces an error to the user.

Want a bot that does this?

Describe it in plain language and Botable writes the code, gives the bot its own database, deploys it and keeps it running. Everything on this page is handled for you — the token, the webhook, the storage, the hosting.

Build a bot

Keep reading

Bots that use this

All twenty-five guides