Fanbook BOT 是什么 第三方应用程序扩展社区能力
BOT 是什么
Fanbook 官方描述：机器人是运行在 Fanbook 内部的第三方应用程序，用户可以通过发送消息、命令和内联请求与机器人互动，也可以使用 HTTPS 向其 Bot API 发送请求来控制机器人。
简单说，BOT 就是一个可编程的自动账号——它有独立的头像和昵称，能发消息、接收消息、执行指令，但它的行为由你写的代码控制，不需要一个真人在手机前操作。
BOT 能做什么
消息交互
- 回复消息（自动响应关键词、命令）
- 发送定时消息（每日签到提醒、每周活动预告）
- 群发通知（通过 Bot API 批量发送到多个频道）
频道与成员管理
- 自动欢迎新成员（发送欢迎消息 + 社区规则）
- 自动踢出违规成员（结合敏感词检测）
- 角色自动分配（根据活动参与情况授予 VIP）
积分与游戏化
- 签到（每天签到获得积分 / 乐豆）
- 积分兑换（积分换虚拟道具或实体奖品）
- 排行榜（活跃度排行、贡献榜）
- 小游戏（成语接龙、俄罗斯方块等内置 BOT）
数据收集
- 监听成员发言记录，做社区活跃度统计
- 汇总讨论热点，给运营者做每日简报
- 自动整理 FAQ（高频问题自动标记并生成答案草稿）
系统集成
- 连接外部 CRM、电商、课程平台
- 把 Fanbook 社区与品牌的其他系统打通
两种 BOT 类型
内置 BOT
Fanbook 系统自带的 BOT，通常包含常见的签到、积分、小游戏等功能，开箱即用、无需开发。管理员只需把内置 BOT 加到频道里就能用。
自定义 BOT
运营者或第三方开发者通过 Bot API 创建的 BOT，功能完全由开发者定义。需要：
- 在 Fanbook 开发者平台创建应用
- 获取 Bot Token（授权令牌）
- 用你熟悉的语言（Python、Node.js、Go 等）写调用 Bot API 的代码
- 部署到服务器上运行
与机器人的交互方式
方式一：@机器人命令
在文本频道输入框中输入 @机器人名称，会弹出该机器人的命令列表，选择或直接输入命令参数。例如：
@签到BOT 签到@积分BOT 我的积分@管理BOT 排行榜
方式二：快捷命令
管理员可以在频道中配置常驻快捷命令，显示在聊天输入框上方，成员一键点击就能执行。适合高频常用的命令。
方式三：消息触发
BOT 可以监听所有消息（在隐私模式关闭时），根据消息内容自动响应。例如：
- 有人发了
#帮助自动弹出帮助菜单 - 有人发敏感词自动提醒
方式四：内联键盘
部分命令执行后会返回一个交互卡片，卡片上有按钮可以点击进一步操作。例如：
- 签到 BOT 返回「签到成功，今日获得 10 积分」+ 查看积分排行榜按钮
Bot API 概览
Fanbook 开放了 HTTPS Bot API，主要端点包括：
| 端点模式 | 说明 | 示例 |
|---|---|---|
/getMe | 获取 BOT 自身信息 | 返回 BOT ID、用户名、头像 |
/sendMessage | 发送消息到频道或私聊 | 支持文本、图片、内联键盘 |
/channel/list | 获取服务器的频道列表 | 返回 Channel 数组 |
/invite/guildList | 获取邀请码列表 | 返回各频道的邀请码 |
/searchGuildMemberByName | 按名称搜索成员 | 模糊匹配 |
API 基础地址： https://a1.fanbook.cn/api/bot/{bot token}/{api}
更多端点和详细参数见开发者平台文档（Bot API 方法）。
生态现状
Fanbook 的 BOT 生态还在发展中。相比 Discord 数以万计的 BOT，Fanbook 的第三方 BOT 数量有限，但内置 BOT 已经覆盖了社区运营的核心需求（签到、积分、小游戏、欢迎、敏感词等）。
对于运营者来说，先用内置 BOT 跑通流程，不够再开发自定义 BOT 是最务实的路径。