YOUR BOTS, CONNECTED
让每一条消息,顺利抵达。
连接 Telegram,集中管理你的机器人服务。
从 Telegram 开始
你已在 Telegram,
你已在 Telegram,
登录也可以很简单。
扫码确认,或直接打开机器人。
密钥、后端与运行情况,都在这里。
运行概览
最近 7 天 · 你的机器人服务 · UTC
请求趋势
每日请求查看每日明细
| 日期(UTC) | 请求 | 成功 | 失败 |
|---|
接入,只需三步
-
1
创建专属密钥
为每个机器人区分接入入口。
-
2
添加后端域名
标记区域,连接实际业务服务。
-
3
设置 Webhook
保留业务回调路径,开始接收消息。
密钥与后端 0 / 2
密钥控制访问,后端决定消息送达的位置。
把你的机器人连接起来
已有业务服务器?保留原来的处理逻辑即可。
创建并保管密钥
登录后,在“密钥与后端”创建一个有辨识度的名称。最多保留 2 个未吊销的密钥,暂停也会占用名额。
填写后端域名
填写业务服务器的公网域名,例如 bot.example.com。每个密钥最多绑定 2 个域名,区域标签可使用 hk、sg、us。
设置业务 Webhook
复制密钥的接入前缀,并补上原来的回调路径。使用业务 Bot 的 setWebhook 设置这个完整地址。
/v1/你的密钥/原回调路径?connect=hk
转发与故障处理
仅接收 JSON POST 请求,最大 5 MB。按区域选取可用后端,同区域随机分配。连续 3 次连接或服务端故障后,暂停选择该后端 60 秒。
单次请求不会自动换后端重发,以避免业务被重复执行。后端错误状态会返回 Telegram,由 Telegram 重试。
在 Telegram 内使用
机器人中的“打开控制台”会以小程序方式打开并识别你的账户。普通聊天链接打开的网页仍需扫码或验证码登录。
密钥的生命周期
暂停可以恢复,适合临时停止转发。吊销后不可恢复,并会移除后端绑定;账户、历史统计和其他密钥不会受影响。