Боты Telegram в Layers
Ваш бот Telegram работает в Layers. Меняется одна строка.
Layers отвечает на запросы Telegram Bot API. Бот остаётся тем же кодом: вы меняете адрес и токен, и он пишет в группу, показывает кнопки и получает ответы людей.
Layers для команды: первые 5 мест бесплатно, дальше $4 за место в месяц
Купить места · $4 за местоЭтот текст подготовлен с помощью ИИ.
Перенос
Пять шагов, пять минут
Код бота не трогаем. Нужны права владельца или админа группы.
- 1
Добавьте бота в группу
Откройте группу или канал в Layers, выберите «Ещё» → «Боты» → «Добавить бота» и дайте боту имя. Он появится в чате участником с пометкой «бот». - 2
Скопируйте токен и chat_id
Окно покажет токен вида1043:Qm7v…иchat_idчата. Токен показывается один раз: сохраните его там же, где храните токен Telegram. Потеряли — выпустите новый в этом же окне, старый сразу перестанет работать.Что подставить в ботаBOT_TOKEN=1043:Qm7v… CHAT_ID=-1000000000042 API_BASE=https://app.layers.md/tgapi - 3
Замените адрес API
Везде, где бот обращается кhttps://api.telegram.org, поставьтеhttps://app.layers.md/tgapi. На своём сервере Layers — адрес вашего сервера и/tgapi. В библиотеках это одна настройка.python-telegram-botfrom telegram.ext import ApplicationBuilder app = ( ApplicationBuilder() .token(BOT_TOKEN) .base_url("https://app.layers.md/tgapi/bot") .base_file_url("https://app.layers.md/tgapi/file/bot") .build() )aiogramfrom aiogram import Bot from aiogram.client.session.aiohttp import AiohttpSession from aiogram.client.telegram import TelegramAPIServer session = AiohttpSession(api=TelegramAPIServer.from_base("https://app.layers.md/tgapi")) bot = Bot(BOT_TOKEN, session=session)Без библиотеки- https://api.telegram.org/bot$BOT_TOKEN/sendMessage + https://app.layers.md/tgapi/bot$BOT_TOKEN/sendMessage - 4
Проверьте связь
СпроситеgetMeи отправьте сообщение. Ответы приходят в том же виде, что у Telegram:{"ok": true, "result": …}, а ошибки — сerror_codeиdescription.Проверка из терминалаcurl https://app.layers.md/tgapi/bot$BOT_TOKEN/getMe curl https://app.layers.md/tgapi/bot$BOT_TOKEN/sendMessage \ -d chat_id=$CHAT_ID -d text="ok" - 5
Включите приём сообщений
Бот получает сообщения так же, как в Telegram: опросомgetUpdatesили вебхукомsetWebhookна ваш адрес по https. В группе бот видит команды, упоминания и ответы на свои сообщения; в личке — всё.Вебхукcurl https://app.layers.md/tgapi/bot$BOT_TOKEN/setWebhook \ -d url=https://bot.example.com/telegram
Что работает
Методы Telegram Bot API, на которые отвечает Layers
Имена методов, поля запросов и ответов — как в Telegram. Справа — как это выглядит в чате.
| Что | Методы | В Layers |
|---|---|---|
| Сообщения | sendMessage, editMessageText, deleteMessage, forwardMessage, copyMessage | Обычные сообщения чата: с разметкой HTML и MarkdownV2, ответами, поиском. |
| Фото, файлы, голос и видео | sendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendMediaGroup, getFile | Вложения сообщения; голосовое играет как голосовое. Файлы людей бот скачивает через getFile. |
| Кнопки под сообщением | inline_keyboard: callback_data, url, copy_text; answerCallbackQuery, editMessageReplyMarkup | Кнопки под сообщением бота. Нажатие приходит боту как callback_query. |
| Клавиатура и ответ боту | keyboard, one_time_keyboard, resize_keyboard, remove_keyboard, force_reply | Панель кнопок над полем ввода; force_reply открывает поле ответом на сообщение бота. |
| Команды | setMyCommands, getMyCommands, deleteMyCommands | Подсказка команд, когда человек набирает «/» в поле ввода. |
| Входящие | getUpdates, setWebhook, deleteWebhook, getWebhookInfo | Сообщения, правки, нажатия кнопок, записи канала, реакции и ответы на опросы. |
| Реакции и закрепление | setMessageReaction, pinChatMessage, unpinChatMessage, unpinAllChatMessages | Реакции и закреплённые сообщения чата. Закреплять может бот-админ группы. |
| Опросы | sendPoll, stopPoll | Опрос Layers; голоса приходят боту как poll_answer. |
| Группа и участники | getChat, getChatMember, getChatAdministrators, getChatMemberCount, banChatMember, unbanChatMember, setChatTitle, setChatPhoto | Бот-админ группы удаляет чужие сообщения, убирает участников, меняет название и картинку. |
| Место, контакт, кубик | sendLocation, sendVenue, sendContact, sendDice | Сообщение с координатами и ссылкой на карту, с именем и телефоном, с броском. |
Чего нет
Что бот не сможет
В Layers нет части того, что есть в Telegram. На такие вызовы Layers отвечает понятной ошибкой, а не молчит.
| Что | Что ответит Layers |
|---|---|
| Инлайн-режим: бот в любом чате через @имя (answerInlineQuery) | 400 Bad Request: method … is not supported by Layers |
| Платежи, Stars, подарки | Та же ошибка 400. Счёт можно отправить ссылкой в обычном сообщении. |
| Стикер-наборы, игры, истории, темы форума, бизнес-учётки | Та же ошибка 400. Отдельный стикер уходит картинкой. |
| Кнопки web_app, login_url, pay, запрос телефона и места | 400 Bad Request с названием кнопки. Кнопки-ссылки и кнопки с callback_data работают. |
| Кнопки и клавиатура бота в приложении на телефоне | Пока видны в браузере и в приложении для компьютера. На телефоне приходит текст сообщения. |
| Права участников: restrictChatMember, setChatPermissions, promoteChatMember, setChatDescription | 400 Bad Request: not enough rights …. Убрать участника (banChatMember) и удалить сообщение бот-админ может. |
Числа другие: chat_id, user_id и message_id в Layers свои. Если бот хранит их в базе, для Layers заведите отдельные записи.
Вопросы
Коротко о главном
То, о чём спрашивают чаще всего.
Нужно ли переписывать бота?
Нет. Меняются адрес API и токен. Если бот пользуется только методами из таблицы «Что работает», код остаётся прежним.
Бот может работать в Telegram и в Layers одновременно?
Да. Запустите второй экземпляр с адресом и токеном Layers. У каждого свой токен и свои чаты, друг другу они не мешают.
Бот видит всю переписку группы?
Нет. В группе бот получает команды, упоминания и ответы на свои сообщения, как бот Telegram с включённым режимом приватности. В личке с ботом он получает всё.
Кто может добавить бота?
Владелец или админ группы или канала. Он же выпускает новый токен и убирает бота. Убранный бот сразу перестаёт получать сообщения, его токен перестаёт работать.
Работает ли это на своём сервере Layers?
Да. Адрес — адрес вашего сервера и /tgapi. Боту нужен доступ к серверу, а для вебхука серверу нужен доступ к адресу бота по https.
Что с ограничением частоты запросов?
Как у Telegram: при слишком частых отправках в один чат приходит 429 Too Many Requests с полем retry_after. Библиотеки ждут и повторяют сами.
Подключите бота и проверьте на своей группе
Пять минут: добавить бота, заменить адрес и токен, отправить первое сообщение.
