Layers

Боты Telegram в Layers

Ваш бот Telegram работает в Layers. Меняется одна строка.

Layers отвечает на запросы Telegram Bot API. Бот остаётся тем же кодом: вы меняете адрес и токен, и он пишет в группу, показывает кнопки и получает ответы людей.

Layers для команды: первые 5 мест бесплатно, дальше $4 за место в месяц

Купить места · $4 за место

Этот текст подготовлен с помощью ИИ.

Перенос

Пять шагов, пять минут

Код бота не трогаем. Нужны права владельца или админа группы.

  1. 1

    Добавьте бота в группу

    Откройте группу или канал в Layers, выберите «Ещё» → «Боты» → «Добавить бота» и дайте боту имя. Он появится в чате участником с пометкой «бот».
  2. 2

    Скопируйте токен и chat_id

    Окно покажет токен вида 1043:Qm7v… и chat_id чата. Токен показывается один раз: сохраните его там же, где храните токен Telegram. Потеряли — выпустите новый в этом же окне, старый сразу перестанет работать.
    Что подставить в бота
    BOT_TOKEN=1043:Qm7v…
    CHAT_ID=-1000000000042
    API_BASE=https://app.layers.md/tgapi
  3. 3

    Замените адрес API

    Везде, где бот обращается к https://api.telegram.org, поставьте https://app.layers.md/tgapi. На своём сервере Layers — адрес вашего сервера и /tgapi. В библиотеках это одна настройка.
    python-telegram-bot
    from 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()
    )
    aiogram
    from 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. 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. 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, setChatDescription400 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. Библиотеки ждут и повторяют сами.

Подключите бота и проверьте на своей группе

Пять минут: добавить бота, заменить адрес и токен, отправить первое сообщение.

Рабочее пространство Layers