Saturn Studio : Telegram
Telegram es una aplicación de mensajería instantánea centrada en la velocidad y la seguridad. Es rápida, simple y gratuita.
📌 ¿Qué es este módulo?
Este módulo permite conectar Saturn Studio con bots de Telegram para enviar, recibir, editar, reenviar y administrar mensajes y usuarios mediante comandos automatizados.
📚 Descripción de los comandos
A continuación se detallan los comandos disponibles para la integración con Telegram:
🎣 Subscribe to webhook
Suscribe un webhook a Telegram para recibir actualizaciones.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para la suscripción. | credential |
📥 Wait for message
Espera un mensaje de un usuario.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para esperar mensajes. | credential |
| Simplify data | Simplifica los datos del mensaje. | |
| Assign result to variable | Variable donde se almacenará el resultado. | {var} |
🔄 Get Updates
Obtiene actualizaciones de un bot de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para obtener actualizaciones. | credential |
| Assign result to variable | Variable donde se almacenará el resultado. | [{“update_id” 123456789, “message” {“message_id” 34, “from” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “rocket_bot”}, “chat” {“id” 1405976330, “first_name” “JohnDoe”, “username” “JohnDoe3”, “type” “private”}, “date” 1732633524, “text” “Hello Rocketbot”}}] |
✉️ Send a Text Message
Envía un mensaje de texto a un usuario de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para enviar mensajes. | credential |
| Chat ID | ID del chat donde se enviará el mensaje. | 1405976330 |
| Parse Mode | Formato del texto a enviar. | HTML, Markdown o Text |
| Message | El mensaje que será enviado. | Hello Rocketbot |
| Assign result to variable | Variable donde se almacenará el resultado. | {“message_id” 34, “from” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “bot_name”}, “chat” {“id” -4573610518, “title” “Telegram Chat Bot”, “type” “group”, “all_members_are_administrators” true}, “date” 1732633524, “text” “Hello Rocketbot”} |
✏️ Edit a Text Message
Edita un mensaje de texto enviado por un bot (no disponible después de 48 horas).
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para editar mensajes. | credential |
| Chat ID | ID del chat donde se editará el mensaje. | 1405976330 |
| Message ID | ID del mensaje a editar. | 34 |
| Parse Mode | Formato del texto a editar. | HTML, Markdown o Text |
| Message | El nuevo contenido del mensaje. | Hello Rocketbot |
| Assign result to variable | Variable donde se almacenará el resultado. | {“message_id” 124, “from” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “rocket_bot”}, “chat” {“id” 1405976330, “first_name” “JohnDoe”, “username” “JohnDoe3”, “type” “private”}, “date” 1732648915, “edit_date” 1732649378, “text” “Edited message”} |
➡️ Forward a Message
Reenvía un mensaje de un chat de Telegram a otro.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para reenviar mensajes. | credential |
| Chat ID | ID del chat a donde se reenviará el mensaje. | -4573610518 |
| From Chat ID | ID del chat donde se encuentra el mensaje original. | 1405976330 |
| Message ID | ID del mensaje a reenviar. | 34 |
| Assign result to variable | Variable donde se almacenará el resultado. | {“message_id” 125, “from” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “rocket_bot”}, “chat” {“id” -4573610518, “title” “Telegram Chat Bot”, “type” “group”, “all_members_are_administrators” true}, “date” 1732649103, “forward_origin” {“type” “user”, “sender_user” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “rocket_bot”}, “date” 1732648915}, “forward_from” {“id” 7860667536, “is_bot” true, “first_name” “rocketbot”, “username” “rocket_bot”}, “forward_date” 1732648915, “text” “Mensaje que se reenviado”} |
🗑️ Delete a Message
Elimina un mensaje de un chat de Telegram (no disponible después de 48 horas).
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para eliminar mensajes. | credential |
| Chat ID | ID del chat donde se eliminará el mensaje. | -4573610518 |
| Message ID | ID del mensaje a eliminar. | 34 |
| Assign result to variable | Variable donde se almacenará el resultado (true o false). | {var} |
📌 Pin a Message
Fija un mensaje en un chat de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para fijar un mensaje. | credential |
| Chat ID | ID del chat donde se fijará el mensaje. | -4573610518 |
| Message ID | ID del mensaje a fijar. | 34 |
| Assign result to variable | Variable donde se almacenará el resultado (true o false). | {var} |
📍 Unpin a Message
Desancla un mensaje en un chat de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para desanclar un mensaje. | credential |
| Chat ID | ID del chat donde se desanclará el mensaje. | -4573610518 |
| Message ID | ID del mensaje a desanclar. | 34 |
| Assign result to variable | Variable donde se almacenará el resultado (true o false). | {var} |
🖼️ Send Media
Envía un archivo multimedia a un usuario de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para enviar multimedia. | credential |
| Chat ID | ID del chat donde se enviará el archivo. | 1405976330 |
| Media Type | Tipo de archivo a enviar. | Audio, Document, Photo, Video o Sticker |
| Send by | Método de envío del archivo. | Data, HTTP URL o File ID |
| File Name | Nombre del archivo a enviar. | File name |
| Media Data | Datos del archivo (URL o ID). | http://www.example.com/file |
| Parse Mode | Formato del pie de foto. | HTML, Markdown o Text |
| Assign result to variable | Variable donde se almacenará el resultado. | {“message_id”29,”from”{“id”7860667536,”is_bot”true,”first_name””rocketbot”,”username””rocket_bot”},”chat”{“id”-1002396539056,”title””Telegram Chat Bot”,”type””supergroup”},”date”1732907392,”audio”{“duration”5,”file_name””Water_Splash_2.mp3″,”mime_type””audio/mpeg”,”title””Water_Splash_2″,”performer””The Recordist”,”file_id””CQACAgQAAxkDAAOHZ0dm5XQ-rukm4LV1jY-0hqVLXRcAAnYAA1nRnFANL8XLLNwmojYE”,”file_unique_id””AgADdgADWdGcUA”,”file_size”302751}} |
💾 Download a File
Descarga un archivo desde un chat de Telegram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram necesaria para descargar archivos. | credential |
| File ID | ID del archivo a descargar. | file_id |
| Assign result to variable | Variable donde se almacenará el resultado. | [{“filename””file.xlsx”,”id””60d02f73e681281f219a1g1cb4665f693627ec84f230f41e19bccd258222bb64f645d1fdea771402d2976bc7d7504c15aff740ce1ceee86a6e724c6068dd1502″,”size”11009,”provider””excel”}] |
🔗 Create a Chat Invite Link
Crea un enlace de invitación a un chat.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram para crear un enlace de invitación. | credential |
| Chat ID | ID del chat para el cual se creará el enlace. | 1405976330 |
| Name | Nombre del enlace de invitación. | MyInviteLink |
| Expire Date | Fecha de caducidad del enlace. | 1-1-2025 |
| Member Limit | Límite de usuarios que pueden unirse con el enlace. | 100 |
| Assign result to variable | Variable donde se almacenará el resultado. | {“invite_link””https//t.me/+ivwEK0lIx-tmODNh”,”creator”{“id”7860667536,”is_bot”true,”first_name””rocketbot”,”username””rocket_bot”},”expire_date”1764558000,”member_limit”10,”creates_join_request”false,”is_primary”false,”is_revoked”false} |
⛓️ Revoke a Chat Invite Link
Revoca un enlace de invitación a un chat.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram para revocar un enlace. | credential |
| Chat ID | ID del chat del que se revocará el enlace. | 1405976330 |
| Invite Link | El enlace de invitación a revocar. | https://t.me/+ivwEK0lIx-tmODNh |
| Assign result to variable | Variable donde se almacenará el resultado. | {“invite_link””https//t.me/+ivwEK0lIx-tmODNh”,”creator”{“id”7860667536,”is_bot”true,”first_name””rocketbot”,”username””rocket_bot”},”expire_date”1764558000,”member_limit”10,”creates_join_request”false,”is_primary”false,”is_revoked”true} |
👢 Kick a Chat Member
Expulsa a un miembro de un chat.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram para expulsar miembros. | credential |
| Chat ID | ID del chat de donde será expulsado el usuario. | 1405976330 |
| User ID | ID del usuario a expulsar. | 1674143648 |
| Assign result to variable | Variable donde se almacenará el resultado (true o false). |
{var} |
⭐ Promote a Chat Member
Promueve a un miembro del chat a administrador.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credential | Credencial de Telegram para promover miembros. | credential |
| Chat ID | ID del chat donde se promoverá al usuario. | 1405976330 |
| User ID | ID del usuario a promover. | 1674143648 |
| Can Change Info | Permite al admin cambiar info del chat. | True |
| Can Create Posts | Permite al admin crear posts (solo canales). | True |
| Can Edit Messages | Permite al admin editar mensajes (solo canales). | True |
| Can Delete Messages | Permite al admin borrar mensajes (solo canales). | True |
| Can Invite Users | Permite al admin invitar nuevos usuarios. | True |
| Can Restrict Members | Permite al admin restringir o banear miembros. | True |
| Can Pin Messages | Permite al admin fijar mensajes (solo supergrupos). | True |
| Can Promote Members | Permite al admin añadir nuevos administradores. | True |
| Assign result to variable | Variable donde se almacenará el resultado (true o false). | {var} |
🧪 Ejemplo de uso
- Wait for message: Crear un bot de atención al cliente que espere consultas de los usuarios y las registre en un sistema de tickets.
- Send a Text Message: Notificar a un administrador cuando una tarea crítica en un sistema ha finalizado.
- Send Media: Automatizar el envío de un reporte diario en formato PDF a un grupo de trabajo.
- Kick a Chat Member: Expulsar automáticamente a usuarios de un grupo si publican mensajes considerados como spam.
- Pin a Message: Fijar un mensaje con las reglas del grupo o un anuncio importante cada vez que se inicia el bot.
🧩 Requisitos
- Tener una cuenta de Telegram.
- Crear un bot de Telegram hablando con @BotFather dentro de la aplicación para obtener un token de API.
- La credencial requerida en los comandos corresponde al token del API del bot.
- Conocer el Chat ID del usuario, grupo o canal con el que se desea interactuar.
- Asegurarse de que el bot tenga los permisos necesarios en el chat de destino (por ejemplo, ser administrador para poder eliminar mensajes, expulsar usuarios o fijar mensajes).