分步指南¶

本页会从空文件夹开始，逐步创建一个小函数和可用按钮。整个过程只需几分钟，除配置文件外无需其他准备。

1. 将配置指向文件夹¶

将文件夹添加到您的配置

config.yaml

function_directory: "./functions"

该路径是相对于配置文件的。参见配置→function_directory规则。

创建 functions/greet.yaml。该参数名为 args，因此按钮可以填写：

您的第一个函数

functions/greet.yaml

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

新函数的按钮

Say hello button

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

检查配置，然后看看加载了什么

Validate, then list the functions

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

您应该看到 greet 行。每行显示名称、函数所在位置来自，以及它有多少个参数。参见 CLI → 列表函数。

如果 validate 报错，消息会指出相关按钮和缺少的值，详见规则。

在前台启动机器人

Run and watch the output

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

在 Telegram 中发送 /start，点击 Say hello，机器人就会运行 echo Hello world 并将 Hello world 作为代码块发送回来。

更改按钮的 args 值，或添加另一个不同的按钮。函数保持不变：

两个按钮，一个函数

Greeting buttons

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