{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"telegram/bot","name":"Telegram Bot (Bot API)","vendor":"Telegram","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create a bot with @BotFather to get a bot token for the Telegram Bot API, then optionally set a webhook with a secret token.","account_model":{"summary":"A Telegram user account talks to @BotFather, which creates bots owned by that account; each bot has its own token.","accounts":[{"name":"Telegram user account","kind":"personal","owned_by":"the person","required":true,"note":"Needed to message @BotFather."},{"name":"Bot","kind":"developer","owned_by":"the person","parent":"Telegram user account","required":true,"note":"The username cannot be changed after creation."}]},"prerequisites":[{"need":"A Telegram account signed in on a Telegram app","note":"You create the bot by chatting with @BotFather. Phone-number requirements for Telegram accounts are not covered in the bot docs reviewed. [to verify]"},{"need":"A privacy policy for the bot","note":"The Bot Platform Developer Terms require an easily accessible privacy policy; Telegram's Standard Policy may be used if you have none."}],"identity_requires":[],"have_ready":[{"kind":"app_privacy_policy_url","description":"A privacy policy URL for the bot, or acceptance of Telegram's Standard Policy","why":"The Bot Platform Developer Terms require bots to have a privacy policy easily accessible to users.","needed_for":["accept-terms"],"auto_check":"website_live","source_url":"https://telegram.org/tos/bot-developers"},{"kind":"live_website","description":"An HTTPS endpoint on port 443, 80, 88 or 8443 if you use a webhook","why":"Webhooks can only be delivered to those ports; otherwise use getUpdates long polling.","needed_for":["set-webhook"],"auto_check":"website_live","source_url":"https://core.telegram.org/bots/api"}],"steps":[{"id":"accept-terms","title":"Review the Bot Platform Developer Terms","summary":"Read the Telegram Bot Platform Developer Terms, which apply on top of the Telegram Terms of Service and Privacy Policy, including the privacy policy requirement and the Stars-only rule for digital goods.","route":"guided","gate":"human_terms","human_only":true,"gate_label":"You accept the terms","depends_on":[],"optional":false,"url":"https://telegram.org/tos/bot-developers","lead_time":null,"preflight":[],"captures":null},{"id":"create-bot","title":"Create the bot with @BotFather","summary":"In Telegram, open @BotFather and send /newbot. Give a display name and a username of 5-32 characters (Latin letters, digits, underscores) ending in \"bot\"; the username cannot be changed later. BotFather replies with the bot token; verapli writes it to your env file.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["accept-terms"],"optional":false,"url":"https://t.me/botfather","lead_time":null,"preflight":[],"captures":"TELEGRAM_BOT_TOKEN"},{"id":"set-webhook","title":"Set a webhook with a secret token (optional)","summary":"Call setWebhook with your HTTPS URL (port 443, 80, 88 or 8443) and a secret_token of 1-256 characters (A-Z, a-z, 0-9, _ and -). Telegram sends it in the X-Telegram-Bot-Api-Secret-Token header so you can verify requests. While a webhook is set, getUpdates long polling does not work.","route":"api","gate":"none","human_only":false,"gate_label":null,"depends_on":["create-bot"],"optional":true,"url":null,"lead_time":null,"preflight":[],"captures":"TELEGRAM_WEBHOOK_SECRET"}],"gates":[{"step":"accept-terms","gate":"human_terms","label":"You accept the terms"},{"step":"create-bot","gate":"human_submit","label":"You press submit"}],"lead_times":[],"outputs":[{"name":"TELEGRAM_BOT_TOKEN","description":"Bot API token from @BotFather, used in https://api.telegram.org/bot<token>/METHOD","secret":true,"example_format":"123456789:AA… (numeric id, colon, alphanumeric string)","environments":["development","production"]},{"name":"TELEGRAM_WEBHOOK_SECRET","description":"Secret you choose and pass as secret_token to setWebhook; compare it with the X-Telegram-Bot-Api-Secret-Token header","secret":true,"example_format":"1-256 chars of A-Z a-z 0-9 _ - (you choose it)…","environments":["production"]}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/telegram/bot"}