DocumentaciónWorkflowsApps y servicios
Telegram nodo
Envía mensajes de texto con tu bot de Telegram y responde a clics en botones inline, en chats privados, grupos, canales y temas de foro. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
9 min de lecturaActualizado el
Qué hace este nodo
Envía mensajes de texto con tu bot de Telegram y responde a clics en botones inline, en chats privados, grupos, canales y temas de foro.
Usa Telegram como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade Telegram desde el catálogo de nodos.
- 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 04Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
Elige la función necesaria en Operación. El panel mostrará los ajustes correspondientes.
- Enviar mensaje
- Responder al clic del botón
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Bot de Telegram | Elige el token del bot en los secretos del workflow. Permanece cifrado y nunca se guarda en el workflow. | Protegido |
| Operación | Envía un mensaje o confirma un clic en un botón inline. | Estándar |
| ID de chat o @canal | Chat de destino. Usa @nombrecanal para canales; chats privados y grupos usan su ID numérico. | Estándar |
| Mensaje | Texto del mensaje. Telegram admite hasta 4096 caracteres tras procesarlo. | Estándar |
| Formato | Formato opcional de Telegram. Los caracteres especiales de MarkdownV2 deben escaparse según sus reglas. | Estándar |
| ID del tema del foro | Opcional. Envía el mensaje a un tema concreto de un supergrupo. | Estándar |
| Responder al ID de mensaje | Campo práctico opcional que se integra en reply_parameters.message_id. | Estándar |
| Enviar en silencio | Envía sin sonido de notificación. El mensaje sigue visible. | Estándar |
| Impedir reenvío y guardado | Protege el contenido frente al reenvío y guardado local si Telegram lo admite. | Estándar |
| Vista previa del enlace | Objeto LinkPreviewOptions opcional con autocompletado JSON desde nodos anteriores. | Estándar |
| Parámetros de respuesta | Objeto ReplyParameters opcional que se combina con el campo práctico de ID. | Estándar |
| Botones o teclado personalizado | Objeto JSON opcional InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove o ForceReply. | Estándar |
| ID de consulta callback | Obligatorio. Usa callback_query.id del trigger de Telegram. Telegram muestra un indicador de carga en el botón hasta que se confirma. | Estándar |
| Texto del aviso | Aviso opcional de 0 a 200 caracteres. Sin texto, solo se detiene el indicador de carga. | Estándar |
| Mostrar como alerta | Muestra el aviso como diálogo en lugar de una notificación breve en la parte superior. | Estándar |
| URL de callback | Opcional. Abre una URL HTTPS en Telegram; las URL de juegos solo funcionan con botones callback_game. | Estándar |
| Duración de caché (segundos) | Opcional. Cuánto tiempo pueden guardar el resultado los clientes de Telegram. El valor predeterminado es 0. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| ID del chat | Configura este valor en el panel del nodo. | text |
| Mensaje | Configura este valor en el panel del nodo. | text |
| ID del tema | Configura este valor en el panel del nodo. | number |
| Responder a | Configura este valor en el panel del nodo. | number |
| Botones | Configura este valor en el panel del nodo. | json |
| ID de consulta callback | Configura este valor en el panel del nodo. | text |
| Aviso de callback | Configura este valor en el panel del nodo. | text |
| Mostrar como alerta | Configura este valor en el panel del nodo. | boolean |
| URL de callback | Configura este valor en el panel del nodo. | text |
| Duración de caché | Configura este valor en el panel del nodo. | number |
| Salida | Significado | Tipo |
|---|---|---|
| Correcto | Configura este valor en el panel del nodo. | boolean |
| ID del mensaje | Configura este valor en el panel del nodo. | number |
| ID del chat | Configura este valor en el panel del nodo. | text |
| Enviado el | Configura este valor en el panel del nodo. | number |
| Mensaje de Telegram | Respuesta Message completa de la API Bot de Telegram. | json |
| Callback respondido | Verdadero cuando Telegram aceptó la respuesta al clic del botón. | boolean |
| ID de consulta callback respondida | Configura este valor en el panel del nodo. | text |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Enviar un estado con un botón inline: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"chat_id": "-1001234567890",
"text": "<b>Deployment abgeschlossen</b>\nVersion 2.4.0 ist live.",
"parse_mode": "HTML",
"reply_markup": {
"inline_keyboard": [
[
{
"text": "Dashboard öffnen",
"url": "https://example.com/status"
}
]
]
}
}Acceso y seguridad
Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- La lista se procesa una sola vez: activa la ejecución por elemento.