ID

ID #

本文介绍搭建 SDGBOTS-ID 的注意事项,以及配置文件中各数值的意义。

请注意先参照「通用步骤」进行配置。


需要加入的群组 #

  • SDGBOTS-TEST
    • 可选
    • 应具有管理员权限

机器人性质 #

常规 Bot,需要在 BotFather 处获取 bot token


文件 config.ini #

这是一个自定义的文件。文件应位于 data/config/ 目录下,可参照 examples/config.ini 的格式进行设置。

需要对 config.ini 文件中内容为 [DATA EXPUNGED] 的全部键值进行修改。

api_idapi_hash 可在官网获取。

[pyrogram]
api_id = [DATA EXPUNGED]
api_hash = [DATA EXPUNGED]
; 以上两条信息从官网申请获得

[plugins]
root = plugins
include =
    handlers.command
    handlers.message

[proxy]
enabled = False
; 可根据需要自行决定是否使用 SOCKS5 代理
hostname = 127.0.0.1
port = 1080

[basic]
bot_token = [DATA EXPUNGED]
; 此处填写在 @BotFather 处获得的 token
prefix = /!
; 命令前的可用字符,如在群组中使用非常规命令前缀,需要机器人有获取普通消息的权限

[channels]
test_group_id = 0
; 此处填写测试群组 SDGBOTS-TEST 的 ID

[custom]
manual_link = https://manuals.sdgbots.com/bots/id/
; 此处填写使用手册的链接

[language]
lang = cmn-Hans
; 此处填写 languages 文件夹下所包含的 YAML 文件的对应名称

[mode]
aio = False
; 此处填写 True 或 False,代表程序是否与其他程序共用同一机器人帐号

文件 start.txt #

提示
如果程序在 All-In-One 模式 下工作,本程序将忽略 start.txt 中的内容,并不会对私聊的 /start 命令做出回应。

这是一个自定义的文件。文件应位于 data/config/ 目录下,可参照 examples/start.txt 的格式进行设置。

此文件将作为用户私聊发送 /start 命令给机器人时,机器人所发送的消息内容。

当设定消息内容的样式时(链接、加粗、斜体、代码块),请内容遵从 HTML 格式,请见:https://docs.pyrogram.org/topics/text-formatting#html-style

start.txt 文件支持设置消息按钮,添加按钮的方式为:

在文件尾部,使用一行 6 个 + 号作为分隔线,来区分正文与按钮部分。在分隔线后方,每行都将代表一个按钮配置,对于每个按钮配置,请使用双竖线 || 分隔按钮文字(前)和按钮链接(后),最多可设置共 6 个按钮。可参考示例部分。

此文件的内容可自由编写,但请注意保证文本不超过 4096 个字符。

以下是示例,仅供参考:

本机器人可协助您获取用户、群组、频道的 ID。

<code>------------------------</code>

<b>使用命令:</b>

<code>/id</code>
<i>在群组中发送此命令,将获得您的用户 ID,群组 ID</i>

<code>/id</code>
<i>在群组中以回复用户消息的形式发送此命令,将获得您的用户 ID,被回复的用户 ID,和群组 ID</i>

<code>/id</code>
<i>在本私聊对话中发送此命令,将获得您的用户 ID</i>

<code>/id username</code>
<code>/id @username</code>
<code>/id https://t.me/username</code>
<i>在本私聊对话中发送此命令,将获得 @username 的 ID</i>

<code>------------------------</code>

<b>转发消息:</b>

<code>转发频道消息到本对话中</code>
<i>将获得该频道的 ID</i>

<code>转发用户消息到本对话中</code>
<i>将获得该用户的 ID</i>

<code>------------------------</code>

<b>发送联系人卡片:</b>

<code>分享联系人卡片到本对话中</code>
<i>将获得该联系人的 ID</i>
<b>出于保护隐私的考虑,请谨慎使用此方式</b>

<code>------------------------</code>

<b>注 1:</b>当通过命令、转发消息来检查 ID 时,还将同时检查该对象是否收到 Telegram 限制,如果受限,将同时显示受限理由等信息。

<b>注 2:</b>如在群组中发送 <code>/id</code> 没有反应,请尝试将机器人设置为任意权限的管理员。

++++++

文档 || https://sdgbots.com/id/
源码 || https://github.com/sdgbots/sdgbots-id/
提交需求 || https://github.com/sdgbots/sdgbots-id/issues