canonical_id: "telegram"
display_name: "Telegram Bot"
category: "api"
version: "v1"
wasi_target: "preview1"
stability: "floating"
runtime_compat:
  - "cf-workers"
  - "workerd"
  - "wazero"
constraints:
  max_size_kb: 2048
  max_cold_start_ms: 50
  no_network_syscall: false
  no_filesystem_syscall: true
  io_model: "stdin_stdout_json"
input_schema:
  type: object
  required: [chat_id, text, bot_token]
  properties:
    chat_id:
      type: string
    text:
      type: string
    bot_token:
      type: string
      description: Telegram Bot Token
output_schema:
  type: object
  properties:
    success:
      type: boolean
    data:
      type: object
      properties:
        ok:
          type: boolean
gherkin_tests:
  - scenario: "缺少 bot_token"
    given: '{"chat_id":"123","text":"hello"}'
    then_contains: '{"success":false'
  - scenario: "缺少 chat_id"
    given: '{"text":"hello","bot_token":"token"}'
    then_contains: '{"success":false'
tags: [integration, telegram, bot, message]
description: "透過 Telegram Bot 發送訊息。透過 host function 呼叫 Telegram Bot API，需要 bot_token。"
credentials_required:
  - key: telegram_bot_token
    type: telegram_bot_token
    description: "Telegram Bot Token（由 @BotFather 取得）"
    inject_as: bot_token
config_example: |
  send_message:                  # 節點名稱（可自訂）
    chat_id: ""                  # Telegram Chat ID（必填）
    text: ""                     # 訊息內文（必填）
    # bot_token 由 credentials.yaml 的 telegram_bot_token 自動注入