Wiki: Взаимодействие с ботом

При получении сообщения бот воспринимает принятую строку, как состоящую из нескольких частей:

Способы передачи команд боту

Общий чат

Для этого в начало сообщения добавляется строка «!az » (командный префикс) (обратите внимание, что все символы пишутся слитно и без пробелов, но в конце следует пробел) и далее пишется команда с аргументами, например: !az stream 2.

Приватное сообщение

На Твиче это делается в специальном окне, либо в общем чате, через команду «/w AlpheratzBot». В данном случае формат немного меняется.

Пример: /w AlpheratzBot #channel stream 2, второй раз: /w AlpheratzBot stream 3. В открытом окне приватного диалога писать /w AlpheratzBot не нужно, т.е. вызов сокращается до #channel stream 2 и второй раз: stream 3.

Сообщение в канал бота в телеграме

О том как это настраивается смотрите в соответствующем модуле.

В данном случае использовать командный префикс не обязательно, формат: «команда + аргументы», пример: «stream 3».

Множественные команды

В одном запросе можно передать несколько команд в следующем формате (правила для передачи через общий чат):

Пример: !az say Hello! ;; say Goodbye.

Экранирование («эскейпинг»)

Если вам нужно передать команду с аргументами как аргумент для другой команды либо вам нужно передать множественную команду как аргумент другой команды, при этом чтобы это не было воспринято ботом как передача одной команды + непосредственное выполнение другой применяется экранирование. Экранируются нужные символы с помощью добавления к ним спереди символа «\». Например, это нужно, чтобы передать команду в модуль aliases. Мы будем присваивать алиас для двойной команды «say Hello!» и «say Goodbye.», делается это следующим образом: !az alias !hibye | say Hello! \;; say Goodbye..