A 7de1766941 feat: sync ephemeral bot demo commands

Sync telesrv 172a86e (feat(bot-demo): echo ephemeral group commands).

Skipped telesrv docs changes per public sync rules.

2026-07-20 16:44:09 +08:00

2.7 KiB

Raw Blame History

python-telegram-bot echo demo

This demo uses the normal python-telegram-bot API and only swaps the Bot API base URLs to telesrv.

python -m pip install python-telegram-bot
$env:TELESRV_BOT_TOKEN = "<bot_id>:<secret>"
python .\cmd\bots\ptbecho\echo.py `
  --base-url http://127.0.0.1:8081/bot `
  --base-file-url http://127.0.0.1:8081/file/bot

In a group with BotFather privacy enabled, send a command such as:

/ping hello from group

Ephemeral echo（Bot API 10.2）

先通过 setMyCommands 把 private 注册为 is_ephemeral=true，然后保持本示例轮询。在 TDesktop Layer 228 的群组里发送：

/private@你的Bot用户名

本示例从 PTB 的 Message.api_kwargs 读取 ephemeral_message_id，并在 15 秒 action 窗口内用 receiver_user_id 与 reply_parameters.ephemeral_message_id 回复 ephemeral echo: ...。请求失败时不会降级成普通群消息。Alice 应看到两条带可见性提示的消息：自己发出的命令显示“Only visible to @Bot”，bot 回复显示 “Only visible to you”；Bob 不应看到其中任何一条。

主动发送一条消息并退出：

python .\cmd\bots\ptbecho\echo.py `
  --send-only `
  --send-chat-id -1000000000002 `
  --send-text "hello from python-telegram-bot"

长轮询 echo 启动后立即主动发送一条消息：

python .\cmd\bots\ptbecho\echo.py `
  --send-chat-id -1000000000002 `
  --send-text "ptbecho is online"

发送 reply keyboard 与 inline callback 两条验证消息并保持 polling：

python .\cmd\bots\ptbecho\echo.py `
  --buttons-chat-id 1780243200

reply keyboard 与 inline keyboard 都会各显示蓝/绿/红三种语义色；点击 reply button 会按普通文本消息进入 echo 链，点击 inline button 会由 callback_query handler 调用 answerCallbackQuery 并显示 telesrv inline callback OK。也可以在私聊中发送 /buttons 生成同样的两条消息。

可选参数：

--send-count N：连续主动发送 N 条。
--send-interval SEC：连续发送之间的间隔。
TELESRV_BOT_DEMO_CHAT_ID / TELESRV_BOT_DEMO_SEND_TEXT：主动发送参数的环境变量形式。
--buttons-chat-id / TELESRV_BOT_DEMO_BUTTONS_CHAT_ID：发送两类键盘验证消息并监听 callback。

本地超级群 chat id 使用 Bot API 形式 -100<channel_id>；例如 channel id 为 2 时是 -1000000000002。

Implemented telesrv Bot API surface for this demo: getMe, getUpdates, deleteWebhook, sendMessage, and file URL configuration. The wider gateway also has basic sendPhoto, sendDocument, editMessageText, deleteMessage, answerCallbackQuery, getFile, and /file/bot... support.

2.7 KiB Raw Blame History Unescape Escape

python-telegram-bot echo demo

Ephemeral echo（Bot API 10.2）

2.7 KiB

Raw Blame History