# 媒体库

媒体库允许您的 AI 机器人**在对话期间向联系人发送图片、视频、GIF、语音留言和 PDF 文档**。您只需上传一次文件，并告知机器人何时发送，机器人就会在合适的时机选择合适的文件——例如，当有人问“我能看看吗？”时发送产品照片，当有人索要完整价目表时发送 PDF 手册，或者发送一段简短的语音留言来引导客户浏览您的菜单。

**您可以将其视为机器人随时可发送的文件架。** 您决定架子上放什么，以及何时使用其中的每一项。


> 默认情况下，每个账户都提供媒体库。

---

## 为什么要使用媒体库

纯文本回答的作用有限。一张照片、一段短视频或一条语音备忘录通常比一段文字能更快、更有说服力地回答问题。

**媒体库能让您的机器人实现什么：**

- 当联系人要求查看某物时，发送**产品照片**
- 以图片形式分享**菜单、价目表或产品快照**
- 发送**简短的演示或操作视频**
- 在符合对话语境时，回复一个 **GIF**
- 发送**语音留言或音频片段**，增添个性化的人文关怀
- 发送 **PDF 文档**——如手册、价目表、目录或条款文档

机器人只会发送**您**上传并批准的文件——它绝不会从互联网上抓取图片或凭空捏造。

---

## 在哪里可以找到它

在主侧边栏的 **AI Studio** 下，点击 **Media Library**（媒体库）。此页面以**账户全局视图**显示机器人可以发送的所有文件，并进行了分组，因此在多处使用的文件将显示为一张卡片。每个项目都属于一个或多个您的 **AI Agents**（AI 代理）——卡片上会列出具体归属。使用顶部的 **Show**（显示）过滤器可以查看所有内容，或仅查看某个代理的媒体。

> 在仍使用经典 **Campaigns**（营销活动）的旧账户上，同一页面的工作方式相同——项目归属于营销活动而非代理，过滤器中列出的也是营销活动。


---

## 机器人如何决定发送什么

这是最关键的部分。对于您上传的每一项内容，您都需要编写一段简短的说明，描述**机器人应该在何时发送它**。机器人会读取这些说明，并且仅在您描述的情况真正出现时才会发送该项目。

例如：

| 项目 | “机器人应该何时发送此内容？” |
|------|----------------------------------|
| 蓝色连衣裙照片 | 当客户要求查看蓝色版本或询问其外观时 |
| 晚餐菜单（图片） | 当有人询问你们提供什么食物或要求查看菜单时 |
| 设置演练（视频） | 当客户询问如何安装或如何开始时 |

你的指令越清晰，机器人的时机把握就越准确。像“在相关时发送”这样模糊的指令，远不如“当客户询问高级套餐的价格时发送”那样能为机器人提供更多参考信息。

---

## 机器人如何识别每个文件的内容

当你上传文件时，平台会自动分析并编写一段关于其内容的简短描述——它会“查看”你的图片或视频，或转录你的音频。机器人会将此描述**与**你的“何时发送”指令结合使用，从而既能理解**文件是什么**，又能理解**何时使用它**——即使你自己的描述很简短。你会在列表中的每个项目上看到此 AI 摘要（显示为“AI 识别为：...”）。

你无需为此进行任何操作——它会在上传时自动完成。这意味着清晰的标题和指令，加上 AI 对文件的自主解读，能让机器人以最佳时机发送正确的内容。

---

## 跟进消息中的媒体内容

媒体内容最有效的应用场景之一是**跟进消息**——即当之前回复过的联系人有一段时间没有动静时，机器人自动发送的提醒。一段简短的语音留言、一个快速视频或一个“还在吗？”的动图，往往比单纯的文字更能有效地重新吸引对方。

要使用此功能，请编写一条描述跟进情况的“何时发送”指令，例如：

| 项目 | “机器人应该何时发送此内容？” |
|------|----------------------------------|
| 重新互动语音留言 | 当跟进一段时间没有动静的联系人时 |
| “还在吗？”GIF 动图 | 如果联系人在对话中途停止回复时 |

当那个时刻到来时，机器人会判断你的媒体项目是否适合此次跟进，如果适合，就会将其发送出去。

