> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Đồng bộ danh mục sản phẩm với Meta Catalog

> Hướng dẫn đồng bộ sản phẩm hai chiều giữa ChatbotX Ecommerce và Meta Commerce Manager để bán hàng trên Facebook Messenger, Instagram và WhatsApp.

Tính năng **Sync Meta Catalog** cho phép bạn đồng bộ dữ liệu hàng hóa hai chiều giữa cửa hàng ChatbotX Ecommerce và **Meta Commerce Manager**. Sau khi đồng bộ, bạn có thể hiển thị danh mục sản phẩm trực tiếp trên giao diện mua sắm gốc của Facebook Messenger, Instagram và WhatsApp, cũng như gửi thẻ sản phẩm từ Catalog trong kịch bản tự động.

> [card] Đẩy sản phẩm lên Meta
>
> Đồng bộ nhanh các sản phẩm từ ChatbotX lên Meta Catalog để kích hoạt tính năng mua sắm trên Messenger và WhatsApp.

> [card] Nhập sản phẩm từ Meta
>
> Kéo toàn bộ danh mục hàng hóa có sẵn trên Meta Commerce Manager về cửa hàng ChatbotX chỉ với mã Catalog ID.

> [card] Tự động đối chiếu theo SKU
>
> Sử dụng mã SKU và định danh sản phẩm để cập nhật thông tin giá bán, hình ảnh và tồn kho chính xác giữa hai nền tảng.

> [card] Theo dõi lịch sử đồng bộ
>
> Kiểm tra chi tiết trạng thái từng phiên đẩy hoặc nhập dữ liệu, số lượng sản phẩm thành công và nguyên nhân lỗi nếu có.

## Mở hộp thoại Sync Meta Catalog

**1. Truy cập danh sách sản phẩm**

Từ menu bên trái của ChatbotX, chọn **Tools** > **Ecommerce** và mở tab **Products**.

**2. Mở công cụ đồng bộ**

Nhấn nút **Sync Meta Catalog** trên thanh công cụ phía trên bảng danh sách sản phẩm.

**3. Chọn chức năng cần thực hiện**

Hộp thoại **Sync Meta Catalog** bao gồm 4 tab quản lý:

* **Sync to Meta**: Đẩy các sản phẩm đã chọn từ ChatbotX lên danh mục Meta Catalog.
* **Sync from Meta**: Kéo danh sách sản phẩm từ một Meta Catalog có sẵn về cửa hàng ChatbotX.
* **History**: Xem nhật ký và kết quả của các lần đồng bộ trước đó.
* **Connection**: Quản lý tài khoản Meta Business và quyền kết nối danh mục.

## Đẩy sản phẩm từ ChatbotX lên Meta

Tab **Sync to Meta** giúp bạn xuất bản các mặt hàng đang có trên cửa hàng ChatbotX sang Meta Commerce Manager.

### Các bước thực hiện đẩy sản phẩm

**1. Chọn sản phẩm cần đồng bộ**

Tại bảng danh sách trong tab **Products**, tích chọn vào ô vuông ở đầu dòng của các sản phẩm bạn muốn đẩy lên Meta, sau đó nhấn nút **Sync Meta Catalog**.

**2. Khai báo Meta Catalog ID**

Trong tab **Sync to Meta**, nhập mã danh mục lấy từ Meta Commerce Manager vào ô **Meta Catalog ID**, hoặc nhấn **+ Create a new catalog** để khởi tạo một danh mục mới trực tiếp.

**3. Kiểm tra tiêu chuẩn sản phẩm và đồng bộ**

Đảm bảo các sản phẩm đã chọn đáp ứng đầy đủ tiêu chuẩn hiển thị của Meta, sau đó nhấn nút **Sync now** để bắt đầu tiến trình đẩy dữ liệu.

### Tiêu chuẩn bắt buộc đối với sản phẩm Messenger Shopping

Để sản phẩm được Meta phê duyệt và hiển thị đầy đủ trên giao diện mua sắm của Messenger và WhatsApp, dữ liệu mặt hàng cần tuân thủ các yêu cầu sau:

| Tiêu chí | Yêu cầu bắt buộc từ Meta |
| - | - |
| **Detailed description** | Mô tả sản phẩm phải chi tiết, cung cấp thêm thông tin ngoài tiêu đề như thông số kỹ thuật, chất liệu, công dụng và đặc điểm nổi bật. |
| **Product image** | Hình ảnh sản phẩm có độ phân giải tối thiểu `500px × 500px` và dung lượng tệp tối đa `8MB`. |
| **Product video** | Nếu đính kèm video minh họa sản phẩm, dung lượng tệp tối đa là `200MB`. |
| **Price** | Mọi sản phẩm đưa vào đồng bộ bắt buộc phải có giá bán hợp lệ. |
| **Số lượng tối thiểu** | Cần xuất bản ít nhất **6 sản phẩm** trong danh mục để giao diện mua sắm hiển thị đầy đủ lựa chọn cho người mua. |

> [!WARNING]
>
> Nếu bạn chưa tích chọn sản phẩm nào trong bảng **Products** trước khi mở hộp thoại, hệ thống sẽ hiển thị thông báo nhắc bạn chọn các sản phẩm muốn đẩy rồi mới chạy lệnh đồng bộ.

## Nhập sản phẩm từ Meta Catalog về ChatbotX

Nếu doanh nghiệp của bạn đã xây dựng sẵn danh mục hàng hóa trên Meta Commerce Manager, bạn có thể sử dụng tab **Sync from Meta** để kéo toàn bộ sản phẩm về cửa hàng ChatbotX mà không cần tạo lại thủ công.

**1. Chuyển sang tab Sync from Meta**

Trong hộp thoại **Sync Meta Catalog**, chọn tab **Sync from Meta**.

**2. Nhập mã Meta Catalog ID**

Điền mã định danh danh mục tìm thấy trong trình quản lý Meta Commerce Manager vào trường **Meta Catalog ID** (hoặc nhấn **+ Create a new catalog** nếu cần tạo mới).

**3. Thực thi nhập dữ liệu**

Nhấn nút **Import** để hệ thống tải thông tin sản phẩm, hình ảnh và giá bán từ Meta về danh sách sản phẩm của Workspace.

## Theo dõi lịch sử và quản lý kết nối

### Kiểm tra nhật ký tại tab History

Chuyển sang tab **History** trong hộp thoại **Sync Meta Catalog** để theo dõi tiến độ của các tác vụ đồng bộ chạy ngầm:

* Xem trạng thái xử lý của từng phiên đẩy hoặc nhập sản phẩm (đang chờ, đang xử lý, hoàn tất hoặc thất bại).
* Kiểm tra tổng số lượng sản phẩm thực hiện, số lượng đồng bộ thành công và số lượng bị từ chối.
* Xem chi tiết nguyên nhân lỗi đối với các dòng sản phẩm không đạt tiêu chuẩn của Meta để chỉnh sửa và đồng bộ lại.

### Quản lý tài khoản tại tab Connection

Tab **Connection** cho phép bạn kiểm tra trạng thái liên kết với tài khoản Meta Business, làm mới quyền truy cập danh mục hoặc thay đổi tài khoản kết nối khi cần chuyển đổi danh mục quản trị.

> [!NOTE]
>
> Sau khi sản phẩm đã được đồng bộ và liên kết thành công với Meta Catalog của kênh, bạn có thể sử dụng bước gửi sản phẩm trong trình xây dựng kịch bản để hiển thị trực tiếp các mặt hàng này trong cuộc trò chuyện WhatsApp và Messenger.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.