@actionsflow/trigger-telegram_bot 中文文档教程

Question

@actionsflow/trigger-telegram_bot

这是 telegram bot 触发器 Actionsflow 。 telegram_bot 触发器在检测到电报机器人的新消息时触发。 此触发器支持指定一种消息类型或多种消息类型

这是官方触发器，您无需手动安装。

在Github上查看触发器

Usage

# single message type
on:
  telegram_bot:
    event: text
    token: ${{ secrets.TELEGRAM_BOT_TOKEN }}

# multiple message types
on:
  telegram_bot:
    event:
      - photo
      - text
    token: ${{ secrets.TELEGRAM_BOT_TOKEN }}

Options

• token，可选，如果webhook为false，则需要token。 Telegram 机器人令牌，您应该从 Telegram BotFather 获取它，例如：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

• < code>webhook，可选，boolean，如果使用telegram webhook 模式获取电报消息更新，默认值为false，触发器将轮询以获取电报更新。 ，如果 true，您必须通过电报的 setWebhook API，webhook URL 应该是 https://webhook.actionsflow.workers.dev////telegram_bot?__token=，了解更多关于webhook URL，见这里，这里是一个CURL例子设置 webhook：

  curl --request POST 'https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/setWebhook' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "url": "https://webhook.actionsflow.workers.dev/<owner>/<repo>/<workflow-file-name>/telegram_bot?__token=<your-github-personal-token>"
  }'

• event，可选，string 或 string[]，telegram 消息类型，允许的类型：

• text

• 动画

• 音频

• channel_chat_created

• 联系人

• delete_chat_photo

• 骰子

• 文档

• 游戏

• group_chat_created

• invoice

• left_chat_member

• location

• migrate_from_chat_id

• migrate_to_chat_id

• new_chat_members

• < code>new_chat_photo

• new_chat_title

• passport_data

• photo

• pinned_message

• 投票

• 贴纸

• successful_payment

• supergroup_chat_created

• video

• video_note

• voice

  if event 未提供，将触发所有消息。 示例：["text","photo"],text

您可以使用 Actionsflow 触发器的常规配置 以进行更多自定义。

Outputs

此触发器的输出将是电报消息的项目，您可以在此处查看

输出示例：

{
  "message_id": 7,
  "from": {
    "id": 1056059698,
    "is_bot": false,
    "first_name": "Owen",
    "last_name": "Young",
    "language_code": "en"
  },
  "chat": {
    "id": 1056059698,
    "first_name": "Owen",
    "last_name": "Young",
    "type": "private"
  },
  "date": 1598383043,
  "text": "test",
  "update_id": 791185172
}

您可以使用像这样的输出：

on:
  telegram_bot:
    token: ${{ secrets.TELEGRAM_BOT_TOKEN }}
jobs:
  print:
    name: Print
    runs-on: ubuntu-latest
    steps:
      - name: Print Outputs
        env:
          telegram_text: ${{ on.telegram_bot.outputs.text }}
        run: |
          echo telegram text: $telegram_text