**跟进消息可以仅包含媒体内容。** 如果某个项目旨在独立呈现——比如一段已经说明了一切的语音留言——那么跟进消息可以**仅发送该媒体，无需文字**。请在**“机器人发送此内容时应该说什么？”**字段中注明，例如“仅发送语音留言，无需文字”。否则，机器人会在发送媒体的同时附带一条简短的文字提醒。

需要了解的几点事项：

- 这适用于**快速**跟进（早期提醒）和更长的**多日跟进周期**——支持 WhatsApp Web、Instagram、Messenger 和 Telegram。
- 在 **WhatsApp Business API** 上，媒体跟进消息只能在 24 小时窗口期内发送。在此之后，WhatsApp 仅允许发送预先批准的模板，因此后续的跟进消息只能是纯文本。
- 同样的**单次对话发送上限**也适用，因此除非你提高了该项目的限制，否则机器人不会在多次跟进中重复发送同一个文件。

---

## 如何添加媒体

1. 在主侧边栏中，点击 **AI Studio**。
2. 点击 **Media Library**（媒体库）。
3. 点击 **+ Add media**（添加媒体）按钮。


4. 选择该项目应归属于哪个（些）**代理**——一个项目可以附加到多个代理上。（在基于营销活动的旧账户中，此处选择的是营销活动。）
5. 点击从您的设备**选择文件**（图片、视频、GIF、音频或 PDF）。对于音频，您也可以切换到 **Record voice note**（录制语音备忘录），直接在应用内录制，无需上传。如果您添加音频，可以选择将其作为 **voice note**（语音备忘录气泡）还是常规的 **audio file**（音频文件）发送。
6. 输入一个简短的 **Title**（标题），以便日后识别该项目（例如“蓝色连衣裙照片”）。
7. 在 **When should the bot send this?**（机器人何时发送此内容？）字段中，用通俗语言描述发送场景。


8. 点击 **Save**（保存）。该项目将出现在您的媒体列表中，并立即对您附加它的每个代理（或营销活动）上的机器人可用。

您也可以从[智能体](../ai-agents/ai-agents.md)自己的**媒体**选项卡中添加媒体——这会打开相同的底层库，只是预先筛选为该智能体专用。该选项卡从智能体创建的那一刻起即可使用，包括您刚刚创建或从其他智能体复制的智能体，并且您上传到那里的文件会立即归该智能体所有。在旧版账户中，仍然直接保留其自身 AI 设置的营销活动，其编辑器中也内置了相同的**媒体**步骤：


**已经上传了文件并想在另一个代理上重复使用？** 无需再次上传，只需打开该项目并点击 **Assign**（分配），然后选择额外的代理即可。文件本身不会被复制——您只是将另一个代理添加到了同一个媒体项目中。

### 填写内容

| 字段 | 填写内容 |
|-------|--------------|
| **文件** | 您希望机器人能够发送的图片、视频、GIF、音频/语音留言或 PDF |
| **标题** | 供您参考的简短标签（联系人永远看不到） |
| **机器人应该何时发送此内容？** | 对触发此项目的场景进行清晰描述 |
| **每次对话最多发送次数** | 机器人可以向同一联系人发送此文件的次数。默认为 **1**，因此机器人不会向同一个人重复发送同一文件。如果文件需要多次发送，请增加此数值。 |
| **发送此内容时机器人应该说什么？** | 可选。机器人发送此项目时的建议消息。机器人将其作为**指导**，并在语境中自然地表达（不会机械地朗读）。留空则由机器人自行决定。如果您希望使用确切的措辞，请写下类似“请说：让我为您发送一段简短的语音留言。”的内容。 |

### 这些字段是给机器人的备注，而不是发给联系人的消息

**标题**、**机器人应该何时发送此内容？**以及**发送此内容时机器人应该说什么？**字段由您使用您习惯的语言编写。您的联系人永远看不到这些内容。

机器人总是使用**联系人所使用的**语言与每位联系人交流。因此，如果您用中文编写备注，而一位讲英语的联系人询问场地情况，机器人会根据您的备注发送带有英文说明的照片。请使用对您来说最方便的语言编写备注。

### 支持的文件和限制

- **图片：** JPG, PNG, GIF, WebP
- **视频：** MP4, MOV, WebM
- **音频：** MP3, OGG, WAV, M4A（可作为语音备忘录或普通音频文件发送）
- **文档：** PDF
- **最大大小：** 每个文件 10 MB
- **每个代理（或营销活动）：** 最多 50 个项目

当您上传 PDF 时，平台会读取其中的文本，以便机器人了解其内容——这与针对图片和音频的自动分析功能相同。

---

## 编辑和删除媒体

- 要更改项目的**标题**或其**发送时机**说明，请点击该项目并编辑字段，然后保存。（编辑说明不需要重新上传文件。）
- 要**删除**项目，请点击其上的删除（垃圾桶）图标。文件及其说明将被移除，机器人将停止发送该内容。
- 要替换**文件本身**，请删除该项目并添加一个新项目。

---

## 哪些渠道可以接收媒体

大多数渠道都可以接收媒体，但并非全部：

| 渠道 | 媒体支持 |
|---------|--------------|
| WhatsApp (Business & Web) | 图片、视频、GIF、语音留言、音频、PDF 文档 |
| Facebook Messenger | 图片、视频、语音留言、音频、PDF 文档 |
| Instagram | 图片、视频、语音留言 |
| Telegram | 图片、视频、音频（作为文件，而非语音留言）、PDF 文档 |
| LINE | 仅限图片 |
| SMS | 不支持（仅限文本） |

有几点需要注意：

- **短信无法接收媒体。** 在短信对话中，机器人将不会提供媒体项目。
- **Instagram 无法接收文档。** 在 Instagram 对话中，机器人不会发送 PDF——它会改为以文本形式回复。
- **GIF** 在上传时会自动优化，以便在 WhatsApp 上播放动画。在某些其他渠道上，GIF 可能会显示为静态图片。
- **WhatsApp 的 24 小时窗口也适用于媒体。** 如果距离联系人上次给您发送消息已过去太久，WhatsApp 可能会阻止任何消息（包括媒体），直到对方再次回复。

---

## 获得最佳效果的提示

1. **像向新团队成员介绍工作一样编写“何时发送”的说明。** 描述确切的时机——例如“当客户要求查看公寓照片时”——而不仅仅是主题。
2. **每个项目仅限一个用途。** 针对不同情况上传单独的项目，而不是试图用一个文件涵盖所有内容。
3. **保持文件小巧，加载迅速。** 与巨大的文件相比，压缩后的图片或短视频在聊天中传输速度更快，显示效果也更好。
4. **使用清晰、易于识别的标题。** 当您的库内容增加时，好的标题可以让您轻松查找并更新正确的项目。
5. **在“试用”(Try Out) 中进行测试。** 添加媒体后，请使用智能体的“试用”选项卡，在上线前检查机器人是否在正确的时间选择了正确的项目。图片、视频、音频或文档会直接显示在测试聊天中，位置与联系人实际接收到的位置完全一致。

> **较旧的测试对话可能会显示“媒体预览已过期”。** 测试聊天是一个沙盒环境——没有任何真实消息会离开您的账户——其媒体预览仅保留 7 天。如果您稍后返回查看旧的测试对话，过期的预览会显示一条小提示；只需再次询问机器人即可重新查看。真实对话不受影响：联系人会收到实际的文件，该文件不会过期。

> **机器人不会重复发送同一个文件。** 默认情况下，每个项目在每次对话中最多发送一次。如果客户反复询问同一件事，机器人会以文本形式回答，而不是再次发送同一张图片。如果您确实希望该项目可以重复发送，请提高该项目的“每次对话发送的最大次数”值。

---

## 自行发送媒体

媒体库用于**机器人的自动**发送。您可以随时从[聊天界面](../chats/chat-interface.md)手动向联系人发送任何图像、视频或文件——这不需要设置库项目。

---

## 后续步骤

- [AI 智能体](../ai-agents/ai-agents.md) — 每个智能体编辑器内的“媒体”选项卡。
- [AI 智能体](../ai-agents/ai-agents.md) — AI Studio 组的主页面，与知识库和自定义函数并列。
- [自动跟进](follow-ups.md) — 关于媒体可附加的跟进序列的完整指南。