# python-telegram-bot echo demo

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

```powershell
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:

```text
/ping hello from group
```

## Ephemeral echo（Bot API 10.2）

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

```text
/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 不应看到其中任何一条。

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

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

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

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

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

```powershell
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.