Saltar a contenido

Guía paso a paso

Este recorrido lleva una función pequeña desde una carpeta vacía hasta un botón funcional. Tarda pocos minutos y solo necesita su archivo de configuración.

1. Apunte la configuración a una carpeta

Añadir la carpeta a la configuración

config.yaml
function_directory: "./functions"

La ruta es relativa al archivo de configuración. Consulte Configuración → Reglas de function_directory.

2. Escriba el archivo de la función

Cree functions/greet.yaml. El parámetro se llama args para que un botón pueda completarlo:

Su primera función

functions/greet.yaml
name: greet
run: "echo Hello {{.args}}"
params:
  - name: args
    required: true
    description: Name to greet

3. Añada un botón que la use

Un botón para la función nueva

Botón Say hello
- name: Say hello
  type: button
  function: greet
  args: "world"

4. Valide y enumere las funciones

Comprobar la configuración y ver qué se cargó

Validar y después enumerar las funciones
./telegram-commander validate --config config.yaml
./telegram-commander list-functions --config config.yaml

Debería ver una línea greet. Cada línea muestra el nombre, la procedencia de la función y cuántos parámetros tiene. Consulte CLI → list-functions.

Si validate muestra una queja, el mensaje indica el botón y el valor que falta; consulte Reglas.

5. Ejecute el bot y toque el botón

Iniciar el bot en primer plano

Ejecutar y observar la salida
./telegram-commander run --config config.yaml

Envíe /start en Telegram, toque Say hello y el bot ejecutará echo Hello world y devolverá Hello world como bloque de código.

6. Hágala reutilizable

Cambie el valor args del botón o añada otro botón con un valor distinto. La función no cambia:

Dos botones, una función

Botones de saludo
- name: Greet world
  type: button
  function: greet
  args: "world"
- name: Greet team
  type: button
  function: greet
  args: "team"

Relacionado