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 puestoEste 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
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
Copie el token y el chat_id
La ventana muestra un token como1043:Qm7v…y elchat_iddel 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 botBOT_TOKEN=1043:Qm7v… CHAT_ID=-1000000000042 API_BASE=https://app.layers.md/tgapi - 3
Cambie la dirección de la API
Donde el bot llame ahttps://api.telegram.org, pongahttps://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-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)Sin biblioteca- https://api.telegram.org/bot$BOT_TOKEN/sendMessage + https://app.layers.md/tgapi/bot$BOT_TOKEN/sendMessage - 4
Compruebe la conexión
Llame agetMey envíe un mensaje. Las respuestas llegan con la misma forma que las de Telegram:{"ok": true, "result": …}, y los errores traenerror_codeydescription.Comprobación desde la terminalcurl 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
Active la recepción de mensajes
El bot recibe los mensajes igual que en Telegram: consultandogetUpdateso con un webhooksetWebhooka 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.Webhookcurl 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étodos | En Layers |
|---|---|---|
| Mensajes | sendMessage, editMessageText, deleteMessage, forwardMessage, copyMessage | Mensajes normales del chat: con formato HTML y MarkdownV2, respuestas y búsqueda. |
| Fotos, archivos, voz y vídeo | sendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendMediaGroup, getFile | Adjuntos 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 mensaje | inline_keyboard: callback_data, url, copy_text; answerCallbackQuery, editMessageReplyMarkup | Botones bajo el mensaje del bot. La pulsación llega al bot como callback_query. |
| Teclado y respuesta al bot | keyboard, one_time_keyboard, resize_keyboard, remove_keyboard, force_reply | Un panel de botones sobre el campo de texto; force_reply abre el campo como respuesta al mensaje del bot. |
| Comandos | setMyCommands, getMyCommands, deleteMyCommands | Sugerencia de comandos cuando la persona escribe «/» en el campo de texto. |
| Entrantes | getUpdates, setWebhook, deleteWebhook, getWebhookInfo | Mensajes, ediciones, pulsaciones de botones, publicaciones del canal, reacciones y respuestas a encuestas. |
| Reacciones y mensajes fijados | setMessageReaction, pinChatMessage, unpinChatMessage, unpinAllChatMessages | Reacciones y mensajes fijados del chat. Puede fijar un bot que sea administrador del grupo. |
| Encuestas | sendPoll, stopPoll | Una encuesta de Layers; los votos llegan al bot como poll_answer. |
| Grupo y miembros | getChat, getChatMember, getChatAdministrators, getChatMemberCount, banChatMember, unbanChatMember, setChatTitle, setChatPhoto | Un bot administrador del grupo borra mensajes ajenos, quita miembros y cambia el título y la imagen. |
| Ubicación, contacto, dado | sendLocation, sendVenue, sendContact, sendDice | Un 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, regalos | El mismo error 400. Una factura se puede enviar como enlace en un mensaje normal. |
| Paquetes de stickers, juegos, historias, temas de foro, cuentas de empresa | El mismo error 400. Un sticker suelto se envía como imagen. |
| Botones web_app, login_url y pay, solicitud de teléfono y ubicación | 400 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éfono | Por 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, setChatDescription | 400 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.
