Telegram automation

Set up your bot. Learn the tools.

Find @Tivalsdeveloperbot in Telegram, connect a BotFather bot, and learn GitHub, Gmail, search and more. Send the examples below as Telegram messages.

Open Tivalsdeveloper bot

Connect your Telegram bot

Start by searching for @Tivalsdeveloperbot in Telegram. Check the username, tap Start, then send /app and tap Open app to launch the Mini App.

1. Get a token from BotFather

Open the verified @BotFather account and send /newbot.
Choose a name and a unique username ending in bot.
Copy the token privately. Treat it as a password.

2. Paste the token in the Mini App

Return to the Mini App opened from @Tivalsdeveloperbot.
Open Accounts & tools. Under Your Telegram bot, select Personal bot or Business bot, paste the BotFather token and tap Connect bot.
Save its name, purpose, and instructions in Bot Studio. Business owners can add business details in the Business tab.
Open your bot and send /start to test it.

3. Change the bot type in Settings

Open the Mini App Settings, choose Personal bot or Business bot under Bot type, and tap Save settings. You can also choose the type in Bot Studio and tap Save and update bot. For a business bot, add your business details, products and FAQs in the Business tab.

Never paste a bot token into a public chat or GitHub file. Connected account tools such as GitHub and Gmail are for the bot owner.

Connect more apps and tools

Open Accounts & tools in the Mini App, or send /connect in Telegram. Choose a service and follow its connection steps. Availability depends on the bot and connected account.

Gmail

Read, search, monitor, draft and confirm replies to email.

@gmail check my latest emails

GitHub

List files, read source code, create repositories and files, fix code and create issues where you have access.

@github list files tivalsdeveloper/my-project

Shopify

Connect your own store for published products, product search and customer browsing through /store.

@shopify product name

TikTok

Check your connected profile, stats and public videos where supported.

@tiktok show my stats

Website

Connect your website account; business owners can configure a domain restricted chat widget in the dashboard.

@website check my connected website

Built-in tools

Web search, YouTube, AI, photo understanding, voice, reminders and tutoring are available according to your bot settings.

/tools

How to use @ tools

Type @ to see available tools, or send @tool your request. Connect accounts with /connect before using private tools. Tool availability depends on which bot and accounts you have connected.

@github

Browse a repository, read code, create files or issues, and request code changes. Changes to repositories may ask you to confirm before they are made.

@github list files tivalsdeveloper/tivals-aiSee all GitHub examples

@gmail

Read connected mail and prepare replies. Sending requires your confirmation.

@gmail check my latest emails

@web and @ai

Search current information or ask your assistant for help.

@web latest Python release@ai explain Python loops simply

@youtube

Find videos and open their Telegram previews or links.

@youtube Python beginners tutorial

@image

On the main Tivals AI bot, describe an image to generate. On a connected personal bot, attach a photo and ask about it.

@image a blue robot in a classroom

Other tools

On connected bots, try @website, @voice, @reminder, or @tutor. The main bot also offers connected TikTok tools. Send /tools in the bot for its current list.

@reminder remind me tomorrow at 8 AM to study

How to use / commands

Start a message with a slash. Send /help or /tools for commands supported by the bot you are chatting with.

Command	What it does	Example
`/start`	Start the bot and see its welcome message.	`/start`
`/help`, `/tools`	See commands and tool examples.	`/tools`
`/app`	Open the Mini App dashboard to manage your bot.	`/app`
`/connect`, `/accounts`	Connect accounts or check connections.	`/accounts`
`/github`, `/gmail`	Open help for GitHub or Gmail tools.	`/github`
`/youtube`, `/search`	Find videos or information.	`/youtube Python tutorial`
`/lesson`, `/explain`, `/quiz`, `/practice`	Learn and practice a subject in a connected bot.	`/quiz fractions`
`/remind`, `/reminders`	Set and view reminders on supported bots.	`/remind tomorrow 8 AM study`
`/store`	Browse available published products.	`/store Python book`
`/grouphelp`	See how to use an owned bot in groups or channels.	`/grouphelp`

Many @ tools also work with / on the main Tivals AI bot. Some commands differ on bots that users connect themselves.

GitHub examples

Connect GitHub first using /connect. Replace owner/repository with a repository you can access, and use a real name instead of NAME. For file paths, include the full path from the repository root.

Inspect a repository

@github inspect tivalsdeveloper/tivals-ai@github list files tivalsdeveloper/tivals-ai@github list files tivalsdeveloper/tivals-ai:src@github read file tivalsdeveloper/tivals-ai:README.md

Create or change code

@github create file owner/repository:notes.txt containing Project notes@github add to file owner/repository:notes.txt | New exact line to add@github fix code owner/repository:src/app.js to handle empty input

Repositories and issues

@github create repository my-project as private@github create issue in owner/repository | Login button fails | Clicking Sign in does nothing

Creation and editing need write access to the selected account or repository.

Upload a document

Send a document to the main Tivals AI bot with this caption. Use a specific destination filename.

@github upload owner/repository:docs/guide.pdf

Use /github for help if an action is unavailable in your connected bot.

More Telegram setup details Open Tivals AI