Quick Start Guide: Telegram Bot

Quick Start Guide On-chain AI Agent on Telegram

Introduction

This guide demonstrates how to build a Telegram bot that interacts with the Cronos network. The bot enable users to query blockchain information and execute transactions smoothly. Follow these steps to quickly set up and test the example bot provided in our SDK. For a demonstration of the AI Agent in action, refer to this video.

Prerequisites

Before starting, ensure you have the following components ready.

1. AI-Agent-Service

   • See Self-Hosting AI-Agent-Server to run your local AI agent;

2. AI-Agent-Signer-App

   • See "Magic Link" Signer (Optional for on-chain transaction execution)

3. Required Accounts & Tools

   • Telegram Bot Token

   • Conda (Package Manager)

Get Started

Step 1 - Environment Variables Setup

Set up the environment variables, which includes Explorer API keys, OpenAI API keys, and Telegram bot token by:

export CRONOS_ZKEVM_TESTNET_API=your_explorer_api_key_here
export OPENAI_API_KEY=your_openai_api_key_here
export TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

Step 2 - Set Up Telegram Bot

1. Clone the repository and navigate to the bot directory:

git clone https://github.com/crypto-com/developer-platform-sdk-examples.git
cd developer-platform-sdk-examples/bot/cryptocom-ai-telegram-bot

1. Create a Python virtual environment:

conda create -n telegram-bot python=3.10
conda activate telegram-bot

1. Install dependencies:

pip install -r requirements.txt

Step 3 - Run everything

Now start the Telegram bot by executing the script:

python bot.py

Once the bot is running, test it to ensure it’s working as expected:

1. Open Telegram and search for your bot using the bot name you set up with @BotFather.

2. Send a sample command or message, such as /start, to see if the bot responds.

---

Troubleshooting

If you encounter issues during setup or execution, follow these tips:

• Check your API keys to ensure they are correctly set in the environment variables.

• Verify dependencies by confirming that all packages in requirements.txt are installed.

• Review Telegram Bot API limitations to ensure compliance with rate limits and usage guidelines.

What’s Next?

• Explore advanced use cases and customizations in the Examples section.

• Visit the API Reference for detailed information on available functionalities.

• Join our community to share feedback or ask questions.