Layers

Bots de Telegram en Layers

Su bot de Telegram funciona en Layers. Cambia una línea.

Layers responde a las solicitudes de la API de bots de Telegram. El bot sigue siendo el mismo código: usted cambia la dirección y el token, y el bot escribe en el grupo, muestra botones y recibe las respuestas de las personas.

Layers para equipos: los primeros 5 puestos gratis, después $4 por puesto al mes

Comprar puestos · $4 por puesto

Este texto se ha preparado con ayuda de IA.

Traslado

Cinco pasos, cinco minutos

El código del bot no se toca. Hace falta ser propietario o administrador del grupo.

  1. 1

    Añada el bot al grupo

    Abra un grupo o canal en Layers, elija «Más» → «Bots» → «Añadir bot» y póngale nombre. Aparecerá en el chat como un miembro con la marca «bot».
  2. 2

    Copie el token y el chat_id

    La ventana muestra un token como 1043:Qm7v… y el chat_id del chat. El token se muestra una sola vez: guárdelo donde guarda el token de Telegram. Si lo pierde, emita uno nuevo en la misma ventana; el anterior deja de funcionar de inmediato.
    Qué poner en el bot
    BOT_TOKEN=1043:Qm7v…
    CHAT_ID=-1000000000042
    API_BASE=https://app.layers.md/tgapi
  3. 3

    Cambie la dirección de la API

    Donde el bot llame a https://api.telegram.org, ponga https://app.layers.md/tgapi. En su propio servidor de Layers es la dirección de su servidor más /tgapi. En las bibliotecas es un solo ajuste.
    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)
    Sin biblioteca
    - https://api.telegram.org/bot$BOT_TOKEN/sendMessage
    + https://app.layers.md/tgapi/bot$BOT_TOKEN/sendMessage
  4. 4

    Compruebe la conexión

    Llame a getMe y envíe un mensaje. Las respuestas llegan con la misma forma que las de Telegram: {"ok": true, "result": …}, y los errores traen error_code y description.
    Comprobación desde la terminal
    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

    Active la recepción de mensajes

    El bot recibe los mensajes igual que en Telegram: consultando getUpdates o con un webhook setWebhook a su dirección https. En un grupo el bot ve los comandos, las menciones y las respuestas a sus propios mensajes; en un chat directo lo ve todo.
    Webhook
    curl https://app.layers.md/tgapi/bot$BOT_TOKEN/setWebhook \
      -d url=https://bot.example.com/telegram

Qué funciona

Métodos de la API de bots de Telegram a los que responde Layers

Los nombres de los métodos, los campos de las solicitudes y las respuestas son los de Telegram. A la derecha, cómo se ve en el chat.

QuéMétodosEn Layers
MensajessendMessage, editMessageText, deleteMessage, forwardMessage, copyMessageMensajes normales del chat: con formato HTML y MarkdownV2, respuestas y búsqueda.
Fotos, archivos, voz y vídeosendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendMediaGroup, getFileAdjuntos del mensaje; un mensaje de voz se reproduce como mensaje de voz. El bot descarga los archivos de las personas con getFile.
Botones bajo el mensajeinline_keyboard: callback_data, url, copy_text; answerCallbackQuery, editMessageReplyMarkupBotones bajo el mensaje del bot. La pulsación llega al bot como callback_query.
Teclado y respuesta al botkeyboard, one_time_keyboard, resize_keyboard, remove_keyboard, force_replyUn panel de botones sobre el campo de texto; force_reply abre el campo como respuesta al mensaje del bot.
ComandossetMyCommands, getMyCommands, deleteMyCommandsSugerencia de comandos cuando la persona escribe «/» en el campo de texto.
EntrantesgetUpdates, setWebhook, deleteWebhook, getWebhookInfoMensajes, ediciones, pulsaciones de botones, publicaciones del canal, reacciones y respuestas a encuestas.
Reacciones y mensajes fijadossetMessageReaction, pinChatMessage, unpinChatMessage, unpinAllChatMessagesReacciones y mensajes fijados del chat. Puede fijar un bot que sea administrador del grupo.
EncuestassendPoll, stopPollUna encuesta de Layers; los votos llegan al bot como poll_answer.
Grupo y miembrosgetChat, getChatMember, getChatAdministrators, getChatMemberCount, banChatMember, unbanChatMember, setChatTitle, setChatPhotoUn bot administrador del grupo borra mensajes ajenos, quita miembros y cambia el título y la imagen.
Ubicación, contacto, dadosendLocation, sendVenue, sendContact, sendDiceUn mensaje con coordenadas y enlace al mapa, con nombre y teléfono, con una tirada.

Qué falta

Lo que el bot no podrá hacer

Layers no tiene parte de lo que tiene Telegram. A esas llamadas Layers responde con un error claro, no con silencio.

QuéQué responde Layers
Modo inline: el bot en cualquier chat con @nombre (answerInlineQuery)400 Bad Request: method … is not supported by Layers
Pagos, Stars, regalosEl mismo error 400. Una factura se puede enviar como enlace en un mensaje normal.
Paquetes de stickers, juegos, historias, temas de foro, cuentas de empresaEl mismo error 400. Un sticker suelto se envía como imagen.
Botones web_app, login_url y pay, solicitud de teléfono y ubicación400 Bad Request con el nombre del botón. Los botones de enlace y los de callback_data funcionan.
Botones y teclado del bot en la aplicación del teléfonoPor ahora se ven en el navegador y en la aplicación de escritorio. En el teléfono llega el texto del mensaje.
Permisos de los miembros: restrictChatMember, setChatPermissions, promoteChatMember, setChatDescription400 Bad Request: not enough rights …. Un bot administrador sí puede quitar a un miembro (banChatMember) y borrar un mensaje.

Los números son otros: chat_id, user_id y message_id son propios de Layers. Si el bot los guarda en una base de datos, lleve registros aparte para Layers.

Preguntas

Lo esencial, en breve

Lo que más se pregunta.

¿Hay que reescribir el bot?

No. Cambian la dirección de la API y el token. Si el bot usa solo los métodos de la tabla «Qué funciona», el código queda como está.

¿Puede el bot funcionar en Telegram y en Layers a la vez?

Sí. Inicie una segunda instancia con la dirección y el token de Layers. Cada una tiene su token y sus chats, y no se estorban.

¿El bot ve toda la conversación del grupo?

No. En un grupo el bot recibe los comandos, las menciones y las respuestas a sus propios mensajes, como un bot de Telegram con el modo de privacidad activado. En un chat directo con el bot lo recibe todo.

¿Quién puede añadir un bot?

El propietario o un administrador del grupo o canal. La misma persona emite un token nuevo y quita el bot. Un bot quitado deja de recibir mensajes de inmediato y su token deja de funcionar.

¿Funciona en nuestro propio servidor de Layers?

Sí. La dirección es la de su servidor más /tgapi. El bot necesita acceso al servidor y, para el webhook, el servidor necesita acceso a la dirección https del bot.

¿Y los límites de frecuencia?

Como en Telegram: si envía a un mismo chat con demasiada frecuencia, llega 429 Too Many Requests con el campo retry_after. Las bibliotecas esperan y reintentan solas.

Conecte el bot y pruébelo en su grupo

Cinco minutos: añadir el bot, cambiar la dirección y el token, enviar el primer mensaje.

The Layers workspace