## 通知滤盒 FilterBox Webhook 功能指南

通知滤盒从 2.0.0 版开始新增 Webhook 功能，可以创建规则，将您需要的通知内容发送到指定的 URL。

注意：通知内容可能包含隐私信息，请务必选择您信赖的服务端。

### 自定义内容

- Request method: 目前支持 `GET` 和 `POST`
- 可以自定义 URL、body、和 header。
自定义 URL 和 body 中支持使用通知的各项属性字段，完整支持字段请点开通知列表中最近的 20 条通知，并选择「调试信息」以查看。

以下为部分常用字段：

- `{android.title}` 通知标题
- `{android.text}` 通知内容
- `{filterbox.field.APP_NAME}` App 名称
- `{filterbox.field.PACKAGE_NAME}` App 包名
- `{filterbox.field.WHEN}` 通知的发送时间

URL 语法举例：
```
https://example.com/notification?title={android.title}&message={android.text}&app={filterbox.field.APP_NAME}
```
body 语法举例：
```
{
	"title": "{android.title}",
	"text": "{android.text}",
	"app": "{filterbox.field.PACKAGE_NAME}",
	"some_other_field": "some other field here"
}
```
当 body 格式为 JSON 时，header 建议填写为 `Content-Type: application/json`

如有疑问或更多功能需求，欢迎使用 App 内反馈功能邮件联系作者。


### 用法举例：转发备用机短信验证码到各类聊天软件

#### 到微信（使用 Server 酱）

1. 在 Server 酱官网注册并配置 https://sct.ftqq.com/
2. 在通知滤盒中开启并创建 Webhook 规则，方法为 `GET`，URL 为 
```
https://sctapi.ftqq.com/#Server酱SendKey#.send?title={android.title}&desp={android.message}
```

#### 到 telegram

1. 确保您的设备可以顺利访问 telegram
2. 在 https://t.me/botfather 中输入指令 `/newbot` 并跟随提示创建机器人，获得 token
3. 从 https://t.me/userinfobot 获取你的 ID
4. 在通知滤盒中开启并创建 Webhook 规则，方法为 `GET`，URL 为 
```
https://api.telegram.org/bot#机器人token#/sendmessage?text={android.title}%0A{android.text}&chat_id=#你的ID#
```