# 添加卡片筛选状态

如果业务方有将消息卡片进行分类的需求，可以将消息卡片携带筛选项，以方便用户快速筛选当前应用中不同类型的消息卡片。

![卡片筛选状态](https://cloudcdn.qwps.cn/open/_img/024746e811.png)


## 实现方式

1. 在【开发者后台-应用能力-WPS协作机器人-发送消息-api发送-配置卡片筛选项】配置筛选项，`filter_key`值与筛选项名称相对应。

![设置卡片筛选状态](https://cloudcdn.qwps.cn/open/_img/3732cd4003.png)

2. 业务方在发送卡片消息时配置 config 字段中的 filter_key 字段，filter_key 需与第1步设置的值一致。卡片发出后，在应用消息列表右上角会增加筛选标识，点击对应的筛选项即可筛选该项下的消息卡片。

```json
{
    "config": {
        "filter_key": "key1"
    },
    "link": {
      ...
    },
    "i18n_items": {
      ...
    }
}
```

3.应用可更新卡片中的`filter_key`字段值。当应用消息流中没有带筛选分类的消息时，消息窗口右上角的筛选标识将消失。

> 注意：筛选项可进行多次修改，即一个卡片可以多次修改卡片筛选状态，但无法从配置筛选项的卡片更新成没有配置筛选项的卡片。