机器人使用指南

TG机器人是运营人员的好帮手

机器人创建指南

Telegram机器人的创建通过官方的 BotFather 实现。BotFather 本身也是一个机器人，内置了一系列指令，帮助我们快速创建和管理Telegram机器人。整个流程简单明了，只需按步骤操作即可。

1. 创建机器人并获取API Token

• 在Telegram中搜索 @BotFather，或者通过浏览器直接访问 https://t.me/BotFather，然后输入 /newbot 命令创建新机器人。

• 创建完成后，使用 /mybots 命令查看已创建的机器人列表，选择目标机器人，点击 API Token 获取账号和API Token。

• 重要：将获取到的机器人账号和API Token发送给开发人员，由他们将其配置到服务器。

2. 修改群组隐私设置 (Group Privacy)

• 输入 /mybots，选择刚刚创建的机器人。

• 进入 Bot Settings > Group Privacy，选择 Turn Off 将群组隐私关闭。 （关闭后，机器人可以在群组中读取消息并响应指令。）

3. 设置机器人命令提示

• 输入 /mybots，选择目标机器人。

• 点击 Edit Bot > Edit Commands，将以下命令复制粘贴并发送，完成命令设置：

query_balance - 查询余额
utr - UTR <UTR> : 查询UTR信息
upi - UPI <upi> : 查询UPI信息
bind - bind <orderNo> <UTR> : 将UTR绑定到订单号
order_no - <orderNo> : 查询订单信息
t - T : 查询今日汇总
p - p <orderNo> : 生成支付凭证
l - L <amount> : 生成一个指定金额的新订单

机器人使用指南

通过上述步骤，我们已成功创建机器人并由开发人员配置到后台，系统现已具备与Telegram机器人交互的能力。将机器人拉入群组后，只需在群内按照预设指令发送消息，即可获得机器人响应。

但此时，指令尚无法查询数据。要实现查询某个群绑定的商户信息，需通知开发人员或系统超级管理员，在后台将运营负责人的Telegram账号添加为 TG管理员。

1. 查询自己的TG_ID

• 与创建的机器人私聊，输入 query_id，机器人将返回你的Telegram ID。

• 示例对话：

我: query_id
机器人: fromId: 6280232324 chatId: 6280232324

• 私聊中，fromId 和 chatId 均为你的TG_ID。将此ID发送给开发人员，添加到后台机器人管理员列表。

注：机器人管理员可执行系统支持的所有指令。

2. 绑定商户到群组

成为机器人管理员后，可绑定商户至群组。绑定后，通过订单号查询时，系统会根据绑定的商户返回对应订单信息（不同商户的订单号相互隔离）。

• 在群内使用 bind_user 指令绑定商户与群组关系。 示例：假设商户名为“ABC”，箭头指向商户名位置（具体界面参考系统截图）。

• 注意：只有后台录入的TG管理员账号才能成功执行 bind_user 指令，否则会提示“无权限”或相关错误。

• 绑定成功后，可使用以下指令查询订单或余额：

query_balance - 查询余额
utr - UTR <UTR> : 查询UTR信息
upi - UPI <upi> : 查询UPI信息
bind - bind <orderNo> <UTR> : 将UTR绑定到订单号
order_no - <orderNo> : 查询订单信息
t - T : 查询今日汇总
p - p <orderNo> : 生成支付凭证
l - L <amount> : 生成一个指定金额的新订单

2.1 机器人命令使用说明

1.“带UTR的截图 + 代收订单号”，可以自助补单，并显示该收款账号是否为我方账号
2.“bind+订单号 + UTR数字”，可以手动补单，适用于自动识别错误的情况
3.“UTR + UTR数字”可以查询是否收这笔转账和绑定状态
4.“UPI+带收款账号的截图”、“UPI+收款账号”，可查询账号是否为我方账号。第二种方法适用于识别不准确的情况
5.“p+代付订单号”，可以获取代付凭证图片
6. /t 可获得商户统计数据
7./en 切换成英文，/中文 切换成中文

3. 绑定手机号到接码群

Telegram群组还可用于查询手机状态并获取实时短信OTP。操作步骤如下：

• 创建一个新群组，将机器人拉入其中。

• 使用绑定指令 /短信绑定 917777778888（手机号需与短信App上报至系统后台的号码一致，详情见《短信App使用指南》）。

• 注意：仅后台添加为 sms_admin_id 的账号才能执行此指令，否则提示“无权限”。若有多个短信管理员，ID间用逗号分隔。

• 绑定成功后，短信将自动转发至群组。

最终效果如系统截图所示。

问题排查

utr图片不识别，通常是机器人配置问题：设置Group Privacy 为 disabled

1. 输入/mybot，选择创建的机器人

2. Bot Settings➡️Group Privacy➡️Turn Off (找到 Group Privacy并关闭)

总结

通过以上步骤，我们完成了Telegram机器人的创建、配置及使用设置。机器人现可支持群内订单查询、余额检查、支付凭证生成等功能，并能实时转发短信OTP至指定群组。如有进一步问题，请联系开发人员或参考相关文档。