# 机器人使用指南

### 机器人创建指南

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` 将群组隐私关闭。\
  （关闭后，机器人可以在群组中读取消息并响应指令。） 

<figure><img src="/files/2ouQzjU8XpW87cohu2KT" alt=""><figcaption></figcaption></figure>

#### 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> : 生成一个指定金额的新订单
```

<figure><img src="/files/yfXazxnvAj8YkS5RFBNf" alt=""><figcaption></figcaption></figure>

### 机器人使用指南

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

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

#### 1. 查询自己的TG\_ID

* 与创建的机器人私聊，输入 `query_id`，机器人将返回你的Telegram ID。
* 示例对话：

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

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

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

<figure><img src="/files/hsIBm0AhYNYZHb9E4mjB" alt=""><figcaption></figcaption></figure>

#### 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 切换成英文，/中文 切换成中文
```

<figure><img src="/files/dl7XOIl9Hd57GPdEOu7i" alt=""><figcaption></figcaption></figure>

#### 3. 绑定手机号到接码群

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

* 创建一个新群组，将机器人拉入其中。
* 使用绑定指令 `/短信绑定 917777778888`（手机号需与短信App上报至系统后台的号码一致，详情见《短信App使用指南》）。
* **注意**：仅后台添加为 **sms\_admin\_id** 的账号才能执行此指令，否则提示“无权限”。若有多个短信管理员，ID间用逗号分隔。
* 绑定成功后，短信将自动转发至群组。

<figure><img src="/files/McpoQgbbGxN8VxepvheS" alt=""><figcaption></figcaption></figure>

最终效果如系统截图所示。&#x20;

<figure><img src="/files/anEYNSl9s5gF2deBjQsZ" alt=""><figcaption></figcaption></figure>

### 问题排查

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

1. 输入/mybot，选择创建的机器人&#x20;
2. Bot Settings➡️Group Privacy➡️Turn Off (找到 Group Privacy并关闭)

<figure><img src="/files/YGr57JQbDMYISDPWWfFO" alt=""><figcaption></figcaption></figure>

### 总结

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bigdipper.gitbook.io/indiapay/tg-ji-qi-ren/ji-qi-ren-shi-yong-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.