Zenbot implements Telegram bot API, so you do not have to have an external hosting to make your natural language speaking bot for Telegram. Just provide your Telegram's bot Authorization token in Zenbot's bot settings, and it will start speaking with your users over Telegram.

How to create a Telegram bot

There is a complete guide about how to create Telegram bot and obtain it's Authorization token.

Just provide this token in your Zenbot's bot Telegram settings.

Test your Telegram bot

Select your bot in Telegram and send a text message. Your bot will respond with text responses regarding the Botscript.

Note that telegram can also interpret HTML tags in responses. Thus your bot can respond with HTML links and Telegram will load snippets of web pages on fly in chat window.

Start message

Each time a user presses “Start” button in Telegram messenger client, your bot receives a “/start” message following by some optional payload.

If you would like you bot to react on such a message, just define a /start $Text input pattern in your Botscript. In this case $Text variable will contain an optional payload passed by /start command to your bot via deep linking.

Response formatting

Please use a Markdown formatting in each response of your bot if you wish to format a text with bold, italic, pre-formatted or insert any URL links.

  Note that you must enclose each URL link in [] and ()

Botan analytics

Zenbot currently supports a Botan analytics service API to track your Telegram bot's statistics.

This service enables your bot to store it's analytics data automatically for each user's request. Further you can track bot's metrics through a special Botan bot in Telegram.

To enable Botan integration for your bot, just obtain a Botan token and provide it through the web console in the “Telegram settings” section.

  Note that Zenbot will track only identifiers of inputs. So if the matched input has not an "id" attribute, it will not be tracked.

Variables

Each time Zenbot receives a request from Telegram, it produces a set of special variables.

  • req_telegram_token - your Telegram bot Token
  • req_telegram_chat - current Telegram chat identifier

Find more available variables in Global Variables chapter.

Restrictions

Please note that Telegram doesn't provide any extended info about the user, like latitude and longitude, current time and GMT offset. Thus you have to obtain this data on your own if you need it.