Schritt-für-Schritt-Anleitung¶

Diese Anleitung führt Sie von einem leeren Ordner zu einer kleinen, funktionierenden Schaltfläche. Sie dauert nur wenige Minuten und benötigt lediglich Ihre Konfigurationsdatei.

1. Einen Ordner in der Konfiguration angeben¶

Den Ordner zur Konfiguration hinzufügen

config.yaml

function_directory: "./functions"

Der Pfad ist relativ zur Konfigurationsdatei. Siehe Konfiguration → Regeln für function_directory.

2. Die Funktionsdatei schreiben¶

Erstellen Sie functions/greet.yaml. Der Parameter heißt args, damit eine Schaltfläche ihn ausfüllen kann:

Ihre erste Funktion

functions/greet.yaml

name: greet
run: "echo Hello {{.args}}"
params:
  - name: args
    required: true
    description: Zu begrüßender Name

3. Eine Schaltfläche für die Funktion hinzufügen¶

Eine Schaltfläche für die neue Funktion

Schaltfläche zum Begrüßen

- name: Hallo sagen
  type: button
  function: greet
  args: "world"

4. Validieren und Funktionen auflisten¶

Die Konfiguration prüfen und anschließend die geladenen Funktionen anzeigen

Validieren und anschließend die Funktionen auflisten

./telegram-commander validate --config config.yaml
./telegram-commander list-functions --config config.yaml

Es sollte eine Zeile für greet erscheinen. Jede Zeile zeigt den Namen, die Herkunft der Funktion und die Anzahl ihrer Parameter. Siehe CLI → list-functions.

Wenn validate einen Fehler meldet, nennt die Meldung die Schaltfläche und den fehlenden Wert — prüfen Sie die Regeln.

5. Den Bot starten und die Schaltfläche antippen¶

Den Bot im Vordergrund starten

Starten und die Ausgabe beobachten

./telegram-commander run --config config.yaml

Senden Sie /start in Telegram und tippen Sie Hallo sagen an. Der Bot führt echo Hello world aus und sendet Hello world als Codeblock zurück.

6. Wiederverwendbar machen¶

Ändern Sie den args-Wert der Schaltfläche oder fügen Sie eine zweite Schaltfläche mit einem anderen Wert hinzu. Die Funktion bleibt unverändert:

Zwei Schaltflächen, eine Funktion

Begrüßungsschaltflächen

- name: Welt begrüßen
  type: button
  function: greet
  args: "world"
- name: Team begrüßen
  type: button
  function: greet
  args: "team"