{
  "version": "0.2.0",
  "wit_version": "0.3.0",
  "description": "Read and send messages from a Telegram user account. Supports contacts, chat history, message search, sending, forwarding, and deletion via encrypted MTProto.",
  "http": {
    "allowlist": [
      {
        "host": "*.web.telegram.org",
        "path_prefix": "/apiw",
        "methods": ["POST"]
      }
    ],
    "rate_limit": {
      "requests_per_minute": 30,
      "requests_per_hour": 500
    },
    "timeout_secs": 60
  },
  "workspace": {
    "allowed_prefixes": ["telegram/"]
  },
  "secrets": {
    "allowed_names": ["telegram_api_id", "telegram_api_hash"]
  },
  "auth": {
    "secret_name": "telegram_api_id",
    "display_name": "Telegram",
    "instructions": "1. Go to https://my.telegram.org/apps and create an app\n2. Store your API ID and hash in the workspace:\n   - Write your numeric API ID to telegram/api_id\n   - Write your API hash string to telegram/api_hash\n3. Use the 'login' action with your phone number\n4. Use 'submit_auth_code' with the code you receive\n5. Use 'submit_2fa_password' if you have 2FA enabled\n6. Save the returned session JSON to telegram/session.json",
    "setup_url": "https://my.telegram.org/apps"
  },
  "setup": {
    "required_secrets": [
      {
        "name": "telegram_api_id",
        "prompt": "Telegram API ID (from my.telegram.org/apps)"
      },
      {
        "name": "telegram_api_hash",
        "prompt": "Telegram API Hash (from my.telegram.org/apps — alphanumeric string)"
      }
    ]
  }
}
