Troubleshooting
The snags people hit first, and how to clear them.
My bot doesn't reply
Work down this list — it's almost always one of these:
- Is it deployed? A flow that only exists in TEST won't answer real users. Hit Deploy to push it to LIVE.
- Does the flow start with a trigger? Every flow needs a
Message ReceivedorCommand Receivednode at the top — nothing runs without one. - Does the trigger match? A
Command Receivedfor/startwon't fire on plain text, and aMessage Receivedwith atextfilter ignores photos. - Is the token still valid? If you regenerated the token in BotFather, the old one stops working — reconnect the bot with the new token.
"Invalid token" when connecting
Copy the token straight from @BotFather— it's the whole line after "Use this token", in the form 123456789:AA…. Don't include the surrounding text or a trailing space. If it still fails, send BotFather /revoke to mint a fresh token and try again.
TEST works but LIVE doesn't (or vice-versa)
TEST and LIVE are separate environments. Changes you make on the canvas run in TEST until you deploy them; LIVE keeps running the last version you shipped. If a fix works in TEST but users still see the old behaviour, deploy again.
The Generate Text node errors or does nothing
AI nodes use your own model key (bring-your-own-key). Add a key for OpenAI, Anthropic, or Google in your bot's settings, and make sure the node is pointed at a model that key can access. A missing or unauthorized key is the usual cause.
Replies are delayed or dropped under load
Gramflow rate-limits each bot to protect it from bursts. Telegram automatically redelivers any update that was throttled, so messages aren't lost — they arrive a moment later. If you're consistently hitting the limit, simplify the flow or space out whatever is driving the traffic.
Still stuck?
Ask in the Telegram channel — during the beta we answer there directly.