Обращение к Telegram Bot API

В процессе создания нового рабочего процесса или изменения существующего в консоли управления в блоке Создание рабочего процесса / Изменение рабочего процесса выберите Конструктор.

Из секции Интеграционные шаги в левой части экрана перетащите элемент Telegram-бот в нужное место рабочего процесса в окне конструктора.

Перетаскивать шаги можно в обозначенные пунктирной линией блоки на графической схеме рабочего процесса, такие как Добавить шаг и т.п.

В окне со схемой рабочего процесса нажмите на добавленный блок Telegram-бот, чтобы выбрать его.

В правой части окна на вкладке Настройки:

1. В поле Имя шага задайте имя шага рабочего процесса.

2. В блоке Токен укажите токен бота или секрет Yandex Lockbox, в котором сохранен этот токен. Выберите:

   • Lockbox, чтобы хранить токен бота в секрете, и в блоке Cекрет выберите секрет, его версию и ключ, в которых сохранен токен бота.

     Если у вас еще нет секрета Yandex Lockbox, нажмите кнопку Создать, чтобы создать его.

   • Текст, чтобы хранить токен бота в спецификации в виде текста, и в поле Значение введите токен бота.

     Важно

     Хранить токен бота в открытом виде в тексте спецификации небезопасно.

3. В блоке Действие:

   1. В поле Идентификатор чата укажите идентификатор чата или имя канала в формате @channelusername.
   2. В поле Текст введите текст сообщения, который нужно отправить.
   3. (Опционально) В поле Ответить на сообщение укажите идентификатор сообщения, на которое нужно ответить.
   4. (Опционально) В поле Режим форматирования выберите режим форматирования сообщения. Подробнее см. документацию Telegram Bot API.

4. (Опционально) В поле Таймаут, мс задайте максимальное время выполнения текущего шага.

5. (Опционально) Чтобы задать для шага собственную политику повторных попыток, разверните блок Политика повторных попыток и нажмите кнопку Политика повторных попыток. В появившейся форме:

   1. (Опционально) В поле Начальная задержка, мс задайте начальное значение задержки между повторными попытками выполнения шага.

   2. (Опционально) В поле Скорость изменения задержки задайте коэффициент, на который будет умножаться время задержки перед каждой повторной попыткой выполнения шага.

   3. (Опционально) В поле Максимальная задержка, мс задайте значение максимальной задержки между повторными попытками выполнения шага.

   4. В поле Ошибки выберите ошибки, для которых будут (или, наоборот, не будут) сделаны повторные попытки выполнения шага.

      Подробную информацию о возможных ошибках см. в разделе Возможные коды ошибок.

   5. (Опционально) В поле Количество повторных попыток задайте максимальное количество повторных попыток выполнения шага.

   6. В поле Режим выбора ошибок выберите:

      • INCLUDE — чтобы делать для шага повторные попытки выполнения при возникновении ошибок, указанных в поле Ошибки.
      • EXCLUDE — чтобы делать для шага повторные попытки выполнения при возникновении любых ошибок, за исключением ошибок, указанных в поле Ошибки.

   Если вы хотите удалить политику повторных попыток, ранее созданную для шага, в строке Политика повторных попыток нажмите и выберите Удалить.

   Если для шага не настроена собственная политика повторных попыток, к нему будет применяться политика повторных попыток, заданная для всего рабочего процесса.

(Опционально) Перейдите на вкладку Вход и задайте jq-шаблон для фильтрации состояния рабочего процесса, которое передается в шаг.

(Опционально) Перейдите на вкладку Выход и задайте jq-шаблон для фильтрации выходных данных шага, которые добавляются в состояние рабочего процесса.

(Опционально) Добавьте для создаваемого шага правило перехода по ошибкам, которые могут возникать во время выполнения этого шага.