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

  1. 01Abre un workflow y añade Telegram desde el catálogo de nodos.
  2. 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
  3. 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
  4. 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

CampoSignificadoÁrea
Bot de TelegramElige el token del bot en los secretos del workflow. Permanece cifrado y nunca se guarda en el workflow.Protegido
OperaciónEnvía un mensaje o confirma un clic en un botón inline.Estándar
ID de chat o @canalChat de destino. Usa @nombrecanal para canales; chats privados y grupos usan su ID numérico.Estándar
MensajeTexto del mensaje. Telegram admite hasta 4096 caracteres tras procesarlo.Estándar
FormatoFormato opcional de Telegram. Los caracteres especiales de MarkdownV2 deben escaparse según sus reglas.Estándar
ID del tema del foroOpcional. Envía el mensaje a un tema concreto de un supergrupo.Estándar
Responder al ID de mensajeCampo práctico opcional que se integra en reply_parameters.message_id.Estándar
Enviar en silencioEnvía sin sonido de notificación. El mensaje sigue visible.Estándar
Impedir reenvío y guardadoProtege el contenido frente al reenvío y guardado local si Telegram lo admite.Estándar
Vista previa del enlaceObjeto LinkPreviewOptions opcional con autocompletado JSON desde nodos anteriores.Estándar
Parámetros de respuestaObjeto ReplyParameters opcional que se combina con el campo práctico de ID.Estándar
Botones o teclado personalizadoObjeto JSON opcional InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove o ForceReply.Estándar
ID de consulta callbackObligatorio. 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 avisoAviso opcional de 0 a 200 caracteres. Sin texto, solo se detiene el indicador de carga.Estándar
Mostrar como alertaMuestra el aviso como diálogo en lugar de una notificación breve en la parte superior.Estándar
URL de callbackOpcional. 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 elementoDesactivado (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

EntradaSignificadoTipo
ID del chatConfigura este valor en el panel del nodo.text
MensajeConfigura este valor en el panel del nodo.text
ID del temaConfigura este valor en el panel del nodo.number
Responder aConfigura este valor en el panel del nodo.number
BotonesConfigura este valor en el panel del nodo.json
ID de consulta callbackConfigura este valor en el panel del nodo.text
Aviso de callbackConfigura este valor en el panel del nodo.text
Mostrar como alertaConfigura este valor en el panel del nodo.boolean
URL de callbackConfigura este valor en el panel del nodo.text
Duración de cachéConfigura este valor en el panel del nodo.number
SalidaSignificadoTipo
CorrectoConfigura este valor en el panel del nodo.boolean
ID del mensajeConfigura este valor en el panel del nodo.number
ID del chatConfigura este valor en el panel del nodo.text
Enviado elConfigura este valor en el panel del nodo.number
Mensaje de TelegramRespuesta Message completa de la API Bot de Telegram.json
Callback respondidoVerdadero cuando Telegram aceptó la respuesta al clic del botón.boolean
ID de consulta callback respondidaConfigura 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.