IndiaPay
  • 一篇文章带你了解印度支付
  • 系统介绍
    • 印度支付系统概要文档
  • 后台使用
    • 后台系统使用指南
  • 商户对接
    • XXXXPAY代收付文档
    • API 文档
  • TG机器人
    • 机器人使用指南
  • 短信App
    • OKSMS使用指南
  • 新银行开发
  • 脚本使用
    • 手机端脚本回调使用指南
    • 网页端脚本使用手册
    • 流水补单指南
  • 脚本机刷机
    • 在 Mi 8 上刷入OkDroid系统
    • 小米手机 BL 解锁操作指南
    • 一加手机BL解锁指南
    • 在 OnePlus 8 上刷入OkDroid系统
Powered by GitBook
On this page
  • 机器人创建指南
  • 机器人使用指南
  • 问题排查
  • 总结
  1. TG机器人

机器人使用指南

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

PreviousTG机器人Next短信App

Last updated 2 months ago

机器人创建指南

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至指定群组。如有进一步问题,请联系开发人员或参考相关文档。