Skip to main content

​
Test

You can preview and test your bot by clicking on the Test button in the editor and change the runtime to Telegram.
Telegram preview dropdown

​
Troubleshooting

Telegram prohibits sending messages to people who haven’t interacted with the bot before. To resolve this, you can send a message to the bot on Telegram by entering the bot’s name in the input and clicking “start” to redirect.

​
Limitations

Telegram environment have some limitations that you need to keep in mind when building the bot:
  • SVG image files are not supported. They won’t be displayed.
  • Only .mp4 videos are supported (See Supported Media Types for more info).
  • Telegram only allows to display 8 buttons at a time. So we work around that by adding ”…” messages to display more buttons.
  • Cards input block can only display 3 buttons per card at a time.
  • Buttons content can’t be longer than 20 characters. If the content is longer, it will be truncated.
  • Incompatible blocks, if present, they will be skipped:
    • Payment input block
    • Chatwoot block
    • Script or Set Variable block with Execute on client option enabled
    • Google Analytics block
    • Meta Pixel blocks
    • Cal.com block

​
Contact information

You can automatically assign contact name and phone number to a variable in your bot using a Set variable block with the dedicated system values:
Telegram contact system variables

​
Deploy on your bot name

Head over to the Share tab of your bot and click on the Telegram button to get the integration instructions of your bot.

​
Configuration

You can customize how your bot behaves on Telegram in the Configure integration section
Telegram configure integration
Session expiration timeout: A number from 0 to 48 which is the number of hours after which the session will expire. If the user doesn’t interact with the bot for more than the timeout, the session will expire and if user sends a new message, it will start a new chat. The default is 4 hours. Start bot condition: A condition that will be evaluated when a user starts a conversation with your bot. If the condition is not met, the bot will not be triggered.

​
FAQ

You can integrate as many bots as you’d like. Keep in mind that Typebot does not provide those bots.
Telegram bot is totally free to use. Some functions need an Business Subscription to work, refer totheir documentation

​
Troubleshooting

​
After publishing the bot on my bot name, it doesn’t reply back

It can happen that you configured your Telegram token, you send the first message to try it out but it never replies back. To troubleshoot this we suggest you to:
  1. Make sure the bot works fine in Test mode
  2. Make sure the bot name you are using is not already used in Telegram app.
  3. Delete the bot name configuration on Typebot and configure it again while making sure you read all the instructions thoroughly.
  4. Make sure you don’t have any Start conditions or that your first message is matching the condition