Пошаговое руководство¶

Это проходит через одну небольшую функцию от пустой папки до работающей кнопки. Это займет несколько минут и не требует ничего, кроме вашего файла конфигурации.

1. Укажите конфиг в папке¶

Добавьте папку в свою конфигурацию

config.yaml

function_directory: "./functions"

Путь указан относительно файла конфигурации. См. Конфигурация → function_directory правила .

2. Напишите файл функции¶

Создайте functions/greet.yaml. Параметр называется args, поэтому кнопка может заполните его:

Ваша первая функция

functions/greet.yaml

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

3. Добавьте кнопку, которая его использует¶

Кнопка для новой функции

Say hello button

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

4. Проверьте и перечислите функции¶

Проверьте конфигурацию, затем посмотрите, что загружено

Validate, then list the functions

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

Вы должны увидеть строку greet. В каждой строке указано название, откуда пришла функция и сколько у него параметров. См. CLI → список функций.

Если validate жалуется, в сообщении указывается кнопка и значение, которое отсутствует — проверьте Правила.

5. Запустите бота и нажмите кнопку¶

Запустить бота на переднем плане

Run and watch the output

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

Отправьте /start в Telegram, нажмите Поздороваться, и бот запустит echo Hello world. и отправляет Hello world обратно как блок кода.

6. Сделайте его многоразовым¶

Измените значение кнопки args или добавьте вторую кнопку с другим значением. Функция остается прежней:

Две кнопки, одна функция

Greeting buttons

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