---
title: 飞书推送设置
---

# 飞书推送设置

通过飞书群机器人，您可以将机器人筛选出的高意向客户实时推送至指定飞书群，方便销售或运营团队及时跟进。

完成配置后，当通话命中您选择的推送标签时，avavox会自动向飞书群发送一条线索消息。

## 使用前确认
+ 请使用一个仅包含相关业务成员的飞书群接收线索消息。
+ 飞书推送消息可能包含客户手机号、姓名、地址、通话摘要、自定义变量和录音链接。请勿将机器人添加到包含无关成员或外部人员的群。
+ 当前飞书推送使用群机器人的webhook地址和签名密钥进行配置。

## 获取飞书webhook地址
### 1. 创建或选择接收消息的飞书群
在飞书中创建一个用于接收 avavox 高意向客户通知的群，或打开已有的业务群。

### 2. 添加自定义机器人
在群聊中打开群设置，进入 **群机器人**，点击 **添加机器人**，选择 **自定义机器人**。

### 3. 配置机器人安全设置并获取签名密钥
为机器人填写名称后，在安全设置中选择 **签名校验**。飞书会生成一段签名密钥，请完整复制并妥善保存。

稍后需要将该签名密钥粘贴到 avavox 推送设置中的 **加密密钥** 输入框。

::: tip 注意事项
请使用"签名校验"，不要仅配置关键词校验，也不要选择 IP 白名单。avavox 会使用您填写的签名密钥对请求进行签名；IP 白名单无法匹配时，测试消息和正式推送可能失败。
:::

### 4. 复制 Webhook 地址
完成机器人创建后，复制飞书提供的 Webhook 地址。请妥善保管该地址，不要发送到无关群聊或公开渠道。

## 配置 avavox 推送
1. 打开 avavox，进入需要配置的机器人。
2. 点击 **推送设置**，开启 **高意向线索实时推送**。
3. 在推送渠道中选择 **飞书**。
4. 粘贴从飞书群机器人复制的 Webhook 地址。
5. 在 **加密密钥** 中粘贴飞书机器人生成的签名密钥。
6. 选择需要触发推送的标签。
7. 点击 **发送测试消息**，确认飞书群能够收到消息。
8. 点击 **保存配置**。机器人配置调整后，请重新发布机器人使配置生效。

::: tip 注意事项
只有命中已选择标签的通话，才会触发正式推送。测试消息用于验证 Webhook 是否可用，不代表已开启正式推送。
:::

## 飞书消息包含哪些内容
推送成功后，飞书群会收到一条"高意向客户来啦"消息。消息通常包含以下信息：

| 区域 | 说明 |
| --- | --- |
| 通话基本信息 | 机器人名称、客户号码、所属任务、SessionId、通话发生时间和通话时长。 |
| 命中标签 | 本次通话命中的普通标签。 |
| 命中提示标签 | 通过提示词或标签测评提取出的字段和值，例如姓名、意向、地区等。 |
| 自定义变量 | 任务或机器人中配置、且在本次通话中有值的自定义变量。 |
| 对话摘要 | 对本次客户沟通内容的概括，便于快速判断跟进优先级。 |
| 通话录音 | 录音播放链接。拥有链接访问权限的成员可打开查看。 |

实际展示内容取决于机器人配置和本次通话结果。未命中标签、没有值的变量或没有生成摘要时，对应内容可能不会展示。

## 常见问题
### Q：点击"发送测试消息"失败怎么办？
请按以下顺序检查：

1. 确认 Webhook 地址复制完整，以 `https://` 开头，且没有多余空格或换行。
2. 确认 Webhook 对应的自定义机器人仍在当前飞书群中，且未被停用或删除。
3. 确认飞书机器人安全设置已启用"签名校验"。
4. 确认 avavox 中填写的是飞书机器人当前生成的完整签名密钥，且没有复制到多余空格或换行。
5. 不要在飞书机器人中使用 IP 白名单。当前推送通过签名密钥完成请求校验，IP 白名单无法匹配时会导致发送失败。
6. 保存配置后再次发送测试消息；如仍失败，请重新创建飞书群机器人，并同步替换 Webhook 地址和签名密钥。

### Q：测试消息能收到，为什么正式通话后没有推送？
请检查：

1. 是否已开启"高意向线索实时推送"。
2. 本次通话是否实际命中了已选择的推送标签。
3. 是否已保存配置并重新发布机器人。
4. 飞书群机器人是否仍在群内，Webhook 是否被重新生成或失效。

### Q：为什么群里没有消息提醒？
请检查飞书群是否开启了"消息免打扰"。建议负责跟进的成员将该群或机器人消息设为特别关注，避免错过高意向线索。

### Q：为什么消息中包含客户手机号、地址或录音链接？
飞书推送用于帮助团队快速跟进线索，因此会展示通话中已采集的客户信息、标签结果和录音链接。请仅将机器人配置在授权业务人员所在的群中，并按照公司数据安全规范管理群成员和消息内容。