Skip to main content

Быстрый старт за 5 минут

Создадим простейшего бота: он будет отвечать тем же текстом, что вы ему пишете.

Шаг 1. Зарегистрировать бота​

  1. Откройте Telefon и войдите в аккаунт.
  2. Найдите в чатах @botmaker — это служебный бот, который управляет вашими ботами.
  3. Нажмите кнопку «➕ Новый бот» в его меню.
  4. Введите имя бота (например, «Мой первый бот») и @username (3–32 символа a-z 0-9 _).
  5. Скопируйте токен — длинная строка вида kOyGMoA8cdbI9-Mt_fLScM7cXJBPOOob…. Сохраните, он показывается один раз.
tip

Если потеряли токен — нажмите «Сбросить токен» в настройках бота. Старый перестанет работать.

Шаг 2. Установить библиотеку​

Самый удобный путь — Python с библиотекой aiogram.

mkdir my-bot && cd my-bot
python3 -m venv venv && source venv/bin/activate
pip install aiogram

Шаг 3. Написать код​

Создайте файл bot.py:

import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer
from aiogram.filters import CommandStart
from aiogram.types import Message

# Подменяем базовый URL на наш:
session = AiohttpSession(
    api=TelegramAPIServer.from_base("https://api.telefon.chat")
)

bot = Bot(token=os.environ["BOT_TOKEN"], session=session)
dp = Dispatcher()

@dp.message(CommandStart())
async def start(m: Message):
    await m.answer("Привет! Я повторяю всё, что ты пишешь.")

@dp.message(F.text)
async def echo(m: Message):
    await m.answer(m.text)

if __name__ == "__main__":
    asyncio.run(dp.start_polling(bot))

Примечание про имена: TelegramAPIServer — это название класса внутри библиотеки aiogram, параметризующего базовый URL HTTP-клиента. Достаточно передать наш URL — никакая логика к чужому сервису не подмешивается.

Шаг 4. Запустить​

BOT_TOKEN=ваш_токен_сюда python bot.py

В терминале должны появиться строки INFO ... Start polling. Бот работает.

Шаг 5. Проверить​

  1. В Telefon найдите своего бота по @username, который вы задали.
  2. Нажмите «Начать» или отправьте /start.
  3. Бот ответит приветствием.
  4. Пришлите любой текст — бот вернёт его обратно.

🎉 Готово. У вас работает первый бот.

Что дальше​

Готовые шаблоны​

Вы можете не писать с нуля, а взять готовый бот: