
# Thư viện phương tiện

Thư viện phương tiện (Media Library) cho phép bot AI của bạn **gửi hình ảnh, video, tệp GIF, tin nhắn thoại và tài liệu PDF** cho liên hệ trong khi trò chuyện. Bạn chỉ cần tải tệp lên một lần, thiết lập thời điểm bot gửi từng tệp, và bot sẽ chọn đúng tệp vào đúng thời điểm - ví dụ: gửi ảnh sản phẩm khi có người hỏi "tôi có thể xem nó không?", gửi tài liệu quảng cáo PDF khi có người hỏi bảng giá đầy đủ, hoặc gửi một tin nhắn thoại ngắn hướng dẫn khách hàng về thực đơn của bạn.

**Hãy coi đây là một kệ chứa các tệp sẵn sàng để gửi cho bot của bạn.** Bạn quyết định những gì có trên kệ và khi nào mỗi mục được sử dụng.


> Thư viện phương tiện (Media Library) được cung cấp mặc định cho mọi tài khoản.

---

## Tại sao nên sử dụng Thư viện phương tiện

Các câu trả lời chỉ bằng văn bản có giới hạn nhất định. Một bức ảnh, video ngắn hoặc ghi chú thoại thường trả lời câu hỏi nhanh hơn và thuyết phục hơn một đoạn văn bản.

**Những gì thư viện phương tiện cho phép bot của bạn thực hiện:**

- Gửi **ảnh sản phẩm** khi liên hệ yêu cầu xem một món hàng
- Chia sẻ **thực đơn, bảng giá hoặc ảnh chụp sản phẩm** dưới dạng hình ảnh
- Gửi **video demo hoặc video hướng dẫn ngắn**
- Trả lời bằng **tệp GIF** khi phù hợp với ngữ cảnh cuộc trò chuyện
- Gửi **tin nhắn thoại hoặc đoạn âm thanh** để tạo cảm giác cá nhân, gần gũi
- Gửi **tài liệu PDF** - như tờ rơi, bảng giá, danh mục hoặc tài liệu điều khoản

Bot chỉ gửi các tệp **bạn** đã tải lên và phê duyệt - nó không bao giờ tự lấy hình ảnh từ internet hoặc tự tạo ra chúng.

---

## Tìm ở đâu

Trong thanh bên chính, dưới mục **AI Studio**, hãy nhấp vào **Media Library** (Thư viện phương tiện). Trang này hiển thị mọi tệp mà bot có thể gửi trong một **chế độ xem toàn tài khoản**, được nhóm lại để một tệp được sử dụng ở nhiều nơi sẽ xuất hiện dưới dạng một thẻ duy nhất. Mỗi mục thuộc về một hoặc nhiều **AI Agents** (Tác nhân AI) của bạn — thẻ sẽ liệt kê các tác nhân đó. Sử dụng bộ lọc **Show** (Hiển thị) ở trên cùng để xem tất cả mọi thứ hoặc chỉ phương tiện của một tác nhân duy nhất.

> Trên các tài khoản cũ vẫn sử dụng **Campaigns** (Chiến dịch) cổ điển, trang này hoạt động giống hệt nhau — các mục thuộc về các chiến dịch thay vì tác nhân, và bộ lọc sẽ liệt kê các chiến dịch.


---

## Cách bot quyết định những gì cần gửi

Đây là phần quan trọng nhất cần thực hiện đúng. Đối với mỗi mục bạn tải lên, bạn viết một hướng dẫn ngắn mô tả **khi nào bot nên gửi mục đó**. Bot đọc các hướng dẫn này và chỉ gửi mục đó khi tình huống bạn mô tả thực sự xảy ra.

Ví dụ:

| Mục | "Khi nào bot nên gửi tệp này?" |
|------|----------------------------------|
| Ảnh chiếc váy màu xanh | Khi khách hàng hỏi muốn xem phiên bản màu xanh hoặc trông nó như thế nào |
| Thực đơn bữa tối (hình ảnh) | Khi ai đó hỏi bạn phục vụ món gì hoặc muốn xem thực đơn |
| Video hướng dẫn thiết lập | Khi khách hàng hỏi cách cài đặt hoặc bắt đầu như thế nào |

Hướng dẫn của bạn càng rõ ràng, thời điểm gửi của bot càng chính xác. Các hướng dẫn mơ hồ như "gửi khi phù hợp" sẽ khiến bot khó xử lý hơn so với "gửi khi khách hàng hỏi về giá cho gói cao cấp."

---

## Cách Bot nhận biết nội dung trong mỗi tệp

Khi bạn tải tệp lên, nền tảng sẽ tự động phân tích và viết một mô tả ngắn về nội dung của tệp đó - nó "nhìn" vào hình ảnh hoặc video của bạn, hoặc chuyển đổi âm thanh của bạn thành văn bản. Bot sử dụng thông tin này **kết hợp với** hướng dẫn "khi nào cần gửi" của bạn, vì vậy nó hiểu cả **tệp đó là gì** và **khi nào nên sử dụng nó** - ngay cả khi mô tả của bạn rất ngắn gọn. Bạn sẽ thấy bản tóm tắt AI này trên mỗi mục trong danh sách (hiển thị là "AI thấy: ...").

Bạn không cần phải làm gì cả - việc này diễn ra ngay khi tải lên. Điều này chỉ có nghĩa là một tiêu đề và hướng dẫn rõ ràng, cộng với cách AI đọc tệp, sẽ giúp bot có cơ hội tốt nhất để gửi đúng nội dung vào đúng thời điểm.

---

## Phương tiện trong phần Theo dõi (Follow-Up)

Một trong những nơi hữu ích nhất để sử dụng phương tiện là trong phần **theo dõi** - lời nhắc tự động mà bot gửi khi một liên hệ đã phản hồi trước đó bỗng im lặng một thời gian. Một đoạn ghi âm ngắn, một video nhanh hoặc một clip "bạn còn đó không?" thường giúp kết nối lại với người dùng hiệu quả hơn nhiều so với một dòng văn bản khác.

Để sử dụng tính năng này, hãy viết hướng dẫn "khi nào nên gửi" mô tả tình huống theo dõi, ví dụ:

| Mục | "Khi nào bot nên gửi nội dung này?" |
|------|----------------------------------|
| Ghi âm kết nối lại | Khi theo dõi một người đã im lặng một thời gian |
| GIF "Bạn còn đó không?" | Nếu liên hệ ngừng phản hồi giữa chừng cuộc trò chuyện |

Khi thời điểm đó đến, bot sẽ quyết định xem một trong các mục phương tiện của bạn có phù hợp với phần theo dõi hay không và nếu có, nó sẽ gửi đi.

**Các phần theo dõi có thể chỉ chứa phương tiện.** Nếu một mục được thiết kế để đứng độc lập - ví dụ như một đoạn ghi âm đã truyền tải đầy đủ nội dung - thì phần theo dõi có thể **chỉ bao gồm phương tiện đó mà không cần văn bản**. Hãy chỉ định điều này trong trường **"Bot nên nói gì khi gửi nội dung này?"**, ví dụ: "chỉ gửi đoạn ghi âm, không cần văn bản". Nếu không, bot sẽ gửi kèm một đoạn văn bản nhắc nhở ngắn cùng với phương tiện.

Một vài điều cần lưu ý:

- Tính năng này hoạt động cho cả các phần theo dõi **nhanh** (lời nhắc sớm) và các **chu kỳ theo dõi kéo dài nhiều ngày** - trên WhatsApp Web, Instagram, Messenger và Telegram.
- Trên **WhatsApp Business API**, các phần theo dõi bằng phương tiện chỉ có thể được gửi khi cửa sổ 24 giờ vẫn còn hiệu lực. Sau thời gian đó, WhatsApp chỉ cho phép các mẫu đã được phê duyệt trước, vì vậy các phần theo dõi sau đó chỉ có thể ở dạng văn bản.
- **Giới hạn gửi mỗi cuộc trò chuyện** vẫn được áp dụng, vì vậy bot sẽ không lặp lại cùng một tệp trong các phần theo dõi trừ khi bạn tăng giới hạn cho mục đó.

---

## Cách thêm phương tiện

1. Trong thanh bên chính, nhấp vào **AI Studio**.
2. Nhấp vào **Media Library**.
3. Nhấp vào nút **+ Add media**.


4. Chọn (các) **tác nhân** mà mục đó sẽ thuộc về — một mục có thể được đính kèm vào nhiều tác nhân. (Trên các tài khoản dựa trên chiến dịch cũ, bạn chọn chiến dịch tại đây thay thế.)
5. Nhấp để **chọn một tệp** (hình ảnh, video, GIF, âm thanh hoặc PDF) từ thiết bị của bạn. Đối với âm thanh, bạn cũng có thể chuyển sang **Record voice note** (Ghi âm tin nhắn thoại) và ghi âm trực tiếp trong ứng dụng thay vì tải lên. Nếu bạn thêm âm thanh, bạn có thể chọn gửi dưới dạng **voice note** (tin nhắn thoại - bong bóng thoại đã ghi âm) hoặc **audio file** (tệp âm thanh) thông thường.
6. Nhập một **Title** (Tiêu đề) ngắn gọn để bạn có thể nhận diện mục đó sau này (ví dụ: "Ảnh váy xanh").
7. Trong trường **When should the bot send this?** (Khi nào bot nên gửi tệp này?), hãy mô tả tình huống bằng ngôn ngữ đơn giản.


8. Nhấp vào **Save** (Lưu). Mục đó sẽ xuất hiện trong danh sách phương tiện của bạn và khả dụng ngay lập tức cho bot trên mọi tác nhân (hoặc chiến dịch) mà bạn đã đính kèm.

Bạn cũng có thể thêm phương tiện từ tab **Phương tiện** (Media) của chính [Tác nhân](../ai-agents/ai-agents.md) — tab này mở ra cùng một thư viện cơ bản, chỉ là đã được lọc sẵn cho tác nhân đó. Tab này hoạt động ngay từ thời điểm tác nhân tồn tại, bao gồm cả tác nhân bạn vừa tạo cách đây một phút hoặc sao chép từ tác nhân khác, và tệp bạn tải lên đó sẽ thuộc về tác nhân đó ngay lập tức. Trên các tài khoản cũ hơn, một chiến dịch vẫn giữ các cài đặt AI riêng của mình trực tiếp có cùng bước **Phương tiện** (Media) được tích hợp ngay trong trình chỉnh sửa của chính nó:


**Đã tải lên một tệp và muốn sử dụng lại trên một tác nhân khác?** Thay vì tải lên lại, hãy mở mục đó và nhấp vào **Assign** (Gán), sau đó chọn (các) tác nhân bổ sung. Bản thân tệp không bị sao chép — bạn chỉ đang thêm một tác nhân khác vào cùng một mục phương tiện.

### Những thông tin cần điền

| Trường | Nội dung cần viết |
|-------|--------------|
| **Tệp** | Hình ảnh, video, GIF, tệp âm thanh/ghi chú thoại hoặc PDF mà bạn muốn bot có thể gửi |
| **Tiêu đề** | Một nhãn ngắn gọn để bạn tham khảo (người liên hệ sẽ không bao giờ thấy nội dung này) |
| **Khi nào bot nên gửi tệp này?** | Mô tả rõ ràng về tình huống sẽ kích hoạt mục này |
| **Số lần gửi tối đa mỗi cuộc trò chuyện** | Số lần bot có thể gửi tệp này cho cùng một người liên hệ. Mặc định là **1**, vì vậy bot sẽ không gửi lặp lại cùng một tệp cho mọi người. Hãy tăng số này nếu tệp cần được gửi lại. |
| **Bot nên nói gì khi gửi tệp này?** | Tùy chọn. Một tin nhắn gợi ý khi bot gửi mục này. Bot sẽ sử dụng nó làm **hướng dẫn** và diễn đạt một cách tự nhiên trong ngữ cảnh (bot sẽ không đọc một cách máy móc). Để trống nếu muốn để bot tự quyết định. Nếu bạn muốn dùng chính xác các từ ngữ đó, hãy viết nội dung như "say exactly: Let me send you a quick voice note." |

### Các trường này là ghi chú cho bot, không phải tin nhắn gửi cho liên hệ của bạn

Các trường **Tiêu đề**, **Khi nào bot nên gửi tin nhắn này?** và **Bot nên nói gì khi gửi tin nhắn này?** là nơi bạn có thể viết bằng bất kỳ ngôn ngữ nào bạn muốn. Liên hệ của bạn sẽ không bao giờ nhìn thấy chúng.

Bot luôn viết cho mỗi liên hệ bằng ngôn ngữ **của chính liên hệ đó**. Vì vậy, nếu bạn viết ghi chú bằng tiếng Trung và một liên hệ nói tiếng Anh yêu cầu xem địa điểm, bot sẽ gửi ảnh kèm chú thích bằng tiếng Anh dựa trên ghi chú của bạn. Hãy viết ghi chú bằng ngôn ngữ thuận tiện nhất cho bạn.

### Các tệp được hỗ trợ và giới hạn

- **Hình ảnh:** JPG, PNG, GIF, WebP
- **Video:** MP4, MOV, WebM
- **Âm thanh:** MP3, OGG, WAV, M4A (gửi dưới dạng tin nhắn thoại hoặc tệp âm thanh thông thường)
- **Tài liệu:** PDF
- **Kích thước tối đa:** 10 MB mỗi tệp
- **Mỗi tác nhân (hoặc chiến dịch):** tối đa 50 mục

Khi bạn tải lên một tệp PDF, nền tảng sẽ đọc văn bản bên trong để bot biết nội dung của tệp đó - tương tự như quá trình phân tích tự động đối với hình ảnh và âm thanh.

---

## Chỉnh sửa và Xóa phương tiện

- Để thay đổi **tiêu đề** của một mục hoặc hướng dẫn **khi nào cần gửi**, hãy nhấp vào mục đó, chỉnh sửa các trường rồi lưu lại. (Việc chỉnh sửa hướng dẫn không yêu cầu phải tải lại tệp.)
- Để **xóa** một mục, hãy nhấp vào biểu tượng xóa (thùng rác) trên mục đó. Tệp và hướng dẫn của nó sẽ bị xóa và bot sẽ ngừng gửi tệp này.
- Để thay thế **chính tệp đó**, hãy xóa mục cũ và thêm mục mới.

---

## Những kênh nào có thể nhận phương tiện

Hầu hết các kênh đều có thể nhận phương tiện, nhưng không phải tất cả:

| Kênh | Hỗ trợ phương tiện |
|---------|--------------|
| WhatsApp (Business & Web) | Hình ảnh, video, GIF, tin nhắn thoại, âm thanh, tài liệu PDF |
| Facebook Messenger | Hình ảnh, video, tin nhắn thoại, âm thanh, tài liệu PDF |
| Instagram | Hình ảnh, video, tin nhắn thoại |
| Telegram | Hình ảnh, video, âm thanh (dưới dạng tệp, không phải tin nhắn thoại), tài liệu PDF |
| LINE | Chỉ hình ảnh |
| SMS | Không hỗ trợ (chỉ văn bản) |

Một vài điều cần lưu ý:

- **SMS không thể nhận phương tiện.** Trong các cuộc trò chuyện SMS, bot đơn giản sẽ không cung cấp các mục phương tiện.
- **Instagram không thể nhận tài liệu.** Trong cuộc trò chuyện trên Instagram, bot sẽ không gửi tệp PDF - thay vào đó, nó sẽ trả lời bằng văn bản.
- **GIF** được tự động tối ưu hóa khi bạn tải lên để chúng có thể hiển thị hoạt ảnh trên WhatsApp. Trên một số kênh khác, GIF có thể hiển thị dưới dạng hình ảnh tĩnh.
- **Cửa sổ 24 giờ của WhatsApp cũng áp dụng cho phương tiện.** Nếu đã quá lâu kể từ lần cuối liên hệ nhắn tin cho bạn, WhatsApp có thể chặn mọi tin nhắn - bao gồm cả phương tiện - cho đến khi họ trả lời lại.

---

## Mẹo để có kết quả tốt nhất

1. **Viết hướng dẫn "khi nào cần gửi" như thể bạn đang hướng dẫn một thành viên mới trong nhóm.** Hãy mô tả thời điểm chính xác - "khi khách hàng yêu cầu xem ảnh căn hộ" - thay vì chỉ nêu chủ đề.
2. **Mỗi mục một mục đích.** Hãy tải lên các mục riêng biệt cho các tình huống riêng biệt thay vì một tệp duy nhất mà bạn hy vọng sẽ bao quát được mọi thứ.
3. **Giữ cho các tệp nhỏ và tải nhanh.** Một hình ảnh được nén hoặc một đoạn clip ngắn sẽ đến nhanh hơn và hiển thị đẹp hơn trong cuộc trò chuyện so với một tệp khổng lồ.
4. **Sử dụng tiêu đề rõ ràng, dễ nhận biết.** Khi thư viện của bạn phát triển, các tiêu đề tốt sẽ giúp bạn dễ dàng tìm kiếm và cập nhật đúng mục cần thiết.
5. **Kiểm tra trong phần Thử nghiệm (Try Out).** Sau khi thêm phương tiện, hãy sử dụng tab Thử nghiệm của Tác nhân để kiểm tra xem bot có chọn đúng mục vào đúng thời điểm hay không trước khi đưa vào hoạt động thực tế. Hình ảnh, video, âm thanh hoặc tài liệu sẽ hiển thị ngay trong cuộc trò chuyện thử nghiệm, chính xác tại nơi mà người liên hệ sẽ nhận được.

> **Các cuộc trò chuyện thử nghiệm cũ hơn có thể hiển thị "Bản xem trước phương tiện đã hết hạn".** Cuộc trò chuyện thử nghiệm là một môi trường thử nghiệm - không có tin nhắn thực nào rời khỏi tài khoản của bạn - và các bản xem trước phương tiện của nó chỉ có thể xem được trong 7 ngày. Nếu bạn quay lại một cuộc trò chuyện thử nghiệm cũ sau đó, bản xem trước đã hết hạn sẽ hiển thị một ghi chú nhỏ thay thế; chỉ cần yêu cầu bot gửi lại để xem bản mới. Các cuộc trò chuyện thực tế không bị ảnh hưởng: người liên hệ sẽ nhận được tệp thực, tệp này không bao giờ hết hạn.

> **Bot sẽ không spam cùng một tệp.** Theo mặc định, mỗi mục được gửi tối đa một lần cho mỗi cuộc hội thoại. Nếu khách hàng liên tục hỏi về cùng một vấn đề, bot sẽ trả lời bằng văn bản thay vì gửi lại cùng một hình ảnh. Hãy tăng giá trị "Số lần gửi tối đa mỗi cuộc hội thoại" trên một mục nếu bạn thực sự muốn nó có thể được gửi lại.

---

## Tự gửi phương tiện

Thư viện phương tiện dành cho các nội dung gửi **tự động của bot**. Bạn luôn có thể gửi bất kỳ hình ảnh, video hoặc tệp nào cho liên hệ theo cách thủ công từ [Giao diện trò chuyện](../chats/chat-interface.md) bất cứ lúc nào - điều đó không yêu cầu phải thiết lập mục thư viện.

---

## Các bước tiếp theo

- [AI Agents](../ai-agents/ai-agents.md) — tab Phương tiện bên trong trình chỉnh sửa của mỗi Tác nhân.
- [AI Agents](../ai-agents/ai-agents.md) — trang chính của nhóm AI Studio, cùng với Cơ sở kiến thức và Hàm tùy chỉnh.
- [Automated Follow-Ups](follow-ups.md) — hướng dẫn đầy đủ về các chuỗi theo dõi mà phương tiện có thể đính kèm.