Как создать бота для отправки кружков в Телеграм: пошаговое руководство для начинающих

Конвертация видео

Пользователь отправляет обычный видеофайл — бот возвращает готовый кружок размером 240×240, длительностью до 60 секунд.

Автоматизация

Никаких видеоредакторов: обрезка, масштабирование и перекодирование происходят на сервере за считаные секунды.

Контент для каналов

Администраторы каналов получают инструмент для быстрой публикации кружков в ленту без сторонних приложений.

Регистрация бота через BotFather

Откройте диалог с @BotFather в Телеграм, отправьте команду /newbot, придумайте имя и юзернейм (обязательно заканчивается на «bot»). В ответ вы получите токен — длинную строку вида 123456:ABC-DEF…. Это ключ доступа к API, храните его в секрете.

Установка инструментов

Понадобятся три вещи: Python 3.10+, библиотека python-telegram-bot (или aiogram) и FFmpeg — именно он будет обрезать видео до квадрата и перекодировать его. Установка занимает пару команд в терминале.

Написание логики бота

Боту нужно всего три обработчика: команда /start с приветствием, приём видеофайла от пользователя и функция конвертации. Дальше FFmpeg делает магию: вырезает центральный квадрат, масштабирует до 384×384 и ограничивает длину 60 секундами.

Отправка кружка пользователю

Готовый файл отправляется методом sendVideoNote — именно он превращает видео в круглое сообщение, а не в обычный вложенный файл. Это ключевая строка всего проекта.

Запуск и тестирование

Запустите скрипт, найдите бота в Телеграм по юзернейму, отправьте ему короткое видео и дождитесь ответа. Если кружок пришёл — бот работает. Для постоянной работы перенесите его на сервер (VPS за пару долларов в месяц вполне достаточно).

import asyncio, subprocess, os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message, FSInputFile

TOKEN = "ВАШ_ТОКЕН_ОТ_BOTFATHER"

bot = Bot(TOKEN)
dp = Dispatcher()

@dp.message(F.video | F.video_note)
async def make_circle(msg: Message):
    video = msg.video or msg.video_note
    src = f"in_{msg.from_user.id}.mp4"
    dst = f"out_{msg.from_user.id}.mp4"

    await bot.download(video.file_id, src)

    # FFmpeg: центральный квадрат, 384x384, максимум 60 сек
    subprocess.run([
        "ffmpeg", "-y", "-i", src,
        "-t", "60",
        "-vf", "crop='min(iw,ih)':'min(iw,ih)',scale=384:384",
        "-c:v", "libx264", "-c:a", "aac", dst
    ])

    await msg.answer_video_note(FSInputFile(dst))
    os.remove(src); os.remove(dst)

async def main():
    await dp.start_polling(bot)

asyncio.run(main())